MyAnimeList

简介

MyAnimeList 的 v2 API 提供最大的动漫/漫画数据库——标题、排名和用户列表。认证是带 Client ID 的 OAuth 2.0（未认证请求返回 403 “forbidden”——已实测）。

快速开始

在 myanimelist.net/apiconfig 获取 Client ID，然后（替换 CLIENT_ID）：

curl "https://api.myanimelist.net/v2/anime?q=naruto&limit=3" \
  -H "X-MAL-CLIENT-ID: CLIENT_ID"

{
  "data": [
    {
      "node": { "id": 20, "title": "Naruto", "main_picture": { "medium": "https://..." }, "mean": 7.97 }
    }
  ]
}

带字段的动漫详情：

curl "https://api.myanimelist.net/v2/anime/20?fields=id,title,synopsis,mean" \
  -H "X-MAL-CLIENT-ID: CLIENT_ID"

认证方式

• 在 myanimelist.net/apiconfig 注册 → 创建应用 → Client ID。
• 通过 X-MAL-CLIENT-ID 请求头携带（缺失 → 403，已实测）。
• 完整用户列表需要 OAuth 流程（访问令牌）。

速率限制与注意事项

• 免费；请求按 Client ID 限流（看文档）。
• v2 是当前 API（旧 v1 已关闭）。
• fields= 选择响应字段；limit/offset 分页。

常见问题

MyAnimeList API 免费吗？ 是的——Client ID 免费。

如何获取 Client ID？ myanimelist.net/apiconfig → 创建应用。

为什么 403？ 缺失 X-MAL-CLIENT-ID 返回 403（已实测）。