AniList GraphQL API v2

The AniList GraphQL API v2 is the primary public developer interface for AniList.co. It exposes anime, manga, character, staff, studio, user, activity, review, recommendation, thread, comment, notification, and airing schedule data through a single endpoint at https://graphql.anilist.co. All requests are POSTs carrying a query and optional variables payload. Mutations require an OAuth2 access token. The schema includes 25+ root Query fields (Page, Media, MediaTrend, AiringSchedule, Character, Staff, MediaList, MediaListCollection, GenreCollection, MediaTagCollection, User, Viewer, Notification, Studio, Review, Activity, ActivityReply, Following, Follower, Thread, ThreadComment, Recommendation, Like, Markdown, AniChartUser, SiteStatistics, ExternalLinkSourceCollection) and 30+ root Mutation fields (UpdateUser, SaveMediaListEntry, UpdateMediaListEntries, DeleteMediaListEntry, DeleteCustomList, SaveTextActivity, SaveMessageActivity, SaveListActivity, DeleteActivity, ToggleActivityPin, ToggleActivitySubscription, SaveActivityReply, DeleteActivityReply, ToggleLike, ToggleLikeV2, ToggleFollow, ToggleFavourite, UpdateFavouriteOrder, SaveReview, DeleteReview, RateReview, SaveRecommendation, SaveThread, DeleteThread, ToggleThreadSubscription, SaveThreadComment, DeleteThreadComment, UpdateAniChartSettings, UpdateAniChartHighlights).

API entry from apis.yml

apis.yml Raw ↑
name: AniList GraphQL API v2
description: The AniList GraphQL API v2 is the primary public developer interface for AniList.co. It exposes
  anime, manga, character, staff, studio, user, activity, review, recommendation, thread, comment, notification,
  and airing schedule data through a single endpoint at https://graphql.anilist.co. All requests are POSTs
  carrying a query and optional variables payload. Mutations require an OAuth2 access token. The schema
  includes 25+ root Query fields (Page, Media, MediaTrend, AiringSchedule, Character, Staff, MediaList,
  MediaListCollection, GenreCollection, MediaTagCollection, User, Viewer, Notification, Studio, Review,
  Activity, ActivityReply, Following, Follower, Thread, ThreadComment, Recommendation, Like, Markdown,
  AniChartUser, SiteStatistics, ExternalLinkSourceCollection) and 30+ root Mutation fields (UpdateUser,
  SaveMediaListEntry, UpdateMediaListEntries, DeleteMediaListEntry, DeleteCustomList, SaveTextActivity,
  SaveMessageActivity, SaveListActivity, DeleteActivity, ToggleActivityPin, ToggleActivitySubscription,
  SaveActivityReply, DeleteActivityReply, ToggleLike, ToggleLikeV2, ToggleFollow, ToggleFavourite, UpdateFavouriteOrder,
  SaveReview, DeleteReview, RateReview, SaveRecommendation, SaveThread, DeleteThread, ToggleThreadSubscription,
  SaveThreadComment, DeleteThreadComment, UpdateAniChartSettings, UpdateAniChartHighlights).
humanURL: https://docs.anilist.co/
baseURL: https://graphql.anilist.co
tags:
- GraphQL
- Anime
- Manga
- Media
- Social
properties:
- type: Documentation
  url: https://docs.anilist.co/
- type: GettingStarted
  url: https://docs.anilist.co/guide/introduction
- type: Quickstart
  url: https://docs.anilist.co/guide/graphql/
- type: APIReference
  url: https://docs.anilist.co/reference/
- type: Authentication
  url: https://docs.anilist.co/guide/auth/
- type: RateLimits
  url: https://docs.anilist.co/guide/rate-limiting
  data:
  - name: Default per-IP/user rate limit
    description: 90 requests per minute under normal conditions; currently degraded to 30 requests per
      minute. X-RateLimit-Limit and X-RateLimit-Remaining headers are returned. Exceeding the limit returns
      HTTP 429 with Retry-After and X-RateLimit-Reset headers and a GraphQL "Too Many Requests." error.
  - name: Burst limiter
    description: An additional burst limiter throttles bursts of requests over very short windows.
- type: Sandbox
  url: https://studio.apollographql.com/sandbox/explorer?endpoint=https%3A%2F%2Fgraphql.anilist.co
- type: Console
  url: https://anilist.co/settings/developer
- type: Errors
  url: https://docs.anilist.co/guide/graphql/errors