Modrinth API
Base: https://api.modrinth.com/v2
Modrinth plugin search with server-side facets (paper, spigot, bukkit).
Handler: ModrinthProvider
GET
/search
Search Plugins
Search Modrinth for server-side plugins
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
query
|
string | No | Search keyword |
facets
|
string | No | e.g. [["project_type:plugin"],["categories:paper"]] |
limit
|
integer | No | Results per page |
Response Example
{"hits":[{"slug":"luckperms","title":"LuckPerms","project_type":"plugin","downloads":10000000}],"total_hits":50}cURL
curl "https://api.modrinth.com/v2/search?query=luckperms&facets=[[\"project_type:plugin\"],[\"categories:paper\"]]"
GET
/project/{id|slug}/version
List Plugin Versions
Get versions filtered by server platform
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
id|slug
|
string | Yes | Project ID or slug |
loaders
|
string | No | e.g. ["paper","spigot"] |
game_versions
|
string | No | e.g. ["1.20.4"] |
Response Example
[{"id":"ver456","version_number":"5.4.102","loaders":["bukkit","spigot","paper"],"files":[{"url":"https://cdn.modrinth.com/..."}],"dependencies":[]}]cURL
curl "https://api.modrinth.com/v2/project/luckperms/version?loaders=[\"paper\"]"