最後更新
公開脈動
全平台的 LIVE 數字與最新的公開事件，也就是 RoomScope 首頁背後的資料來源。不需要 API 金鑰，也不會消耗點數。
請求
在網站來源上呼叫 GET /web-api/public/pulse，不需要任何參數，也不需要身分驗證。這是公開的網頁端點，並不屬於 /v1 API：它不接受 Authorization 標頭，也不會出現在你的用量中。
curl "https://toktokdata.live/web-api/public/pulse"回應
回應是一個 JSON 物件。所有數字都是以整個平台為範圍計算：其中沒有任何內容屬於特定工作區、使用者或提醒規則。
200 OK
{ "liveRooms": 55, "trackedRooms": 460, "boardsObserved24h": 244, "regions": ["VN"], "alertsDelivered24h": 820, "observedAt": "2026-11-04T04:04:36.242Z", "events": [ { "type": "live_start", "region": "VN", "at": "2026-11-04T04:02:02.941Z" }, { "type": "board_observed", "region": "VN", "board": "league_a1", "at": "2026-11-04T04:00:59.535Z" }, { "type": "rank_move", "handle": "creator.handle", "region": "VN", "board": "daily", "rank": 4, "previousRank": 12, "at": "2026-11-04T03:52:14.621Z" } ], "provenance": { "observedAt": "2026-11-04T04:04:36.242Z", "freshness": "near_realtime", "source": "platform_counters", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "pulse-v1", "window": { "from": "2026-11-03T04:04:36.242Z", "to": "2026-11-04T04:04:36.242Z", "label": "24h" } }}| 欄位 | 型別 | 意義 |
|---|---|---|
liveRooms | integer | RoomScope 正在記錄、且此刻正在直播的直播間。 |
trackedRooms | integer | 至少被一個工作區追蹤的不重複直播間數。 |
boardsObserved24h | integer | 過去 24 小時內觀測到的官方榜單，每個地區、榜單與期間只計算一次。 |
regions | string[] | 這些榜單的地區代碼，已排序。 |
alertsDelivered24h | integer | 過去 24 小時內送出的提醒通知。 |
observedAt | string | 此快照的計算時間（ISO 8601，UTC）。 |
events | object[] | 最多 10 筆最新的公開事件，由新到舊排序（見下文）。 |
provenance | object | 這些數字的來源、計算方法與 24 小時時間範圍，與 RoomScope 的所有指標相同。 |
事件
每個事件都有 type 與 at 時間。目前只有三種類型；日後若看到其他類型，請直接忽略。
| 類型 | 欄位 | 發生時機 |
|---|---|---|
board_observed | region, board, at | 某個公開榜單最新的完整快照（購物榜不公開）。 |
rank_move | handle, region, board, rank, previousRank, at | 公開榜單前 10 名開放名額中的某位創作者，名次較上一期上升。每個榜單最多 3 筆，依上升幅度由大到小排序。 |
live_start | region, at, handle? | 過去 7 天內曾進入某個公開榜單前 10 名開放名額的創作者開播了。 |
帳號名稱遵循展示間規則
只有公開展示間本來就會顯示的創作者才會出現帳號名稱：也就是公開榜單前 10 名的開放名額，且絕不包含已申請排除的創作者。當該創作者仍在直播時，
live_start 不會帶有 handle，與展示間隱藏直播中創作者的做法完全相同。資料新鮮度與快取
快照只計算一次，並在 60 秒內由所有呼叫者共用；回應會附上 Cache-Control: public, max-age=30。輪詢頻率超過每分鐘一次只會得到相同的數字。請使用 observedAt 來顯示這些數字的新舊程度。
限制與錯誤
呼叫次數以用戶端 IP 為單位限制：此端點每小時 300 次，同時受每分鐘 120 次的公開突發限制與全平台上限約束。超過限制時，回應為 429，並附上以秒為單位的 Retry-After。
429 Too Many Requests
HTTP/2 429Retry-After: 1260 { "code": "public_allowance_exhausted", "message": "You reached the public limit of 300 per hour…", "requestId": "…", "retryable": true }當公開介面被關閉或其快取無法連線時，回應為 503、錯誤碼 public_surface_unavailable 與 retryable: true。兩者都使用與 API 其他部分相同的錯誤格式。
這個頁面對你有幫助嗎？