CurseForge API
Base: https://api.curseforge.com/v1
CurseForge Bukkit Plugins API (classId=5) — search, file listing, and download.
Handler: CurseForgeProvider
GET
/mods/search
Search Plugins
Search CurseForge Bukkit plugins (classId=5)
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
x-api-key
|
string | Yes | Your CurseForge API key |
gameId
|
integer | Yes | Game ID (432=Minecraft) |
classId
|
integer | No | Class ID (5=Bukkit Plugins) |
searchFilter
|
string | No | Search keyword |
pageSize
|
integer | No | Results per page (max 50) |
Response Example
{"data":[{"id":32274,"name":"WorldEdit","slug":"worldedit","summary":"In-game map editor","downloadCount":50000000,"classId":5}],"pagination":{"totalCount":200}}cURL
curl -H "x-api-key: YOUR_KEY" "https://api.curseforge.com/v1/mods/search?gameId=432&classId=5&searchFilter=worldedit"
GET
/mods/{modId}/files
Get Plugin Files
List available versions for a Bukkit plugin
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
x-api-key
|
string | Yes | Your CurseForge API key |
modId
|
integer | Yes | CurseForge plugin ID |
gameVersion
|
string | No | Filter by MC version |
Response Example
{"data":[{"id":4000000,"fileName":"worldedit-bukkit-7.2.15.jar","downloadUrl":"https://edge.forgecdn.net/...","dependencies":[{"modId":100,"relationType":3}]}]}cURL
curl -H "x-api-key: YOUR_KEY" "https://api.curseforge.com/v1/mods/32274/files"