Modrinth API
Base: https://api.modrinth.com/v2
Modrinth modpack search using project_type:modpack facet.
Handler: ModrinthProvider
GET
/search
Search Modpacks
Search Modrinth for modpacks
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
query
|
string | No | Search keyword |
facets
|
string | No | e.g. [["project_type:modpack"]] |
limit
|
integer | No | Results (default 10) |
Response Example
{"hits":[{"slug":"simply-optimized","title":"Simply Optimized","project_type":"modpack","downloads":5000000}],"total_hits":100}cURL
curl "https://api.modrinth.com/v2/search?query=optimized&facets=[[\"project_type:modpack\"]]"
GET
/project/{id|slug}/version
List Modpack Versions
Get versions for a modpack
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
id|slug
|
string | Yes | Project ID or slug |
game_versions
|
string | No | e.g. ["1.20.1"] |
Response Example
[{"id":"ver123","version_number":"1.5.0","game_versions":["1.20.1"],"files":[{"url":"https://cdn.modrinth.com/...","filename":"pack-1.5.0.mrpack"}]}]cURL
curl "https://api.modrinth.com/v2/project/simply-optimized/version"