AniList

Search AniList's anime and manga database through its keyless public API: browse and filter anime and manga; look up characters, staff, studios, and public user profiles and lists; get airing schedules, reviews, recommendations, forum threads, and the genre and tag catalogs. No account or API key required.

Actions

Action	What it does
Get airing schedule	Get anime episode airing times.
Get anime	Get one anime's full details by its AniList id, including description, studios, tags, rankings, relations, external links, the next airing episode, and its main characters.
Get character	Get one character's full details by its AniList id, including description, gender, date of birth, and the media they appear in with their voice actors.
Get forum thread	Get one forum thread's full body and metadata by its AniList id.
Get manga	Get one manga's full details by its AniList id, including description, tags, rankings, relations, external links, and its main characters.
Get recommendations	Get community 'if you liked this, try that' recommendations for an anime or manga by its AniList id.
Get review	Get one review's full text and score by its AniList id.
Get site statistics	Get AniList's latest site-wide totals: how many anime, manga, characters, staff, studios, reviews, and users it tracks.
Get staff member	Get one staff member's full details by their AniList id, including biography, occupations, the media they worked on, and characters they voiced.
Get studio	Get one studio's details by its AniList id, including whether it's an animation studio and its most popular works.
Get user profile	Get a public AniList user's profile by username, including their bio and anime and manga watching/reading statistics.
Get user's anime/manga list	Get a public AniList user's anime or manga list, grouped by status list, with each entry's score, progress, and dates.
List activity feed	List the public AniList activity feed: text posts and list updates.
List genres	List every genre AniList uses to categorize anime and manga.
List reviews	List AniList user reviews, optionally for a specific anime or manga, sorted by helpfulness, score, or recency.
List tags	List every descriptive tag AniList uses (themes, settings, demographics, and more), with each tag's category.
Search anime	Search AniList's anime database by title and filter by genre, tag, season, year, format, status, source, country, and score.
Search characters	Search AniList's database of anime and manga characters by name.
Search forum threads	Search AniList forum threads by keyword, or list the most active threads, with reply and view counts.
Search manga	Search AniList's manga database by title and filter by genre, tag, format, status, source, country, and score.
Search staff	Search AniList's database of staff and voice actors by name (directors, writers, animators, seiyuu, and more).
Search studios	Search AniList's database of animation studios and producers by name.
Search users	Search AniList's public user profiles by username.

Get airing schedule

Get anime episode airing times. Filter to upcoming episodes, a single anime, or a window of time, and sort by soonest first.

Inputs

Anime IDmedia_idnumber: Only include episodes of this anime (its AniList id, as returned by Search anime). Leave blank for all anime.
Upcoming onlynot_yet_airedtrue/false: Only include episodes that haven't aired yet.
Airing afterairing_afterdate and time: Only include episodes airing on or after this date and time.
Airing beforeairing_beforedate and time: Only include episodes airing on or before this date and time.
Sort bysorttext: How to order the schedule.One of: TIME (Airing soonest), TIME_DESC (Airing latest), EPISODE (Episode (ascending)), EPISODE_DESC (Episode (descending)). Default: TIME.
Page numberpagenumber: Which page of results to return (starts at 1).At least 1. Default: 1.
How manyper_pagenumber: How many episodes to return per page (1-50).From 1 to 50. Default: 10.

Outputs

airingScheduleslist
pageInfoobject

Example output

{
  "airingSchedules": [
    {
      "airingAt": 1786613400,
      "episode": 21,
      "id": 412121,
      "media": {
        "coverImage": {
          "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/default.png"
        },
        "episodes": null,
        "format": "TV",
        "id": 209541,
        "siteUrl": "https://anilist.co/anime/209541",
        "title": {
          "english": null,
          "native": "\u30d7\u30ea\u30ad\u30e5\u30a2",
          "romaji": "Precure Season 3"
        }
      },
      "mediaId": 209541,
      "timeUntilAiring": 68400
    }
  ],
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  }
}

Get anime

Get one anime's full details by its AniList id, including description, studios, tags, rankings, relations, external links, the next airing episode, and its main characters.

Inputs

Anime IDmedia_idnumberRequired: The anime's AniList id (e.g. 1), as returned by Search anime.

Outputs

mediaobject

Example output

