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"