# Modrinth Minecraft Mods API
> Live mod-platform stats from Modrinth, the open Minecraft content platform — no key, nothing stored. The adoption-and-community view of the Minecraft modding ecosystem: how much each mod, modpack, shader or resource pack is downloaded and followed, and which projects are most popular, distinct from the other developer-ecosystem and gaming APIs in the catalogue. The project endpoint returns a single project in full — total downloads, followers, type, categories, supported game versions and loaders, client/server sides and license. The search endpoint searches projects, filterable by type (mod, modpack, shader, resource pack, data pack) and sortable by downloads or follows, each with its download and follower count. The versions endpoint returns a project's recent releases with per-version downloads, supported game versions and loaders. Build mod dashboards, popularity trackers, "is this mod maintained" widgets and modpack browsers on top of real Modrinth data. Look up a project by its slug (sodium, iris, fabric-api); downloads are the headline popularity metric.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/modrinth-api/..."
```

## Pricing
- **Free** (Free) — 26,000 calls/Mo, 3 req/s
- **Starter** ($4/Mo) — 340,000 calls/Mo, 10 req/s
- **Pro** ($14/Mo) — 1,450,000 calls/Mo, 25 req/s
- **Scale** ($32/Mo) — 5,200,000 calls/Mo, 55 req/s

## Endpoints

### Project

#### `GET /v1/project` — A project in full — downloads, followers, loaders

**Parameters:**
- `slug` (query, required, string) — Project slug Example: `sodium`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/modrinth-api/v1/project?slug=sodium"
```

### Search

#### `GET /v1/search` — Search projects

**Parameters:**
- `q` (query, required, string) — Search query Example: `shaders`
- `type` (query, optional, string) — mod, modpack, shader, resourcepack, datapack Example: `shader`
- `sort` (query, optional, string) — downloads, follows, newest, updated, relevance Example: `downloads`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/modrinth-api/v1/search?q=shaders&type=shader&sort=downloads"
```

### Versions

#### `GET /v1/versions` — A project recent releases

**Parameters:**
- `slug` (query, required, string) — Project slug Example: `sodium`
- `limit` (query, optional, string) — Max versions (default 15, max 50) Example: `15`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/modrinth-api/v1/versions?slug=sodium&limit=15"
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/modrinth-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/modrinth-api
OpenAPI spec: https://www.oanor.com/api/modrinth-api/openapi.json