{
  "media": {
    "averageScore": 86,
    "bannerImage": "https://s4.anilist.co/file/anilistcdn/media/anime/banner/1-OquNCNB6srGe.jpg",
    "chapters": null,
    "characters": {
      "edges": [
        {
          "node": {
            "id": 1,
            "image": {
              "large": "https://s4.anilist.co/file/anilistcdn/character/large/b1-ChxaldmieFlQ.png"
            },
            "name": {
              "full": "Spike Spiegel",
              "native": "\u30b9\u30d1\u30a4\u30af"
            },
            "siteUrl": "https://anilist.co/character/1"
          },
          "role": "MAIN"
        }
      ]
    },
    "countryOfOrigin": "JP",
    "coverImage": {
      "color": "#f16b50",
      "extraLarge": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/large/bx1-GCsPm7waJ4kS.png",
      "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx1-GCsPm7waJ4kS.png",
      "medium": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/small/bx1-GCsPm7waJ4kS.png"
    },
    "description": "Enter a world in the distant future, where Bounty Hunters roam the solar system. Spike and Jet, bounty hunting partners, set out on journeys in an ever struggling effort to win bounty rewards to survive.",
    "duration": 24,
    "endDate": {
      "day": 24,
      "month": 4,
      "year": 1999
    },
    "episodes": 26,
    "externalLinks": [
      {
        "color": "#f47521",
        "icon": null,
        "language": "English",
        "site": "Crunchyroll",
        "type": "STREAMING",
        "url": "https://www.crunchyroll.com/cowboy-bebop"
      }
    ],
    "favourites": 33477,
    "format": "TV",
    "genres": [
      "Action",
      "Adventure",
      "Drama",
      "Sci-Fi"
    ],
    "hashtag": null,
    "id": 1,
    "idMal": 1,
    "isAdult": false,
    "isLicensed": true,
    "meanScore": 86,
    "nextAiringEpisode": null,
    "popularity": 462772,
    "rankings": [
      {
        "allTime": true,
        "context": "highest rated all time",
        "format": "TV",
        "rank": 1,
        "season": null,
        "type": "RATED",
        "year": null
      }
    ],
    "relations": {
      "edges": [
        {
          "node": {
            "format": "MOVIE",
            "id": 5,
            "title": {
              "english": "Cowboy Bebop: The Movie",
              "romaji": "Cowboy Bebop: Tengoku no Tobira"
            },
            "type": "ANIME"
          },
          "relationType": "SIDE_STORY"
        }
      ]
    },
    "season": "SPRING",
    "seasonYear": 1998,
    "siteUrl": "https://anilist.co/anime/1",
    "source": "ORIGINAL",
    "startDate": {
      "day": 3,
      "month": 4,
      "year": 1998
    },
    "status": "FINISHED",
    "studios": {
      "nodes": [
        {
          "id": 14,
          "name": "Sunrise",
          "siteUrl": "https://anilist.co/studio/14"
        }
      ]
    },
    "synonyms": [
      "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7"
    ],
    "tags": [
      {
        "category": "Setting-Universe",
        "description": "Involves outer space.",
        "id": 63,
        "isAdult": false,
        "isGeneralSpoiler": false,
        "isMediaSpoiler": false,
        "name": "Space",
        "rank": 90
      }
    ],
    "title": {
      "english": "Cowboy Bebop",
      "native": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
      "romaji": "Cowboy Bebop"
    },
    "trailer": {
      "id": "qig4KOK2R2g",
      "site": "youtube",
      "thumbnail": null
    },
    "type": "ANIME",
    "volumes": null
  }
}

Get character

Get one character's full details by its AniList id, including description, gender, date of birth, and the media they appear in with their voice actors.

Inputs

Character IDcharacter_idnumberRequired: The character's AniList id (e.g. 1), as returned by Search characters.

Outputs

characterobject

Example output

{
  "character": {
    "age": "27",
    "bloodType": null,
    "dateOfBirth": {
      "day": 26,
      "month": 6,
      "year": 2044
    },
    "description": "A tall and lean 27-year-old bounty hunter born on Mars.",
    "favourites": 14906,
    "gender": "Male",
    "id": 1,
    "image": {
      "large": "https://s4.anilist.co/file/anilistcdn/character/large/b1-ChxaldmieFlQ.png",
      "medium": "https://s4.anilist.co/file/anilistcdn/character/medium/b1-ChxaldmieFlQ.png"
    },
    "media": {
      "edges": [
        {
          "characterRole": "MAIN",
          "node": {
            "format": "TV",
            "id": 1,
            "title": {
              "english": "Cowboy Bebop",
              "romaji": "Cowboy Bebop"
            },
            "type": "ANIME"
          },
          "voiceActors": [
            {
              "id": 95011,
              "name": {
                "full": "Kouichi Yamadera"
              }
            }
          ]
        }
      ]
    },
    "name": {
      "alternative": [
        "Swimming Bird"
      ],
      "full": "Spike Spiegel",
      "native": "\u30b9\u30d1\u30a4\u30af\u30fb\u30b9\u30d4\u30fc\u30b2\u30eb"
    },
    "siteUrl": "https://anilist.co/character/1"
  }
}

Get forum thread

Get one forum thread's full body and metadata by its AniList id.

Inputs

Thread IDthread_idnumberRequired: The thread's AniList id, as returned by Search forum threads.

Outputs

threadobject

Example output

{
  "thread": {
    "body": "What's your favorite anime of all time and why?",
    "categories": [
      {
        "id": 5,
        "name": "Anime"
      }
    ],
    "createdAt": 1480000000,
    "id": 617,
    "isLocked": false,
    "isSticky": false,
    "repliedAt": 1786500000,
    "replyCount": 3247,
    "siteUrl": "https://anilist.co/forum/thread/617",
    "title": "Your Favorite Anime / The Best Anime",
    "user": {
      "avatar": {
        "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
      },
      "id": 12345,
      "name": "Poster"
    },
    "viewCount": 45017
  }
}

