AniList

简介

AniList 的 API 是动漫和漫画的 GraphQL 服务：搜索番剧/漫画、获取角色、声优、制作公司、类型、播出日程和用户列表——外加 OAuth 读写用户的追番列表。是社区最喜欢的现代动漫 API。

快速开始

一个 GraphQL 查询（实测可用——POST）：

curl -X POST "https://graphql.anilist.co" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ Media(id: 1) { title { romaji } } }"}'

{"data": {"Media": {"title": {"romaji": "Cowboy Bebop"}}}}

搜索动漫并获取更多字段：

curl -X POST "https://graphql.anilist.co" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ Media(search: \"one piece\", type: ANIME) { id title { romaji english } averageScore episodes genres } }"}'

当季番：

curl -X POST "https://graphql.anilist.co" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ Page(perPage: 5) { media(season: SUMMER, seasonYear: 2026, type: ANIME) { title { romaji } } } }"}'

认证方式（OAuth）

• 匿名：查询免密钥可用（实测）——搜索/浏览应用够用。
• OAuth：在 anilist.co/settings/developer 注册应用获取 client id/secret；授权码流程颁发 token 用于用户级查询（Viewer { id }、列表变更）。

速率限制与注意事项

• 速率限制：30 次请求/分钟（匿名）；OAuth 后 90 次/分钟——请积极缓存。
• 纯 GraphQL：一个端点，POST {"query": "..."}；用 fragment 和选择集保持载荷小巧。
• API 文档内置 GraphQL 浏览器（anilist.co/graphiql）——用它构建查询。
• Media ID 稳定，与 Media 联合类型（ANIME/MANGA）共用。

常见问题

AniList API 免费吗？ 是的——GraphQL 查询免费；匿名限制 30 次/分钟。

需要 OAuth 吗？ 只有用户列表功能需要——浏览/搜索匿名即可。

在哪里构建查询？ anilist.co/graphiql 的 GraphiQL 浏览器。