MyAnimeList hub

MyAnimeList Anime Recommendations API

Every recommended title and every recommendation text for one anime, in one answer.

GET /v1/myanimelist/anime/{id}/recommendations

1 credit Failed requests are free A not-found answer is still charged

About this endpoint

GET /v1/myanimelist/anime/{id}/recommendations returns data.recommendations[]. Each entry has id, mediaKind, title, url, recommendedBy, permalink and items[], where each item holds the recommendation text and the username who wrote it.

The list covers every recommendation for the title and has no cursor. Missing recommendations are an empty array on a found title; an unknown anime id returns lookupStatus: not_found.

MyAnimeList Anime Recommendations API FAQ

What does `recommendedBy` count?

It is the number of members who recommended that pair. The same entry can have several recommendation texts in items.

Can I page the recommendations?

No. The result contains the complete recommendation list in one answer, so it has no page object.

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.

How do I read the recommendation text?

Join items[].text for the pair. items[].username is null when the author is not shown.