Get manga

Get one manga's full details by its AniList id, including description, tags, rankings, relations, external links, and its main characters.

Inputs

Manga IDmedia_idnumberRequired: The manga's AniList id (e.g. 30002), as returned by Search manga.

Outputs

mediaobject

Example output

{
  "media": {
    "averageScore": 93,
    "bannerImage": "https://s4.anilist.co/file/anilistcdn/media/manga/banner/30002-Iri2XCsg99Fp.jpg",
    "chapters": null,
    "countryOfOrigin": "JP",
    "coverImage": {
      "color": "#e4a15d",
      "extraLarge": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/large/bx30002-3Td1sMHW8Nyh.png",
      "large": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/medium/bx30002-3Td1sMHW8Nyh.png",
      "medium": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/small/bx30002-3Td1sMHW8Nyh.png"
    },
    "duration": null,
    "endDate": {
      "day": null,
      "month": null,
      "year": null
    },
    "episodes": null,
    "favourites": 42137,
    "format": "MANGA",
    "genres": [
      "Action",
      "Adventure",
      "Drama",
      "Fantasy",
      "Horror"
    ],
    "id": 30002,
    "idMal": 2,
    "isAdult": false,
    "meanScore": 93,
    "popularity": 141230,
    "season": null,
    "seasonYear": null,
    "siteUrl": "https://anilist.co/manga/30002",
    "source": "ORIGINAL",
    "startDate": {
      "day": 25,
      "month": 8,
      "year": 1989
    },
    "status": "RELEASING",
    "title": {
      "english": "Berserk",
      "native": "\u30d9\u30eb\u30bb\u30eb\u30af",
      "romaji": "Berserk"
    },
    "type": "MANGA",
    "volumes": null
  }
}

Get recommendations

Get community 'if you liked this, try that' recommendations for an anime or manga by its AniList id.

Inputs

Anime/Manga IDmedia_idnumberRequired: The AniList id of the title to get recommendations for, as returned by Search anime or Search manga.
Sort bysorttext: How to order the recommendations.One of: RATING_DESC (Most recommended), ID (AniList ID). Default: RATING_DESC.
Page numberpagenumber: Which page of results to return (starts at 1).At least 1. Default: 1.
How manyper_pagenumber: How many recommendations to return per page (1-50).From 1 to 50. Default: 10.

Outputs

pageInfoobject
recommendationslist

Example output

{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "recommendations": [
    {
      "id": 1468,
      "media": {
        "coverImage": {
          "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx1-GCsPm7waJ4kS.png"
        },
        "format": "TV",
        "id": 1,
        "siteUrl": "https://anilist.co/anime/1",
        "title": {
          "english": "Cowboy Bebop",
          "romaji": "Cowboy Bebop"
        },
        "type": "ANIME"
      },
      "mediaRecommendation": {
        "averageScore": 79,
        "coverImage": {
          "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx6-hlBoHM6nsMKP.jpg"
        },
        "format": "TV",
        "id": 6,
        "siteUrl": "https://anilist.co/anime/6",
        "title": {
          "english": "Trigun",
          "romaji": "Trigun"
        },
        "type": "ANIME"
      },
      "rating": 655,
      "user": {
        "id": 12345,
        "name": "Recommender"
      }
    }
  ]
}

Get review

Get one review's full text and score by its AniList id.

Inputs

Review IDreview_idnumberRequired: The review's AniList id, as returned by List reviews.

Outputs

reviewobject

Example output

{
  "review": {
    "body": "Cowboy Bebop remains one of the finest anime ever made...",
    "createdAt": 1500000000,
    "id": 4159,
    "media": {
      "id": 1,
      "title": {
        "english": "Cowboy Bebop",
        "romaji": "Cowboy Bebop"
      },
      "type": "ANIME"
    },
    "private": false,
    "rating": 412,
    "ratingAmount": 450,
    "score": 95,
    "siteUrl": "https://anilist.co/review/4159",
    "summary": "A timeless masterpiece.",
    "user": {
      "avatar": {
        "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
      },
      "id": 12345,
      "name": "Reviewer"
    }
  }
}

Get site statistics

Get AniList's latest site-wide totals: how many anime, manga, characters, staff, studios, reviews, and users it tracks.

Inputs

None.

Outputs

statisticsobject

Example output

{
  "statistics": {
    "anime": {
      "change": 1,
      "count": 22506,
      "date": 1786543226
    },
    "characters": {
      "change": 60,
      "count": 289450,
      "date": 1786543226
    },
    "manga": {
      "change": 174,
      "count": 138216,
      "date": 1786543226
    },
    "reviews": {
      "change": 5,
      "count": 21500,
      "date": 1786543226
    },
    "staff": {
      "change": 20,
      "count": 128900,
      "date": 1786543226
    },
    "studios": {
      "change": 3,
      "count": 12800,
      "date": 1786543226
    },
    "users": {
      "change": 2160,
      "count": 3993292,
      "date": 1786543226
    }
  }
}

