API Reference

The Gorilla Mods public API lets you programmatically browse and download verified mods. All endpoints are unauthenticated and rate-limited to 60 requests per minute per IP.

Base URL

https://gorillamods.forum

GET/api/mods

Returns the full list of verified mods.

Query Parameters

Name	Type	Required	Description
`category`	`string`	No	Filter by category slug (e.g. cosmetics, gameplay).
`q`	`string`	No	Search query matched against name, author, and description.
`sort`	`string`	No	Sort order: newest (default), popular, or az.

Example Response

[
  {
    "id": "abc123",
    "name": "Gorilla Glass",
    "author": "modder99",
    "category": "cosmetics",
    "description": "Adds a glass shader to your gorilla.",
    "version": "1.2.0",
    "downloadUrl": "https://...",
    "thumbnailUrl": "https://...",
    "downloads": 4821,
    "createdAt": "2024-11-10T12:00:00.000Z",
    "tags": ["shader", "skin"],
    "verified": true
  }
]

GET/api/stats

Returns aggregate statistics for the mod workshop.

Example Response

{
  "totalMods": 42,
  "totalDownloads": 198302,
  "categories": ["cosmetics", "gameplay", "maps", "tools"]
}

POST/api/mods/download

Increments the download counter for a mod and returns its signed download URL.

Request Body (JSON)

Name	Type	Required	Description
`id`	`string`	Yes	The unique ID of the mod to download.

Example Response

{
  "url": "https://public.blob.vercel-storage.com/gorilla-mods/files/gorilla-glass-1.2.0.zip"
}

All responses are JSON. Errors return a standard { "error": "message" } shape with the appropriate HTTP status code.