最後更新
影片
已儲存創作者的影片與留言。
所有操作都以 API 金鑰進行身分驗證 (Authorization: Bearer <key>) ；錯誤一律使用共通的錯誤格式，說明請見 錯誤. 本頁由 API 的 OpenAPI 文件產生。
列出創作者的影片
GET
/v1/creators/{uid}/videos為該創作者儲存的影片，由新到舊排列，附播放數、按讚數與留言數。
權限範圍content:read點數快取讀取
路徑參數
| Name | Type | Description |
|---|---|---|
uidRequired | string | 不含 @ 的創作者帳號名稱（linh.live）或數字形式的 TikTok 使用者 ID。 |
請求
curl "https://api.toktokdata.live/v1/creators/linh.live/videos" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"回應
200 OK
{ "data": { "uniqueId": "linh.live", "tiktokUserId": "990000000000000001", "videos": [ { "videoId": "7990000000000000001", "tiktokUserId": "990000000000000001", "uniqueId": "linh.live", "description": "Video 1", "createTime": "2026-10-31T10:51:44.935Z", "coverUrl": null, "durationSeconds": null, "playCount": 10000, "diggCount": 1000, "commentCount": 100, "shareCount": null, "collectCount": null, "firstSeenAt": "2026-11-01T10:51:45.590Z", "lastRefreshedAt": "2026-11-01T10:36:44.935Z" }, { "videoId": "7990000000000000002", "tiktokUserId": "990000000000000001", "uniqueId": "linh.live", "description": "Video 2", "createTime": "2026-10-30T10:51:44.935Z", "coverUrl": null, "durationSeconds": null, "playCount": 20000, "diggCount": 2000, "commentCount": 200, "shareCount": null, "collectCount": null, "firstSeenAt": "2026-11-01T10:51:45.591Z", "lastRefreshedAt": "2026-11-01T10:36:44.935Z" } ] }, "provenance": { "observedAt": "2026-11-01T10:36:44.935Z", "freshness": "near_realtime", "source": "public_creator_content", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "content-v1", "window": null }}錯誤
400參數或請求主體無效；code會指出問題所在。401API 金鑰缺少或不存在。402工作區的點數錢包不足以支付此呼叫；resetAt表示點數重置的時間。403金鑰缺少該權限範圍，或方案未包含此功能。429超過請求速率；請遵守Retry-After。
取得影片
GET
/v1/videos/{video_id}單一已儲存的影片及其各項計數。
權限範圍content:read點數快取讀取
路徑參數
| Name | Type | Description |
|---|---|---|
video_idRequired | string | TikTok 影片 ID。 |
請求
curl "https://api.toktokdata.live/v1/videos/7400000000000000001" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"回應
200 OK
{ "data": { "video": { "videoId": "7990000000000000001", "tiktokUserId": "990000000000000001", "uniqueId": "linh.live", "description": "Video 1", "createTime": "2026-10-31T10:51:44.935Z", "coverUrl": null, "durationSeconds": null, "playCount": 10000, "diggCount": 1000, "commentCount": 100, "shareCount": null, "collectCount": null, "firstSeenAt": "2026-11-01T10:51:45.590Z", "lastRefreshedAt": "2026-11-01T10:36:44.935Z", "history": [] } }, "provenance": { "observedAt": "2026-11-01T10:36:44.935Z", "freshness": "near_realtime", "source": "public_creator_content", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "content-v1", "window": null }}錯誤
400參數或請求主體無效；code會指出問題所在。401API 金鑰缺少或不存在。402工作區的點數錢包不足以支付此呼叫；resetAt表示點數重置的時間。403金鑰缺少該權限範圍，或方案未包含此功能。429超過請求速率；請遵守Retry-After。
列出影片的留言
GET
/v1/videos/{video_id}/comments已儲存的留言；傳入 parentCommentId 可取得某則留言的回覆。
權限範圍content:read點數快取讀取
路徑參數
| Name | Type | Description |
|---|---|---|
video_idRequired | string | TikTok 影片 ID。 |
查詢參數
| Name | Type | Description |
|---|---|---|
parentCommentIdOptional | string | 回傳此留言的回覆。 |
cursorOptional | string | 來自上一頁 nextCursor 的不透明游標。 |
limitOptional | integer | 每頁留言數。 |
請求
curl "https://api.toktokdata.live/v1/videos/7400000000000000001/comments" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"回應
200 OK
{ "data": { "videoId": "7400000000000000001", "parentCommentId": null, "comments": [ { "commentId": "7400000000000100001", "text": "See you at 9pm!", "diggCount": 42, "replyCount": 3, "createTime": "2026-10-31T13:05:00Z", "authorUniqueId": "fan.one" } ], "nextCursor": null, "hasMore": false }, "provenance": { "observedAt": "2026-11-01T10:36:44.935Z", "freshness": "near_realtime", "source": "public_video_comments", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "comments-v1", "window": null }}錯誤
400參數或請求主體無效；code會指出問題所在。401API 金鑰缺少或不存在。402工作區的點數錢包不足以支付此呼叫；resetAt表示點數重置的時間。403金鑰缺少該權限範圍，或方案未包含此功能。429超過請求速率；請遵守Retry-After。
這個頁面對你有幫助嗎？