Get staff member

Get one staff member's full details by their AniList id, including biography, occupations, the media they worked on, and characters they voiced.

Inputs

Staff IDstaff_idnumberRequired: The staff member's AniList id (e.g. 95269), as returned by Search staff.

Outputs

staffobject

Example output

{
  "staff": {
    "age": 85,
    "bloodType": null,
    "characters": {
      "nodes": []
    },
    "dateOfBirth": {
      "day": 5,
      "month": 1,
      "year": 1941
    },
    "dateOfDeath": {
      "day": null,
      "month": null,
      "year": null
    },
    "description": "Japanese director, animator, and manga artist, co-founder of Studio Ghibli.",
    "favourites": 15242,
    "gender": "Male",
    "homeTown": "Tokyo, Japan",
    "id": 95269,
    "image": {
      "large": "https://s4.anilist.co/file/anilistcdn/staff/large/n95269-emU4Nr9F8Gd8.png",
      "medium": "https://s4.anilist.co/file/anilistcdn/staff/medium/n95269-emU4Nr9F8Gd8.png"
    },
    "languageV2": "Japanese",
    "name": {
      "full": "Hayao Miyazaki",
      "native": "\u5bae\u5d0e\u99ff"
    },
    "primaryOccupations": [
      "Director"
    ],
    "siteUrl": "https://anilist.co/staff/95269",
    "staffMedia": {
      "edges": [
        {
          "node": {
            "format": "MOVIE",
            "id": 129,
            "title": {
              "english": "Spirited Away",
              "romaji": "Sen to Chihiro no Kamikakushi"
            },
            "type": "ANIME"
          },
          "staffRole": "Director"
        }
      ]
    },
    "yearsActive": [
      1963
    ]
  }
}

Get studio

Get one studio's details by its AniList id, including whether it's an animation studio and its most popular works.

Inputs

Studio IDstudio_idnumberRequired: The studio's AniList id (e.g. 14), as returned by Search studios.

Outputs

studioobject

Example output

{
  "studio": {
    "favourites": 6421,
    "id": 14,
    "isAnimationStudio": true,
    "media": {
      "nodes": [
        {
          "averageScore": 86,
          "format": "TV",
          "id": 1,
          "siteUrl": "https://anilist.co/anime/1",
          "startDate": {
            "year": 1998
          },
          "title": {
            "english": "Cowboy Bebop",
            "romaji": "Cowboy Bebop"
          }
        }
      ]
    },
    "name": "Sunrise",
    "siteUrl": "https://anilist.co/studio/14"
  }
}

Get user profile

Get a public AniList user's profile by username, including their bio and anime and manga watching/reading statistics.

Inputs

UsernameusernametextRequired: The exact AniList username, e.g. 'AniList'.

Outputs

userobject

Example output

{
  "user": {
    "about": "The AniList admin account.",
    "avatar": {
      "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/b6933956-785reg36BUwc.png",
      "medium": "https://s4.anilist.co/file/anilistcdn/user/avatar/medium/b6933956-785reg36BUwc.png"
    },
    "bannerImage": null,
    "createdAt": 1550000000,
    "donatorBadge": null,
    "donatorTier": 0,
    "id": 6933956,
    "name": "AniList",
    "siteUrl": "https://anilist.co/user/6933956",
    "statistics": {
      "anime": {
        "count": 0,
        "episodesWatched": 0,
        "meanScore": 0,
        "minutesWatched": 0
      },
      "manga": {
        "chaptersRead": 0,
        "count": 0,
        "meanScore": 0,
        "volumesRead": 0
      }
    },
    "updatedAt": 1786500000
  }
}

Get user's anime/manga list

Get a public AniList user's anime or manga list, grouped by status list, with each entry's score, progress, and dates. Returns one chunk at a time.

Inputs

UsernameusernametextRequired: The exact AniList username whose list to fetch.
Listmedia_typetextRequired: Which list to fetch: the user's anime list or manga list.One of: ANIME, MANGA.
Statusstatustext: Only include entries with this status.One of: CURRENT (Watching / Reading), PLANNING, COMPLETED, DROPPED, PAUSED, REPEATING.
Sort bysorttext: How to order the entries within each list.One of: UPDATED_TIME_DESC (Recently updated), SCORE_DESC (Highest scored), PROGRESS_DESC (Most progress), STARTED_ON_DESC (Recently started), FINISHED_ON_DESC (Recently finished), MEDIA_POPULARITY_DESC (Most popular), ADDED_TIME_DESC (Recently added). Default: UPDATED_TIME_DESC.
Chunk numberchunknumber: Which chunk of the list to return (starts at 1).At least 1. Default: 1.
Entries per chunkper_chunknumber: How many entries to return per chunk (1-50).From 1 to 50. Default: 10.

Outputs

hasNextChunktrue/false
listslist
userobject

Example output

