Search anime and manga
Search AniList titles by name, with optional filters.
GET https://cotlet.dev/api/v1/anilist/medias/search
read
Returns up to 50 titles per page with ID, titles, format, episode or chapter count, season year and average score. The order is the best match first. A title already on your list also shows its list status.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Title to search for, in romaji, English or native. |
| type string | string | ANIME or MANGA. Leave out to search both. |
| season_year integer | integer | Only titles from this season year. |
| genre string | string | Only titles with this genre. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl "https://cotlet.dev/api/v1/anilist/medias/search?query=query" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("anilist", "search_media", {"query":"query"})const result = await cotlet.call('anilist', 'search_media', {"query":"query"});cotlet call anilist search_media --data '{"query":"query"}'Example response
{
"items": [
{
"media_id": 154587,
"title": "Frieren: Beyond Journey's End",
"type": "ANIME",
"format": "TV",
"episodes": 28,
"season_year": 2023,
"average_score": 91,
"on_list": "CURRENT"
}
],
"next_cursor": null
}