> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/myanimelist/top>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/myanimelist/top.mdx>

---

# MyAnimeList Rankings API

Ranked anime and manga, 50 rows per page, overall or by airing, movie, popularity and more.

`GET /v1/myanimelist/top?kind=anime` returns `data.kind`, `data.type`, `data.results[]` and `page`. Each row has `rank`, `id`, `title`, `url`, `imageUrl`, `mediaType`, `episodes`, `volumes`, `aired`, `members` and `score`. A page holds 50 rows; continue with `page.nextCursor` while `page.hasMore` is true.

The optional `type` narrows the ranking. Anime accepts `airing`, `upcoming`, `tv`, `movie`, `ova`, `ona`, `special`, `bypopularity` and `favorite`. Manga accepts `manga`, `novels`, `oneshots`, `doujin`, `manhwa`, `manhua`, `bypopularity` and `favorite`. Omit it for the overall ranking of the kind.

## Request

- **Endpoint:** `GET /v1/myanimelist/top`
- **Credits:** 1 credit
Failed requests are free
A not-found answer is still charged
- **Input:** by kind and type
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/myanimelist/top)
- **Platform page:** [/platforms/myanimelist](https://www.socialfetch.dev/platforms/myanimelist)

## FAQ

### Can I use an anime type for a manga ranking?

No. The route validates the pair and returns a 400 when `type` is not valid for the chosen `kind`, so an anime-only type cannot slip into a manga request.

### Why is a rank null?

Some rows are unranked even in a ranking list. The route keeps the row and returns `rank: null` rather than dropping it.

### How many credits does this request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

### Does the list update on its own?

The ranking reflects MyAnimeList at request time. The response is a snapshot, so poll the route at the interval your product needs.