{
  "hasNextChunk": false,
  "lists": [
    {
      "entries": [
        {
          "completedAt": {
            "day": 20,
            "month": 1,
            "year": 2021
          },
          "media": {
            "averageScore": 86,
            "chapters": null,
            "coverImage": {
              "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx1-GCsPm7waJ4kS.png"
            },
            "episodes": 26,
            "format": "TV",
            "id": 1,
            "siteUrl": "https://anilist.co/anime/1",
            "title": {
              "english": "Cowboy Bebop",
              "native": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
              "romaji": "Cowboy Bebop"
            },
            "type": "ANIME"
          },
          "progress": 26,
          "progressVolumes": null,
          "repeat": 1,
          "score": 95,
          "startedAt": {
            "day": 3,
            "month": 1,
            "year": 2021
          },
          "status": "COMPLETED",
          "updatedAt": 1611100000
        }
      ],
      "isCustomList": false,
      "name": "Completed",
      "status": "COMPLETED"
    }
  ],
  "user": {
    "avatar": {
      "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
    },
    "id": 5114268,
    "name": "Josh",
    "siteUrl": "https://anilist.co/user/5114268"
  }
}

List activity feed

List the public AniList activity feed: text posts and list updates. Optionally filter to a single user or activity type.

Inputs

User IDuser_idnumber: Only include activity from this user (their AniList id, as returned by Search users). Leave blank for the global feed.
Activity typeactivity_typetext: Only include this kind of activity.One of: TEXT (Text posts), ANIME_LIST (Anime list updates), MANGA_LIST (Manga list updates), MEDIA_LIST (List updates (anime & manga)).
Sort bysorttext: How to order the activity.One of: ID_DESC (Newest first), ID (Oldest first), PINNED (Pinned first). Default: ID_DESC.
Page numberpagenumber: Which page of results to return (starts at 1).At least 1. Default: 1.
How manyper_pagenumber: How many activities to return per page (1-50).From 1 to 50. Default: 10.

Outputs

activitieslist
pageInfoobject

Example output

{
  "activities": [
    {
      "__typename": "ListActivity",
      "createdAt": 1786600000,
      "id": 1134231454,
      "likeCount": 3,
      "media": {
        "coverImage": {
          "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx1-GCsPm7waJ4kS.png"
        },
        "format": "TV",
        "id": 1,
        "siteUrl": "https://anilist.co/anime/1",
        "title": {
          "english": "Cowboy Bebop",
          "romaji": "Cowboy Bebop"
        },
        "type": "ANIME"
      },
      "progress": "12",
      "replyCount": 0,
      "siteUrl": "https://anilist.co/activity/1134231454",
      "status": "watched episode",
      "type": "ANIME_LIST",
      "user": {
        "avatar": {
          "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
        },
        "id": 12345,
        "name": "Watcher"
      }
    }
  ],
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  }
}

List genres

List every genre AniList uses to categorize anime and manga.

Inputs

None.

Outputs

genreslist

Example output

{
  "genres": [
    "Action",
    "Adventure",
    "Comedy",
    "Drama",
    "Ecchi",
    "Fantasy",
    "Horror",
    "Mahou Shoujo",
    "Mecha",
    "Music",
    "Mystery",
    "Psychological",
    "Romance",
    "Sci-Fi",
    "Slice of Life",
    "Sports",
    "Supernatural",
    "Thriller"
  ]
}

List reviews

List AniList user reviews, optionally for a specific anime or manga, sorted by helpfulness, score, or recency.

Inputs

Anime/Manga IDmedia_idnumber: Only include reviews of this title (its AniList id). Leave blank for site-wide reviews.
Typemedia_typetext: Only include reviews of anime or of manga.One of: ANIME, MANGA.
Sort bysorttext: How to order the reviews.One of: RATING_DESC (Most helpful), SCORE_DESC (Highest score), UPDATED_AT_DESC (Recently updated), ID_DESC (Newest first). Default: RATING_DESC.
Page numberpagenumber: Which page of results to return (starts at 1).At least 1. Default: 1.
How manyper_pagenumber: How many reviews to return per page (1-50).From 1 to 50. Default: 10.

Outputs

pageInfoobject
reviewslist

Example output

{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "reviews": [
    {
      "createdAt": 1500000000,
      "id": 4159,
      "media": {
        "id": 1,
        "title": {
          "english": "Cowboy Bebop",
          "romaji": "Cowboy Bebop"
        },
        "type": "ANIME"
      },
      "rating": 412,
      "ratingAmount": 450,
      "score": 95,
      "siteUrl": "https://anilist.co/review/4159",
      "summary": "A timeless masterpiece.",
      "user": {
        "avatar": {
          "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
        },
        "id": 12345,
        "name": "Reviewer"
      }
    }
  ]
}

List every descriptive tag AniList uses (themes, settings, demographics, and more), with each tag's category.

Inputs

None.

Outputs

tagslist

Example output

{
  "tags": [
    {
      "category": "Setting-Universe",
      "description": "Involves outer space.",
      "id": 63,
      "isAdult": false,
      "isGeneralSpoiler": false,
      "name": "Space",
      "rank": 90
    }
  ]
}

