# MyAnimeList Community Stats API
> Live anime community stats from MyAnimeList, the world's largest anime and manga community, via the public Jikan feed — no key, nothing stored. The MAL community view: a title's MAL score, member counts, ranking and the full engagement breakdown of how the community is watching it, distinct from the other anime platforms in the catalogue — MyAnimeList has its own score, its own millions-strong community and its own rankings. The anime endpoint returns a title snapshot: the MAL score, how many users scored it, its rank and popularity rank, total members, favourites, airing status, episode count and year. The stats endpoint returns the community engagement breakdown — how many users are watching, completed, on-hold, dropped or plan-to-watch — plus the full 1–10 score distribution with vote counts and percentages, and computed completion and drop rates. The top endpoint returns the top-ranked anime, by score or filtered by airing, upcoming, popularity or favourites. The season endpoint returns the anime airing this season ranked by member count. Build anime trackers, recommendation widgets, seasonal-airing dashboards and community-sentiment tools on top of real MyAnimeList data. Look up a title by its MAL id (try id=52991, Frieren).

## 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/myanimelist-api/..."
```

## Pricing
- **Free** (Free) — 19,000 calls/Mo, 3 req/s
- **Starter** ($6/Mo) — 270,000 calls/Mo, 10 req/s
- **Pro** ($16/Mo) — 1,100,000 calls/Mo, 25 req/s
- **Scale** ($37/Mo) — 3,900,000 calls/Mo, 55 req/s

## Endpoints

### Anime

#### `GET /v1/anime` — Title snapshot — MAL score, rank, members

**Parameters:**
- `id` (query, required, string) — MAL anime id Example: `52991`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/myanimelist-api/v1/anime?id=52991"
```

### Stats

#### `GET /v1/stats` — Community engagement breakdown and score distribution

**Parameters:**
- `id` (query, required, string) — MAL anime id Example: `52991`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/myanimelist-api/v1/stats?id=52991"
```

### Top

#### `GET /v1/top` — Top-ranked anime

**Parameters:**
- `filter` (query, optional, string) — airing, upcoming, bypopularity or favorite (default by score) Example: `bypopularity`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/myanimelist-api/v1/top?filter=bypopularity"
```

### Season

#### `GET /v1/season` — Anime airing this season, ranked by members

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

### Meta

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

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


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