開放 API 總覽
AniBT 公開查詢、RSS、種子下載與字幕組 API。
AniBT 提供公開查詢與訂閱介面,以及透過字幕組 API Key 呼叫的釋出、刪除和同步狀態介面。
欄位
型別
正式 Base URL 為 https://anibt.net。API Key、個人 RSS 權杖和登入工作階段適用於不同介面,不能互相取代。成功回應的包裝、空值與錯誤格式依各端點定義處理。
機器可讀定義見 /openapi.yaml。介面頁展示請求欄位和回應示例;標題匹配可匿名呼叫,但傳入 groupId 時要求登入工作階段及該組成員身份。
番劇查詢與評分
/api/seasons/anime 的 scope.kind 區分季度瀏覽、關鍵字搜尋與精確 ID 查詢。全庫關鍵字搜尋的 requestedSeason 為 null,每部作品使用自己的季度;首播日期與季度分類分開。premiere.precision 為 day、month、season 或 year,粗精度日期使用週期首日。
季度瀏覽最多回傳 200 筆,關鍵字搜尋最多 50 筆。total 是本次回傳數量,truncated=true 表示還有結果;完整分頁使用 /api/animes/search,規則見番劇搜尋。rating 使用 0–10 分,缺有效來源評分時回傳 5.0;averageScore 使用 0–100 分,對應預設 50。現有 ani-rss 可直接排序,但舊版本不讀取截斷提示,仍最多顯示 50 筆搜尋結果。
預設評分會在後續同步取得有效來源評分時自動更新;人工鎖定的評分保留。資料更新沿用既有同步頻率,瀏覽頁面或訂閱 RSS 不會逐筆更新上游資料。
番劇搜尋
/api/animes/search、/search、/api/bgm/search 與 /api/seasons/anime 的 query 使用同一套標題搜尋,比對番劇的每個標題與別名。
比對前統一大小寫與全半形,把片假名摺疊為平假名,把繁體與日文新字體摺疊為簡體,再忽略空白與標點。ふりーれん 能找到片假名標題,進擊 能找到簡體標題。
比對結果分級排名,同級按熱度降序,再按番劇 ID 升序:
- 完全相等:某個標題或別名與查詢相同。
- 前綴:某個標題或別名以查詢開頭。
- 子字串:某個標題或別名包含查詢。
- 多詞:每個詞都命中同一部番劇的某個標題或別名,順序不限,可以分散在不同標題裡。只在查詢有 2–16 個詞時使用;詞更多時跳過這一級,不報錯。
- 字序:2–4 個中日文字元按順序出現在同一個標題或別名裡,可以不連續。
進巨能找到「進擊的巨人」。 - 相似度:拼寫相近的標題或別名。
/api/animes/search、/search 與 /api/bgm/search 按這個排名回傳。/api/seasons/anime 只用它選出最多 50 部番劇,回應仍按星期分組,組內按播出時間與標題排序。
限制:
- 拼寫容錯只來自相似度。長標題能容忍少量拼寫差異,例如
kimetu no yaiba;短單字的字母換位可能找不到,例如freiren。 - 所有標點都是分隔符,
Re:Zero與Re Zero是同一個查詢。年份沒有單獨的規則,與其他詞一樣比對。 - 1–2 個字元的查詢不做子字串與相似度比對。能否比對到某個標題或別名,取決於兩者的關係:
- 查詢與整個標題或別名相同(忽略空白與標點)時總能比對到。
- 拉丁字母與數字:要是其中完整的詞或詞的開頭。
rk、or不比對詞中間的字母。 - 中日文:要是其中的單字或相鄰的兩個字。查詢裡的標點先被移除,所以
ス・ダ比對這兩個假名相鄰的標題或別名,不比對標題或別名裡被標點隔開的這兩個假名(整個標題或別名恰好是這兩個假名時除外)。不含空白與標點的兩個字還可以按上面的字序比對。 - 中日文與字母或數字混排(
人0):只比對相同的完整片段,也就是被空白或標點隔開的一段。
- 摺疊後為空的查詢(例如
☆★)回傳空的最後一頁。
番劇搜尋的分頁
/api/animes/search 接受 q、format、status、seasonYear、limit(預設 24,1–50)與 cursor,直接回傳 page、isDone、continueCursor,沒有 ok 或 data 包裝。q 與搜尋頁的輸入框一樣最多 300 個字元,更長時回傳 422 VALIDATION_ERROR。
continueCursor 是不透明的權杖,最後一頁為空字串。翻頁時原樣傳回,不要解析或自行拼接。
以下 cursor 回傳 422 VALIDATION_ERROR:
- 自行拼接的
ts_page:N與其他格式錯誤的值; - 不是為相同的查詢、篩選條件與搜尋規則簽發的值;
- 和空查詢一起傳送的值。
2026 年 10 月 31 日更新之前簽發的 cursor 已全部失效。收到 422 時去掉 cursor,從第一頁重新開始。
資源搜尋
/magnets?q、番劇頁的資源搜尋、其他類資源分類、/rss/magnets.xml?q=、/rss/other/<category>.xml?q= 與 /torznab/api?q= 按以下規則比對。每個詞都必須命中,不校正、不補全前綴,也不丟詞(/magnets?q 的例外見放寬搜尋與集數寫法):
- 番劇資源比對自己的標題與規格(集數標記、解析度、格式、字幕類型、語言)、所屬番劇的每個標題與別名,以及所屬字幕組的名稱與 slug。不同的詞可以命中不同位置,番劇的任一別名都能找到只有其他語言標題的資源。
- 其他類資源只比對自己的標題與分類,以及所屬字幕組的名稱與 slug。
- 字幕組的名稱與 slug 和其他文字一樣按完整的詞比對,不校正,也不補全前綴。引號短語必須整個出現在名稱或 slug 其中一個裡,不能一半在名稱、一半在 slug。狀態為「已停用」的字幕組不產生命中,「不活躍」的字幕組照常命中。2026 年 11 月 10 日起,關鍵字等於某個字幕組名稱或 slug 的 RSS 訂閱與 Torznab 搜尋,會多出該組標題裡沒有寫這個名稱的資源。
- 拉丁字母與數字要是完整的詞:
HEV找不到HEVC,1080找不到1080p,LoliHous找不到LoliHouse。 - 中日文按連續字元比對,不要求是完整的詞:
鬼滅能找到《鬼滅之刃》的資源。 - 字母與數字在每個介面都不區分大小寫與全半形,假名與繁簡體的摺疊方式與番劇搜尋相同。
結果只按所選排序列出,預設最新釋出在前,沒有相關度排序。Torznab 固定按釋出時間倒序。
嚴格比對的第一頁為空時,才執行一次拆詞或合詞回退:Loli Hose 能找到 LoliHose,rezero 能找到 Re:ZERO,Re:Zero 能找到 ReZero。回退只放寬相鄰詞的邊界,不放寬排除詞,後續頁沿用第一頁的比對方式。
/magnets 的放寬搜尋
/magnets?q 的番劇資源,在嚴格比對和上面的拆詞或合詞回退之後第一頁仍為空時,會再放寬搜尋一次,頁面上會提示這是放寬後的結果。排序不變,也不丟詞。依次嘗試,先有結果的生效:
- 詞前綴: 一個詞的最後一段如果不含數字、至少 3 個字元,可以只寫開頭:
HEV能找到HEVC,LoliHous能找到LoliHouse。含數字的部分不補全,1080還是找不到1080p。 - 番劇標題相似度: 嘗試比對番劇標題裡的單處拼寫差異:
kimetu no yaiba能找到《鬼滅之刃》的資源。不含數字的詞連起來至少要 6 個字元(全是中日文時至少 4 個),含數字的詞不計入,更短的查詢不走這一步。含數字的詞、1–3 個字元的詞,以及引號片語這類由多個部分組成的詞仍必須嚴格命中:kimetu no yaiba 1080p只列出 1080p 的資源,kimetsu no yaiba 2160p在沒有 2160p 資源時仍是空的,"kimetu no yaiba"加了引號也是空的。資源自身的文字(如字幕組名)沒有這項容錯。
兩步都不對字幕組的名稱與 slug 做前綴或拼寫容錯,它們仍按完整的詞比對。
第一頁的放寬讀取失敗時,答覆嚴格搜尋的空結果,不回傳錯誤;放寬結果翻頁時失敗,和其他搜尋一樣回傳 503。番劇頁的資源搜尋、其他類資源分類、RSS 與 Torznab 始終按嚴格規則比對,所以 /magnets 上放寬後才有結果的搜尋詞,在 RSS 裡可能是空的。
/magnets 的集數寫法
/magnets?q 只看查詢的最後一個詞。它是 第N集、第N话、第N話、EP+N、E+N 或 #+N(N 為 1–4 位數字,可以有前導 0,不區分大小寫)時,這個詞不再按文字比對,而是作為集數篩選:無職轉生 第5集、無職轉生 EP05、無職轉生 #5 的結果與搜尋 無職轉生 並篩選第 5 集相同。搜尋框與網址保留原文;嚴格結果為空時,放寬搜尋照常進行,集數篩選保留。
- 只看最後一個詞,去掉它之後還要剩至少一個可以搜尋的詞:只搜
第5集時按文字比對。帶引號或排除的寫法("第5集"、-第5集)與單獨的數字(無職轉生 05)不轉換。 - 集數篩選列出集數等於 N 的資源。合集按它的第一集計算:
第1集也會列出1-12的合集,第5集不會。字幕組按系列編號標註的資源(第三季第 5 集寫成 53)不會被第5集找到。 - 只有
/magnets頁面這樣讀查詢。關鍵字 RSS 的q裡每個詞都按文字比對,集數用單獨的episode=參數篩選,合集同樣按第一集計算(見全站磁力 RSS)。Torznab 也不識別這些寫法,只把結尾的 2–4 位數字當作集數。 /magnets頁面為這類查詢提供的 RSS 連結帶上集數:無職轉生 第5集的連結是/rss/magnets.xml?q=無職轉生&episode=5,訂閱與頁面按相同的關鍵字和集數篩選。沒有集數寫法時,連結裡是原來的查詢。頁面選了字幕類型篩選時,連結也帶上subtitle=,位置在format之後、episode之前:/rss/magnets.xml?q=無職轉生&subtitle=INTERNAL&episode=5,訂閱與頁面按相同的字幕類型篩選。連結不帶limit(預設就是 100 筆),參數都是規範寫法時直接回傳訂閱,不經過308。兩種情況下訂閱仍與頁面不同:- 嚴格比對沒有結果時,頁面顯示放寬搜尋的結果,訂閱從不放寬,這時訂閱為空。
- 去掉寫法後剩下的文字沒有可以搜尋的詞時(
. EP05),頁面按原文做文字搜尋,連結仍是轉換後的形式,訂閱為空。
標點、引號與排除
- 不含數字的詞按標點拆開,各部分分別比對:
Nix-Raws、Re:Zero、鬼滅/第二季都是兩個詞,可以一個命中番劇別名,另一個命中資源標題。 - 含數字且有多個部分的詞是一個短語:
HEVC-10bit、x264-AAC、第2期的各部分必須在同一段文字(資源自己的標題與規格,番劇的一個標題、別名,或字幕組的名稱、slug)裡相鄰且順序相同。HEVC-10bit找不到10bit x264 HEVC,第2不比對第20期。 - 獨立成詞的完整引號短語是一個短語,可以含空白:
"25 1080p"。引號貼著其他字元或沒有閉合時,引號被忽略,其中的詞按一般詞處理。 -詞是排除,只看資源自己的標題與規格,不看番劇別名,也不看字幕組的名稱與 slug。-web-dl要求web與dl相鄰且順序相同,不排除寫成一個詞的WebDL。-"25 1080p"排除這個短語。- 兩側有空白的
-是分隔符:Title - 25搜尋25,Title -25排除25。 - 排除與引號短語用
-與"。全形的-、﹣與"在每個介面都按這兩個符號處理。−與彎引號不是操作符。
詞數上限與空查詢
一次查詢最多 16 個正向詞與 8 個排除詞。引號短語與含數字的詞算 1 個,a/b/c 算 3 個,分隔符與純符號不計,每個排除詞算 1 個。超出時各介面的回應:
欄位
型別
沒有任何正向詞的查詢(-、☆,或只有排除詞的 -25)不是錯誤:頁面回傳空頁,RSS 回傳有效的空 channel,Torznab 回傳 total 為 0 的空列表。這類查詢不簽發 cursor,帶 cursor 時按無效 cursor 處理。
傳送空的 q= 時,/magnets 列出全部資源,Torznab 列出最新資源,RSS 回傳 400。
資源搜尋的分頁
/magnets的分頁連結失效時回到目前條件的第一頁,包括 2026 年 10 月 31 日更新之前儲存的搜尋分頁連結。- RSS 沒有分頁,Torznab 使用有界
offset。
搜尋暫時無法使用
搜尋逾時或暫時無法完成時,介面不回傳部分結果,也不用空結果代替。唯一的例外是 /magnets?q 第一頁的放寬讀取失敗,嚴格搜尋已經確認沒有結果,答覆仍是這個空結果。
欄位
型別
上表是搜尋本身暫時無法使用時的回應。這些 JSON 介面的限流服務暫時無法計數時,另外回傳 503,error.code 為 SERVICE_UNAVAILABLE,帶 Retry-After: 15,見限流與參數上限。
播出狀態
自動判定完結需要明確的首播日期與結束日期,且來源在結束日完整過去後再次確認結束日期。日期按日本時間比較;只有年份、月份、季度或作品類型,不能據此判定完結。
來源更正播出計畫後,自動狀態會隨同步重新計算。人工鎖定的狀態以及明確的停播、取消狀態優先。證據不足的作品標為未知,不沿用缺乏依據的歷史狀態,也不把計畫結束日當成已完結證明。
首頁同一作品同一天只顯示最新一集;正常跨日連播仍分別顯示。