Search anime

Search AniList's anime database by title and filter by genre, tag, season, year, format, status, source, country, and score.

Inputs

Titlesearchtext: The anime title to search for, e.g. 'Cowboy Bebop'.
Genresgenreslist: Only include anime in these genres.
Tagstagslist: Only include anime with these AniList tags.
Seasonseasontext: Only include anime from this release season.One of: WINTER, SPRING, SUMMER, FALL.
Yearseason_yearnumber: Only include anime from this release year.From 1940 to 2100.
Formatformattext: Only include anime of this format.One of: TV, TV_SHORT (TV Short), MOVIE, SPECIAL, OVA, ONA, MUSIC.
Airing statusstatustext: Only include anime with this airing status.One of: FINISHED, RELEASING, NOT_YET_RELEASED (Not Yet Released), CANCELLED, HIATUS.
Source materialsourcetext: Only include anime adapted from this source.One of: ORIGINAL, MANGA, LIGHT_NOVEL (Light Novel), VISUAL_NOVEL (Visual Novel), VIDEO_GAME (Video Game), OTHER, NOVEL, DOUJINSHI, ANIME, WEB_NOVEL (Web Novel), and 5 more.
Country of origincountrytext: Only include anime from this country.One of: JP (Japan), KR (South Korea), CN (China), TW (Taiwan).
Minimum scoremin_scorenumber: Only include anime scoring above this value (0-100).From 0 to 100.
Started afterstart_date_afterdate: Only include anime that started on or after this date.
Started beforestart_date_beforedate: Only include anime that started on or before this date.
Include adult contentinclude_adulttrue/false: Include 18+ titles in the results. Off by default.Default: false.
Sort bysorttext: How to order the results.One of: POPULARITY_DESC (Most popular), SCORE_DESC (Highest rated), TRENDING_DESC (Trending now), FAVOURITES_DESC (Most favourited), START_DATE_DESC (Newest first), START_DATE (Oldest first), TITLE_ROMAJI (Title (A-Z)), EPISODES_DESC (Most episodes), UPDATED_AT_DESC (Recently updated), ID (AniList ID). Default: POPULARITY_DESC.
Page numberpagenumber: Which page of results to return (starts at 1).At least 1. Default: 1.
How manyper_pagenumber: How many anime to return per page (1-50).From 1 to 50. Default: 10.

Outputs

medialist
pageInfoobject

Example output

{
  "media": [
    {
      "averageScore": 86,
      "bannerImage": "https://s4.anilist.co/file/anilistcdn/media/anime/banner/1-OquNCNB6srGe.jpg",
      "chapters": null,
      "countryOfOrigin": "JP",
      "coverImage": {
        "color": "#f16b50",
        "extraLarge": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/large/bx1-GCsPm7waJ4kS.png",
        "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx1-GCsPm7waJ4kS.png",
        "medium": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/small/bx1-GCsPm7waJ4kS.png"
      },
      "duration": 24,
      "endDate": {
        "day": 24,
        "month": 4,
        "year": 1999
      },
      "episodes": 26,
      "favourites": 33477,
      "format": "TV",
      "genres": [
        "Action",
        "Adventure",
        "Drama",
        "Sci-Fi"
      ],
      "id": 1,
      "idMal": 1,
      "isAdult": false,
      "meanScore": 86,
      "popularity": 462772,
      "season": "SPRING",
      "seasonYear": 1998,
      "siteUrl": "https://anilist.co/anime/1",
      "source": "ORIGINAL",
      "startDate": {
        "day": 3,
        "month": 4,
        "year": 1998
      },
      "status": "FINISHED",
      "title": {
        "english": "Cowboy Bebop",
        "native": "\u30ab\u30a6\u30dc\u30fc\u30a4\u30d3\u30d0\u30c3\u30d7",
        "romaji": "Cowboy Bebop"
      },
      "type": "ANIME",
      "volumes": null
    }
  ],
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  }
}

Search characters

Search AniList's database of anime and manga characters by name.

Inputs

NamesearchtextRequired: The character name to search for, e.g. 'Spike Spiegel'.
Sort bysorttext: How to order the results.One of: SEARCH_MATCH (Best match), FAVOURITES_DESC (Most favourited), ID (AniList ID). Default: SEARCH_MATCH.
Page numberpagenumber: Which page of results to return (starts at 1).At least 1. Default: 1.
How manyper_pagenumber: How many characters to return per page (1-50).From 1 to 50. Default: 10.

Outputs

characterslist
pageInfoobject

Example output

{
  "characters": [
    {
      "favourites": 14906,
      "id": 1,
      "image": {
        "large": "https://s4.anilist.co/file/anilistcdn/character/large/b1-ChxaldmieFlQ.png"
      },
      "name": {
        "full": "Spike Spiegel",
        "native": "\u30b9\u30d1\u30a4\u30af\u30fb\u30b9\u30d4\u30fc\u30b2\u30eb"
      },
      "siteUrl": "https://anilist.co/character/1"
    }
  ],
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  }
}

