MyAnimeList

List MyAnimeList rankings

List MyAnimeList anime or manga rankings, 50 rows per page.

GET/v1/myanimelist/top
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
kindstringrequiredquery

`anime` or `manga`.

one of: anime, manga

typestringoptionalquery

Ranking type; omit for the overall ranking of the kind.

one of: airing, upcoming, tv, movie, ova, ona, special, bypopularity, favorite, manga, novels, oneshots, doujin, manhwa, manhua

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 512 chars

Response fields
23

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the entity does not exist (a deleted title, an unknown id or user), not when a list is empty.

one of: found, not_found

datakind
string

`anime` or `manga`.

one of: anime, manga

datatype
stringnullable

Ranking type, or null for overall.

Ranking rows in this response.

dataresults[]rank
integernullable

Rank, or null.

dataresults[]id
integer

Title id.

dataresults[]title
string

Title.

dataresults[]url
string

Title URL.

dataresults[]imageUrl
stringnullable

Cover image.

dataresults[]mediaType
stringnullable

Format.

dataresults[]episodes
integernullable

Episode count.

dataresults[]volumes
integernullable

Volume count.

dataresults[]aired
stringnullable

Air span text.

dataresults[]members
integernullable

Member count.

dataresults[]score
numbernullable

Score, or null.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/myanimelist/top?kind=anime" \
  -H "x-api-key: YOUR_API_KEY"

Responses

MyAnimeList rankings.