Anitabi 开放 API 基础地址、端点和使用限制

两个基础地址

⚠️ 官方特别提醒：不要在任何场景下请求主域 anitabi.cn，主域不确保资源地址和数据结构的稳定。

正确的两个基础地址：

• 数据 API：https://api.anitabi.cn/——所有地标、作品、统计数据
• 图片 API：https://image.anitabi.cn/——所有缩略图和原图

可用端点一览

${subjectID} 是 Bangumi 作品 Subject ID（bangumi.tv/subject/{subjectID} 里的那串数字）。

使用限制

允许的使用场景

"允许在非商业非盈利项目中调用圣地作品坐标截图等信息的开放接口。"

这意味着：

• ✅ 个人博客展示某部作品的巡礼地标
• ✅ 开源项目集成 Anitabi 数据
• ✅ 学习 / 研究 / 本地个人项目
• ❌ 商业项目（含 App 内广告、付费功能）
• ❌ 爬虫大批量抓取

速率限制

官方文档没有明确写速率限制，但建议：

• 不要用完整尺寸截图做展示（API 提供了缩略图 plan=h160 和 plan=h360）
• 完整尺寸截图会给服务器造成压力
• 批量调用建议加延迟（比如每秒 1 个请求）

官方示例

轻量版地标查询

GET https://api.anitabi.cn/bangumi/115908/lite

返回：

• 作品名、原名、主要城市、主色
• 前 10 个标志性地标（名称、截图、EP、秒数、坐标）
• 地标总数、有截图的地标数
• 数据最后更新时间戳

完整地标详情

GET https://api.anitabi.cn/bangumi/115908/points/detail

可选 QueryString：

• haveImage=true：筛选只返回有截图的地标

返回数组，每个元素包含：

• 地标 ID、原名、截图缩略图、EP、秒数、坐标
• origin：地标贡献来源（如 Google Maps）
• originURL：来源链接（需要展示给用户）

关联工具

官方提供了一个辅助函数，根据 Bangumi Subject ID 生成 Anitabi 巡礼地图地址：

function getAnitabiSubjectURLById(id) {
    return `https://anitabi.cn/map?bangumiId=${id}`;
}

直接在 Anitabi 地图打开指定作品的地标视图。