Search forum threads

Search AniList forum threads by keyword, or list the most active threads, with reply and view counts.

Inputs

Keywordsearchtext: Search threads by title/body keyword. Leave blank to list threads.
Sort bysorttext: How to order the threads.One of: SEARCH_MATCH (Best match), REPLIED_AT_DESC (Recently replied), REPLY_COUNT_DESC (Most replies), VIEW_COUNT_DESC (Most viewed), UPDATED_AT_DESC (Recently updated), ID_DESC (Newest first). Default: REPLIED_AT_DESC.
Page numberpagenumber: Which page of results to return (starts at 1).At least 1. Default: 1.
How manyper_pagenumber: How many threads to return per page (1-50).From 1 to 50. Default: 10.

Outputs

pageInfoobject
threadslist

Example output

{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "threads": [
    {
      "categories": [
        {
          "id": 5,
          "name": "Anime"
        }
      ],
      "createdAt": 1480000000,
      "id": 617,
      "isLocked": false,
      "isSticky": false,
      "repliedAt": 1786500000,
      "replyCount": 3247,
      "siteUrl": "https://anilist.co/forum/thread/617",
      "title": "Your Favorite Anime / The Best Anime",
      "user": {
        "avatar": {
          "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/default.png"
        },
        "id": 12345,
        "name": "Poster"
      },
      "viewCount": 45017
    }
  ]
}

Search manga

Search AniList's manga database by title and filter by genre, tag, format, status, source, country, and score.

Inputs

Titlesearchtext: The manga title to search for, e.g. 'Berserk'.
Genresgenreslist: Only include manga in these genres.
Tagstagslist: Only include manga with these AniList tags.
Formatformattext: Only include manga of this format.One of: MANGA, NOVEL (Light Novel), ONE_SHOT (One Shot).
Publishing statusstatustext: Only include manga with this publishing status.One of: FINISHED, RELEASING, NOT_YET_RELEASED (Not Yet Released), CANCELLED, HIATUS.
Source materialsourcetext: Only include manga adapted from this source.One of: ORIGINAL, MANGA, LIGHT_NOVEL (Light Novel), VISUAL_NOVEL (Visual Novel), VIDEO_GAME (Video Game), OTHER, NOVEL, DOUJINSHI, ANIME, WEB_NOVEL (Web Novel), and 5 more.
Country of origincountrytext: Only include titles from this country (e.g. Japan for manga, South Korea for manhwa, China for manhua).One of: JP (Japan), KR (South Korea), CN (China), TW (Taiwan).
Minimum scoremin_scorenumber: Only include manga scoring above this value (0-100).From 0 to 100.
Started afterstart_date_afterdate: Only include manga that started on or after this date.
Started beforestart_date_beforedate: Only include manga that started on or before this date.
Include adult contentinclude_adulttrue/false: Include 18+ titles in the results. Off by default.Default: false.
Sort bysorttext: How to order the results.One of: POPULARITY_DESC (Most popular), SCORE_DESC (Highest rated), TRENDING_DESC (Trending now), FAVOURITES_DESC (Most favourited), START_DATE_DESC (Newest first), START_DATE (Oldest first), TITLE_ROMAJI (Title (A-Z)), EPISODES_DESC (Most episodes), UPDATED_AT_DESC (Recently updated), ID (AniList ID). Default: POPULARITY_DESC.
Page numberpagenumber: Which page of results to return (starts at 1).At least 1. Default: 1.
How manyper_pagenumber: How many manga to return per page (1-50).From 1 to 50. Default: 10.

Outputs

medialist
pageInfoobject

Example output

{
  "media": [
    {
      "averageScore": 93,
      "bannerImage": "https://s4.anilist.co/file/anilistcdn/media/manga/banner/30002-Iri2XCsg99Fp.jpg",
      "chapters": null,
      "countryOfOrigin": "JP",
      "coverImage": {
        "color": "#e4a15d",
        "extraLarge": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/large/bx30002-3Td1sMHW8Nyh.png",
        "large": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/medium/bx30002-3Td1sMHW8Nyh.png",
        "medium": "https://s4.anilist.co/file/anilistcdn/media/manga/cover/small/bx30002-3Td1sMHW8Nyh.png"
      },
      "duration": null,
      "endDate": {
        "day": null,
        "month": null,
        "year": null
      },
      "episodes": null,
      "favourites": 42137,
      "format": "MANGA",
      "genres": [
        "Action",
        "Adventure",
        "Drama",
        "Fantasy",
        "Horror"
      ],
      "id": 30002,
      "idMal": 2,
      "isAdult": false,
      "meanScore": 93,
      "popularity": 141230,
      "season": null,
      "seasonYear": null,
      "siteUrl": "https://anilist.co/manga/30002",
      "source": "ORIGINAL",
      "startDate": {
        "day": 25,
        "month": 8,
        "year": 1989
      },
      "status": "RELEASING",
      "title": {
        "english": "Berserk",
        "native": "\u30d9\u30eb\u30bb\u30eb\u30af",
        "romaji": "Berserk"
      },
      "type": "MANGA",
      "volumes": null
    }
  ],
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  }
}

