公开 API
其他端点
字幕组短链 RSS、全站磁力 RSS、季度番剧 JSON、单番剧字幕组 JSON。
主入口之外，AniBT 还提供四个常用端点：两个 RSS（短链 + 全站）、两个 JSON（季度 + 单番剧）。
本页的 RSS 端点都返回原生 RSS 2.0 XML。浏览器直开 RSS URL 时不加载站点自定义 XSL/CSS，会使用浏览器默认 XML 树展示；RSS 阅读器和 BT 客户端继续按标准字段消费。
字幕组短链 RSS
GET /rss/group/<slug>.xml
全站磁力 RSS
GET /rss/magnets.xml
季度番剧 JSON
GET /api/seasons/anime
单番剧字幕组 JSON
GET /api/anime/groups
字幕组短链 /rss/group/<slug>.xml
等价于 /rss/anime.xml?groupSlug=<slug> 但 URL 更短，便于贴 README / 论坛。
路径必须以 .xml 结尾。支持 ?limit=，不支持 Tag 过滤；需要过滤请走 RSS 主入口。
https://anibt.net/rss/group/kirara-fantasia.xml
https://anibt.net/rss/group/pre-s.xml
https://anibt.net/rss/group/kitauji-sub.xml
https://anibt.net/rss/group/haruhana.xml全站磁力 /rss/magnets.xml
适合"看看全站最近发了什么"。
https://anibt.net/rss/magnets.xml
https://anibt.net/rss/magnets.xml?limit=200
https://anibt.net/rss/magnets.xml?q=葬送的芙莉莲
https://anibt.net/rss/magnets.xml?resolution=1080p&language=CHS简单查询缓存 120 秒；带 q + 多 filter 的复杂查询缓存 60 秒。两者都叠加 stale-while-revalidate=600s，CDN 在窗口过期后仍立即吐旧版给用户、后台异步刷新。详见 HTTP 缓存与 304。
季度番剧 /api/seasons/anime
第三方追番站 / 看板 / 编辑器辅助使用。返回当季已上架番剧 + 可选季度列表。
请求
GET https://anibt.net/api/seasons/anime
GET https://anibt.net/api/seasons/anime?season=2026春
GET https://anibt.net/api/seasons/anime?season=2026-SPRING # 也接受英文形式
GET https://anibt.net/api/seasons/anime?bgmId=543360 # 精确返回单个番剧
GET https://anibt.net/api/seasons/anime?query=夏日口袋 # 按番剧标题搜索
GET https://anibt.net/api/seasons/anime?season=2026夏&query=Summer%20PocketsQuery
属性
类型
响应字段（节选）
{
"ok": true,
"ts": 1776841966624,
"data": {
"currentSeason": "2026春",
"requestedSeason": "2026春",
"availableSeasons": ["2024春", "2024夏", "...", "2026秋"],
"scheduleSummary": {
"scheduled": 97,
"weekdayOnly": 0,
"missingSource": 9
},
"byWeekday": [
{
"weekday": 1,
"weekdayLabel": "周一",
"animes": [
{
"bgmId": 543360,
"animeId": "nh73r0ernee7s0afv9s82f763983gcz7",
"cover": "https://r2.anibt.net/anime_covers/.../...jpg",
"title": {
"primary": "上伊那牡丹，酒醉身姿似百合花般",
"chinese": "上伊那牡丹，酒醉身姿似百合花般",
"romaji": "Kamiina Botan, Yoeru Sugata wa Yuri no Hana",
"english": "Botan Kamiina Fully Blossoms When Drunk",
"japanese": "上伊那ぼたん、酔へる姿は百合の花"
},
"format": "TV",
"kind": "TV",
"rating": 73,
"airingAt": 1764259200,
"weekday": 1,
"weekdayLabel": "周一",
"scheduleStatus": "scheduled",
"rssReleaseCount": 11,
"hasRelease": true
}
]
},
{ "weekday": 0, "weekdayLabel": "周日", "animes": [ /* ... */ ] },
{ "weekday": null, "weekdayLabel": "未排播", "animes": [ /* 源数据缺少播放日 */ ] }
],
"total": 106
}
}关键字段
属性
类型
缓存与限流
| 项目 | 值 |
|---|---|
| 速率限制 | 30 次 / 60 秒 / IP（与 /api/anime/groups 共用窗口） |
Cache-Control | public, max-age=0, s-maxage=600, stale-while-revalidate=86400, stale-if-error=86400（浏览器重新验证 + CDN 10 分钟新鲜 + 24h SWR/SIE） |
| 条件请求 | If-None-Match（ETag 形如 W/"sa-{year}-{SEASON}[-b{bgmId}]-{count}-{lastMs}-{urlHash}"）、If-Modified-Since |
curl 'https://anibt.net/api/seasons/anime'
curl 'https://anibt.net/api/seasons/anime?season=2026春'
curl 'https://anibt.net/api/seasons/anime?bgmId=543360'
curl 'https://anibt.net/api/seasons/anime?query=夏日口袋'
ETAG=$(curl -sSI 'https://anibt.net/api/seasons/anime' | grep -i ^etag: | awk '{print $2}' | tr -d '\r')
curl -i 'https://anibt.net/api/seasons/anime' -H "If-None-Match: $ETAG"
# → HTTP/2 304单番剧字幕组 /api/anime/groups
「这部番都谁在做？」一个
bgmId即可拿到全部正在发布的字幕组、最近更新时间，以及最近 30 条发布。
专为给 /rss/anime.xml 拼 groupSlug 提供候选，也方便客户端直接做"番剧详情页 / 资源列表"。
请求
GET https://anibt.net/api/anime/groups?bgmId=543360属性
类型
响应（节选）
{
"ok": true,
"ts": 1776841967132,
"data": {
"bgmId": 543360,
"animeId": "nh73r0ernee7s0afv9s82f763983gcz7",
"title": { /* primary / chinese / romaji / english / japanese */ },
"groups": [
{
"groupId": "org_aagmgM9i0ZyR",
"slug": "kitauji-sub",
"name": "北宇治字幕组",
"status": "ACTIVE",
"lastUpdatedAt": 1776624843260,
"items": [
{
"releaseId": "rel_fItEHE7r1gR1",
"title": "[北宇治字幕组] 上伊那牡丹，酒醉身姿似百合 [02][WebRip][HEVC_AAC][繁日內嵌]",
"magnet": "magnet:?xt=urn:btih:282e2b…",
"episodeKey": "2",
"resolution": "1080p",
"language": ["CHT", "JP"],
"subtitle": "EMBEDDED",
"publishedAt": 1776624843260
}
/* … 最多 30 条，按 publishedAt desc … */
]
}
/* … 其他字幕组 … */
],
"total": 4
}
}字段
groups列表按lastUpdatedAt倒序（最近发过的排前面）。items：该字幕组对该番剧最近发布的资源，最多 30 条，按publishedAtdesc。可直接渲染"番剧 × 字幕组"维度的资源面板，避免单独拉 RSS。magnet可能为null（仅有种子文件、未生成磁力时）。episodeKey是稳定的集数键（如"01"、"SP01"），便于客户端排序 / 聚合。language：("CHS" | "CHT" | "JP" | "EN" | "KO" | "ES" | "PT" | "FR" | "DE" | "IT" | "RU" | "AR" | "HI" | "ID" | "MS" | "TH" | "VI" | "TL" | "TR" | "PL" | "UK")[]。subtitle："EMBEDDED" | "EXTERNAL" | "BUILT_IN" | "NONE"（内嵌 / 外挂 / 内封 / 无）。
slug与/api/subtitle-groups完全一致，可直接喂给/rss/anime.xml?groupSlug=…。- 如果该
bgmId未上架或被隐藏，返回404 ANIME_NOT_FOUND。
典型用法 — 给追番器拼 RSS
# Step 1: 知道 bgmId，拉它的字幕组列表
curl -s 'https://anibt.net/api/anime/groups?bgmId=543360' \
| jq -r '.data.groups[].slug'
# kitauji-sub
# kirara-fantasia
# pre-s
# haruhana
# Step 2: 拼 RSS（多个字幕组、CHS+1080p）
curl 'https://anibt.net/rss/anime.xml?bgmId=543360&groupSlug=kitauji-sub,kirara-fantasia,pre-s,haruhana&language=CHS&resolution=1080p&limit=50'缓存与限流
| 项目 | 值 |
|---|---|
| 速率限制 | 30 次 / 60 秒 / IP（与 /api/seasons/anime 共用窗口） |
Cache-Control | public, max-age=0, s-maxage=300, stale-while-revalidate=3600, stale-if-error=3600（浏览器重新验证 + CDN 5 分钟新鲜 + 1h SWR/SIE） |
| 条件请求 | If-None-Match（W/"ag-{bgmId}-{count}-{lastMs}-{urlHash}"）、If-Modified-Since |
当字幕组发新 release，lastUpdatedAt 跳动，ETag 失效，缓存自然刷新。轮询频率建议不要短于 5 分钟——更高频对你没有任何收益。