Kitsu

简介

Kitsu 的 API 是动漫和漫画的 JSON:API——搜索番剧、获取单集、角色、人物和用户库数据。读取免密钥（实测可用）；OAuth 仅用于管理用户收藏和关注。

快速开始

搜索动漫——无需密钥（实测可用）：

curl "https://kitsu.io/api/edge/anime?page%5Blimit%5D=1"

{
  "data": [
    {
      "id": "1",
      "type": "anime",
      "attributes": {
        "canonicalTitle": "Cowboy Bebop",
        "averageRating": "86.35",
        "episodeCount": 26,
        "posterImage": { "original": "https://media.kitsu.io/anime/poster_images/1/original.jpg" }
      }
    }
  ],
  "meta": { "count": 17687 }
}

按标题搜索：

curl "https://kitsu.io/api/edge/anime?filter%5Btext%5D=one%20piece"

某番剧的单集：

curl "https://kitsu.io/api/edge/anime/1/episodes"

热门动漫：

curl "https://kitsu.io/api/edge/trending/anime"

认证方式（OAuth）

• 匿名：读取免密钥可用（实测）——搜索/浏览应用无需任何认证。
• OAuth：在 kitsu.io/settings/apps 注册应用 → client id/secret；授权码流程颁发令牌用于用户库端点（/users/{id}/library-entries、关注操作）。

速率限制与注意事项

• 按 IP/匿名限流（大约每小时几百次）——生产环境请缓存。
• JSON:API 格式：data/attributes/relationships；用 include= 内嵌关联记录。
• 筛选语法：filter[text]=、filter[status]=、filter[year]=。
• Kitsu 的数据模型（JSON:API）与 AniList（GraphQL）不同——按你的技术栈选择。

常见问题

Kitsu 免费吗？ 是的——读取免费且免密钥。

需要 OAuth 吗？ 只有用户库功能需要——浏览匿名即可。

用什么格式？ JSON:API（data/attributes/relationships），带 filter[] 查询参数。