Search staff

Search AniList's database of staff and voice actors by name (directors, writers, animators, seiyuu, and more).

Inputs

NamesearchtextRequired: The staff member's name to search for, e.g. 'Hayao Miyazaki'.
Sort bysorttext: How to order the results.One of: SEARCH_MATCH (Best match), FAVOURITES_DESC (Most favourited), ID (AniList ID). Default: SEARCH_MATCH.
Page numberpagenumber: Which page of results to return (starts at 1).At least 1. Default: 1.
How manyper_pagenumber: How many staff members to return per page (1-50).From 1 to 50. Default: 10.

Outputs

pageInfoobject
stafflist

Example output

{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "staff": [
    {
      "favourites": 15242,
      "id": 95269,
      "image": {
        "large": "https://s4.anilist.co/file/anilistcdn/staff/large/n95269-emU4Nr9F8Gd8.png"
      },
      "name": {
        "full": "Hayao Miyazaki",
        "native": "\u5bae\u5d0e\u99ff"
      },
      "primaryOccupations": [
        "Director"
      ],
      "siteUrl": "https://anilist.co/staff/95269"
    }
  ]
}

Search studios

Search AniList's database of animation studios and producers by name.

Inputs

NamesearchtextRequired: The studio name to search for, e.g. 'ufotable'.
Sort bysorttext: How to order the results.One of: SEARCH_MATCH (Best match), FAVOURITES_DESC (Most favourited), NAME (Name (A-Z)), ID (AniList ID). Default: SEARCH_MATCH.
Page numberpagenumber: Which page of results to return (starts at 1).At least 1. Default: 1.
How manyper_pagenumber: How many studios to return per page (1-50).From 1 to 50. Default: 10.

Outputs

pageInfoobject
studioslist

Example output

{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "studios": [
    {
      "favourites": 6421,
      "id": 14,
      "isAnimationStudio": true,
      "name": "Sunrise",
      "siteUrl": "https://anilist.co/studio/14"
    }
  ]
}

Search users

Search AniList's public user profiles by username.

Inputs

UsernamesearchtextRequired: The username to search for.
Sort bysorttext: How to order the results.One of: SEARCH_MATCH (Best match), USERNAME (Username (A-Z)), WATCHED_TIME_DESC (Most anime watched), CHAPTERS_READ_DESC (Most chapters read), ID (AniList ID). Default: SEARCH_MATCH.
Page numberpagenumber: Which page of results to return (starts at 1).At least 1. Default: 1.
How manyper_pagenumber: How many users to return per page (1-50).From 1 to 50. Default: 10.

Outputs

pageInfoobject
userslist

Example output

{
  "pageInfo": {
    "currentPage": 1,
    "hasNextPage": true,
    "lastPage": 5000,
    "perPage": 1,
    "total": 5000
  },
  "users": [
    {
      "avatar": {
        "large": "https://s4.anilist.co/file/anilistcdn/user/avatar/large/b6933956-785reg36BUwc.png"
      },
      "bannerImage": null,
      "id": 6933956,
      "name": "AniList",
      "siteUrl": "https://anilist.co/user/6933956"
    }
  ]
}

ActionsCopy Anchor Link

Get airing scheduleCopy Anchor Link

Inputs

Outputs

Get animeCopy Anchor Link

Inputs

Outputs

Get characterCopy Anchor Link

Inputs

Outputs

Get forum threadCopy Anchor Link

Inputs

Outputs

Get mangaCopy Anchor Link

Inputs

Outputs

Get recommendationsCopy Anchor Link

Inputs

Outputs

Get reviewCopy Anchor Link

Inputs

Outputs

Get site statisticsCopy Anchor Link

Inputs

Outputs

Get staff memberCopy Anchor Link

Inputs

Outputs

Get studioCopy Anchor Link

Inputs

Outputs

Get user profileCopy Anchor Link

Inputs

Outputs

Get user's anime/manga listCopy Anchor Link

Inputs

Outputs

List activity feedCopy Anchor Link

Inputs

Outputs

List genresCopy Anchor Link

Inputs

Outputs

List reviewsCopy Anchor Link

Inputs

Outputs

List tagsCopy Anchor Link

Inputs

Outputs

Search animeCopy Anchor Link

Inputs

Outputs

Search charactersCopy Anchor Link

Inputs

Outputs

Search forum threadsCopy Anchor Link

Inputs

Outputs

Search mangaCopy Anchor Link

Inputs

Outputs

Search staffCopy Anchor Link

Inputs

Outputs

Search studiosCopy Anchor Link

Inputs

Outputs

Search usersCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get airing schedule

Get anime

Get character

Get forum thread

Get manga

Get recommendations

Get review

Get site statistics

Get staff member

Get studio

Get user profile

Get user's anime/manga list

List activity feed

List genres

List reviews

List tags

Search anime

Search characters

Search forum threads

Search manga

Search staff

Search studios

Search users