MyAnimeList Autocomplete API
Type-ahead suggestions across 11 categories, up to 10 items each, with ids and links.
GET /v1/myanimelist/suggest1 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.
Other MyAnimeList endpoints
- Anime titleGET /v1/myanimelist/anime/{id}
- Manga titleGET /v1/myanimelist/manga/{id}
- Anime cast and staffGET /v1/myanimelist/anime/{id}/characters
- Manga castGET /v1/myanimelist/manga/{id}/characters
- Anime statisticsGET /v1/myanimelist/anime/{id}/statistics
- Manga statisticsGET /v1/myanimelist/manga/{id}/statistics
- Anime reviewsGET /v1/myanimelist/anime/{id}/reviews
- Manga reviewsGET /v1/myanimelist/manga/{id}/reviews