MyAnimeList hub

MyAnimeList Autocomplete API

Type-ahead suggestions across 11 categories, up to 10 items each, with ids and links.

GET /v1/myanimelist/suggest

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

About this endpoint

GET /v1/myanimelist/suggest?query=...&kind=all returns data.categories[]. Each category has a type and items[]; each item has id, kind, name, url, imageUrl, thumbnailUrl and a category-specific payload. A category holds at most 10 items.

The kind filter is one of anime, manga, character, person, user, company, club, news, featured, forum or all. This route is for type-ahead, not for full search: use /search when you need pages of results.

MyAnimeList Autocomplete API FAQ

What is in `payload`?

It is a record whose keys depend on the category. Anime and manga payloads can carry media type, aired or published text, score and status, while a user payload can carry join information. Read it as a category-specific bag, not a fixed type.

Why is a query with no exact match still returned?

Autocomplete can return fuzzy suggestions even when nothing matches exactly. Check items[].name and url before using an id.

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.

When should I use search instead?

Use autocomplete for a type-ahead box with a short query. Use /search when you need a paged result list for anime, manga, characters or people, because autocomplete caps each category at 10 items.