最後更新
點數
每個工作區都有一個點數錢包，每個計費週期都會重新補足。API 呼叫與主控台的讀取都從同一個錢包扣點；API 參考會列出每項操作所屬的類別。
各項操作的費用
| 類別 | 每次呼叫點數 | 涵蓋範圍 |
|---|---|---|
| 快取讀取 | 1 | 每次讀取已儲存的資料：排行榜、創作者、洞察、影片、留言、趨勢、LIVE 場次。列出 API 金鑰（GET /v1/api-keys）也算快取讀取。 |
| 追蹤名單 | 4,000 | GET /v1/creators/{uid}/following 或 /followers 需要重新收集名單時（取代 1 點）。 |
| 留言 | 500 | GET /v1/videos/{id}/comments 需要重新收集留言時（取代 1 點）。 |
| 檔案解析 | 1,250 | GET /v1/creators/{uid} 重新解析過時的檔案時，在讀取費用之外另計。只有在成功取回檔案時才收費。 |
| LIVE 狀態更新 | 1,250 | POST /v1/live/creators/{uid}/refresh：要求工作程序立即檢查某位創作者。 |
| 匯出 | 2,500 | POST /v1/exports：產生 CSV 或 Excel 檔案。 |
| Webhook 推送 | 1 | 提醒規則推送的每個 Webhook，包括規則測試所送出的那一個。 |
| 免費 | 0 | 管理提醒規則、列出與下載匯出檔、建立與撤銷金鑰、方案權益與用量。 |
API 參考中的每項操作都會在其權限範圍旁標示所屬類別。202 回應（收集仍在進行中）以快取讀取計費。
每月點數額度
每個日曆月（UTC），工作區的方案會在當月第一次計費呼叫或讀取錢包時發放點數額度。單月支出不能超過該額度。方案內容請參閱價格方案。
| 方案 | 每月點數 |
|---|---|
| Free | 150,000 |
| Starter | 450,000 |
| Pro | 3,000,000 |
| Scale | 12,000,000 |
| Agency / Enterprise | 36,000,000 |
錢包用完時
會使支出超過上限的計費呼叫，會以一般的錯誤格式回傳 402 與錯誤碼 credit_cap_exceeded。免費操作仍可正常使用。錢包會在下個月初重新補足；在月中升級方案則會立即提高上限。
失敗的呼叫不收費
點數會在呼叫開始時預留，並在呼叫失敗時退還，因此
4xx 或 5xx 回應不會花費任何點數。2xx 或 3xx 回應則會收費。讀取錢包
GET /v1/entitlements 會回傳方案、限制以及本期的錢包；GET /v1/usage 則依操作細分支出。兩者都免費，且需要 keys:manage 權限範圍。
bash
curl "https://api.toktokdata.live/v1/entitlements" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY" # data.credits: { "period": "2026-11-01", "monthlyAllotment": …, "hardCap": …, "spent": …, "remaining": … }這個頁面對你有幫助嗎？