CurseForge API

Base: https://api.curseforge.com/v1

CurseForge Mods API — Suche, Details, Dateien und Beschreibungen via classId 9137.

Verarbeitung: CurseForgeProvider

Endpunkte

GET /mods/search Search Mods GET /mods/{modId} Get Mod Details GET /mods/{modId}/files Get Mod Files GET /mods/{modId}/description Get Mod Description

GET /mods/search

Search Mods

Search CurseForge mods by keyword

Parameter

Name	Typ	Pflicht	Beschreibung
`x-api-key`	string	Ja	Your CurseForge API key
`gameId`	integer	Ja	Game ID (432=Minecraft, 70216=Hytale)
`classId`	integer	Nein	Class ID (9137=Mods)
`searchFilter`	string	Nein	Search keyword
`sortField`	integer	Nein	1=Featured 2=Popularity 3=LastUpdated 6=TotalDownloads
`sortOrder`	string	Nein	asc or desc
`pageSize`	integer	Nein	Results per page (max 50)
`index`	integer	Nein	Pagination offset (0-based)
`gameVersion`	string	Nein	MC version filter e.g. 1.20.1
`modLoaderType`	integer	Nein	1=Forge 4=Fabric 5=Quilt 6=NeoForge

Antwort-Beispiel

{"data":[{"id":238222,"gameId":432,"name":"Just Enough Items (JEI)","slug":"jei","links":{"websiteUrl":"https://www.curseforge.com/minecraft/mc-mods/jei"},"summary":"View Items and Recipes","downloadCount":195000000,"categories":[{"id":421}],"classId":9137,"authors":[{"name":"mezz"}]}],"pagination":{"index":0,"pageSize":20,"resultCount":1,"totalCount":1}}

cURL

curl -H "x-api-key: YOUR_KEY" "https://api.curseforge.com/v1/mods/search?gameId=432&classId=9137&searchFilter=jei&pageSize=5"

GET /mods/{modId}

Get Mod Details

Fetch full details for a single mod

Parameter

Name	Typ	Pflicht	Beschreibung
`x-api-key`	string	Ja	Your CurseForge API key
`modId`	integer	Ja	CurseForge mod ID

Antwort-Beispiel

{"data":{"id":238222,"name":"Just Enough Items (JEI)","slug":"jei","summary":"View Items and Recipes","downloadCount":195000000,"mainFileId":5000000,"latestFilesIndexes":[{"gameVersion":"1.20.1","fileId":5000000}]}}

cURL

curl -H "x-api-key: YOUR_KEY" "https://api.curseforge.com/v1/mods/238222"

GET /mods/{modId}/files

Get Mod Files

List all available file versions for a mod

Parameter

Name	Typ	Pflicht	Beschreibung
`x-api-key`	string	Ja	Your CurseForge API key
`modId`	integer	Ja	CurseForge mod ID
`gameVersion`	string	Nein	Filter by MC version
`modLoaderType`	integer	Nein	1=Forge 4=Fabric
`pageSize`	integer	Nein	Results per page

Antwort-Beispiel

{"data":[{"id":5000000,"displayName":"jei-1.20.1-15.2.0.27.jar","fileName":"jei-1.20.1-15.2.0.27.jar","releaseType":1,"downloadUrl":"https://edge.forgecdn.net/files/...","gameVersions":["1.20.1","Forge"],"dependencies":[]}]}

cURL

curl -H "x-api-key: YOUR_KEY" "https://api.curseforge.com/v1/mods/238222/files?gameVersion=1.20.1"

GET /mods/{modId}/description

Get Mod Description

Fetch full HTML description

Parameter

Name	Typ	Pflicht	Beschreibung
`x-api-key`	string	Ja	Your CurseForge API key
`modId`	integer	Ja	CurseForge mod ID

Antwort-Beispiel

{"data":"<h2>Just Enough Items</h2><p>JEI is an item and recipe viewing mod...</p>"}

cURL

curl -H "x-api-key: YOUR_KEY" "https://api.curseforge.com/v1/mods/238222/description"