TikTok API 速率限制:按帳戶、應用程式及端點計算
TikTok 的 API for Business 同時在三個層級限制調用:每個已授權帳戶在每個 Accounts API 端點每分鐘 40 次;每個開發者應用程式的 Accounts API 合計額度,在 Basic 為每分鐘 600 次,以上等級為 1,000 次;以及端點應用程式限制,Basic 為每秒 10 次、每分鐘 600 次、每日 864,000 次,Ultimate 則提升至每秒 50 次。
easyCoexistence 透過 TikTok 的 API for Business,為 Claude、ChatGPT 或您自己的程式碼發佈帖文、讀取洞察數據並回覆留言。
每個已授權 TikTok 帳戶於每個 Accounts API 端點每分鐘的查詢次數,獨立於應用程式等級,數值固定。
Advanced、Premium 及 Ultimate 等級的開發者應用程式,所有 Accounts API 端點的合計額度;Basic 為 600。
Ultimate(最高應用程式等級)的單一端點限制,另加每分鐘 3,000 次查詢及每日 4,320,000 次。
TikTok 回傳的狀態及其回傳代碼(包括 40100 等 4xxxx 代碼);只有代碼 0 表示成功。
每個開發者應用程式對每個 Discovery API 端點的速率限制。
每日限制的重設時間;超出每分鐘限制後,TikTok 改為要求暫停 5 分鐘。
哪些限制適用於 TikTok API 調用?
每次 Accounts API 調用最多會同時更新三個計數器,部分產品及操作亦設有各自的計數。TikTok 讓端點計數器各自獨立,因此某一端點可能被限速,而應用程式的其他端點仍可正常回應:
四個應用程式等級各允許什麼?
所有開發者應用程式均從 Basic 開始。在 My Apps、App Detail、Authorization 中提出申請並註明原因後,TikTok 會逐級將應用程式升至更高等級。每個等級除了設定 Accounts API 調用的合計額度外,也設定單一端點可由應用程式取用的上限:
更高等級會提高 Accounts API 的合計額度嗎?
只會提高一次。由 Basic 升至 Advanced 時,Accounts API 合計額度由每分鐘 600 次增至 1,000 次,之後 Premium 及 Ultimate 維持於 1,000 次,而每秒及每日的端點限制則持續提高。每個帳戶及端點每分鐘 40 次的限制完全不隨等級改變,因此無論應用程式屬於哪個等級,單一繁忙帳戶在某端點上仍會被限為每分鐘 40 次調用。
多個帳戶的限制如何累計?
帳戶限制會隨帳戶數目相乘,應用程式的合計額度則不會。十個帳戶各自可對 /business/comment/list/ 每分鐘調用 40 次,合共 400 次;但二十個帳戶做同樣操作便需 800 次,超出 Basic 應用程式在計算其他端點之前,為 Accounts API 調用合計設定的 600 次額度。在 Basic 以上等級,該共用額度最高為每分鐘 1,000 次。
超出限制時會發生什麼?
TikTok 會對該端點限速。其速率限制指南將受限調用的代碼列為 40100,該代碼會隨 HTTP 200 回應的內容一併傳回。超出每分鐘限制後,該端點會暫停 5 分鐘;超出每日限制後,則會一直暫停至 UTC 時間 00:00 每日計數重設為止。應用程式的其他端點仍可繼續回應。在程式碼中偵測此情況並妥善重試,請參閱錯誤 40100 的說明。
發佈上限是速率限制嗎?
不是。它計算的是帖文數目而非調用次數,並設有獨立頁面說明。TikTok 允許帳戶透過 /business/video/publish/ 每分鐘發佈六則帖文、每日發佈 15 則,/business/photo/publish/ 亦同。超過該數目的帖文會失敗,發佈狀態中會顯示 spam_risk_too_many_posts;速率限制則是直接拒絕該次調用。
哪些習慣最快耗用限制?
輪詢。以計時器不斷查看發佈狀態或留言列表,不論內容有否改變,都會耗用該帳戶在該端點每分鐘 40 次的額度。TikTok 的 Webhook 正是為取代此做法而設:帖文發佈事件會回報帖文的各個階段,comment.update 則會在五分鐘內回報新留言。分頁讀取(每次調用 20 則帖文或 30 則留言),以及每日只提取一次提及資料,可把其餘用量壓到最低。
easyCoexistence 如何處理受限的 TikTok 調用?
它會原樣轉達 TikTok 的回應,而非隱藏。被 TikTok 限速的工具調用(例如 list_social_comments、reply_to_comment 或 get_tiktok_publish_status)會以錯誤形式回傳給 AI,當中註明代碼 40100 及 TikTok 的訊息,且不會自行重試。帖文則走另一條路徑,因為 publish_tiktok_post 會把每則帖文交予 easyCoexistence 的隊列,立即或於指定時間發佈:
- 當 HTTP 429 回應出現時,隊列會等待 5 分鐘、30 分鐘及 2 小時後再試。
- TikTok 會在 HTTP 200 回應中傳送 40100,因此受限的 TikTok 發佈會以 TikTok 的訊息失敗,並在「Needs attention」下等待「Retry」。
- 隊列的狀態檢查若出現 40100,帖文同樣會失敗,但 TikTok 其實可能已發佈該帖文:重試前請先檢查帳戶的最新帖文。
- 背景失敗的帖文會以電郵通知擁有人,每個渠道每 3 小時最多一封。
easyCoexistence 會為某帳戶進行哪些 TikTok 調用?
數量不多,而且與您自己的調用一樣,會計入該帳戶的限制:
- /business/get/ 約每 6 小時一次,以確認帳戶仍可回應。
- 每則帖文一次發佈調用,之後約每 20 秒查詢一次 /business/publish/status/,直至 TikTok 完成或令帖文失敗,最長 2 小時。
- 開啟留言規則或自動化時,每則新的頂層留言會調用一次 /business/comment/list/ 以讀取其作者,每則已發出的回覆亦會各調用一次。
- 僅在 AI 或您的程式碼要求時才進行工具調用,每次讀取 20 則帖文或 30 則留言。
常見錯誤
- 以 HTTP 狀態判斷是否受限。TikTok 以 HTTP 200 回傳 40100,因此檢查 res.ok 或 429 會漏掉此情況;應讀取回應主體中的代碼。
- 為了解決某個繁忙帳戶而提高應用程式等級。每個帳戶及端點每分鐘 40 次的限制在四個等級中均相同,因此應把該帳戶的調用分散於不同時間。
- 每日多次提取 Mentions 資料。TikTok 每日於 UTC 時間 00:00 至 07:00 之間更新一次,並建議每個端點、每個帳戶每日只調用一次。
調用受限時,它會回傳 TikTok 的代碼與訊息,並追蹤每則帖文直至 TikTok 完成或令其失敗。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,並提供首 3 天免費試用。
常見問題
TikTok API 每個帳戶的速率限制是多少?
在每個 Accounts API 端點上,每個已授權 TikTok 帳戶每分鐘 40 次查詢,並受開發者應用程式的合計額度限制:Basic 為每分鐘 600 次,以上等級為 1,000 次。
TikTok 速率限制是否按端點計算?
是。TikTok 的指南指出,端點專屬限制各自獨立,因此某一端點達到限制並不會影響對其他端點的調用。
如何提高 TikTok API 的速率限制?
在 My Apps、App Detail、Authorization 中提出申請並註明原因。等級需逐級提升,由 Basic 至 Advanced,再到 Premium,最後為 Ultimate。
透過 easyCoexistence 的調用會計入 TikTok 的限制嗎?
會。它們以已連接帳戶及其存取權杖執行,因此與該帳戶的其他調用一樣,計入其每個端點每分鐘 40 次的額度。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期