RoomScope

อัปเดตล่าสุด

วิดีโอ

วิดีโอและความคิดเห็นของครีเอเตอร์ที่จัดเก็บไว้

ทุกการดำเนินการยืนยันตัวตนด้วย API key (Authorization: Bearer <key>) และข้อผิดพลาดใช้โครงสร้างร่วมที่อธิบายไว้ใน ข้อผิดพลาด. สร้างจากเอกสาร OpenAPI ของ API

แสดงรายการวิดีโอของครีเอเตอร์

GET/v1/creators/{uid}/videos

วิดีโอที่จัดเก็บไว้ของครีเอเตอร์ เรียงจากใหม่ไปเก่า พร้อมยอดเล่น ยอดถูกใจ และจำนวนความคิดเห็น

สโคปcontent:readเครดิตอ่านข้อมูลแคช

พารามิเตอร์ใน path

พารามิเตอร์ใน path · GET /v1/creators/{uid}/videos
NameTypeDescription
uidRequired
stringแฮนเดิลของครีเอเตอร์โดยไม่มี @ (linh.live) หรือ user id ของ TikTok ที่เป็นตัวเลข

คำขอ

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 พารามิเตอร์หรือ body ไม่ถูกต้อง code จะระบุปัญหา
  • 401 ไม่มี API key หรือไม่รู้จัก API key
  • 402 กระเป๋าเครดิตของเวิร์กสเปซมีไม่พอสำหรับการเรียกนี้ resetAt บอกเวลาที่เครดิตจะรีเซ็ต
  • 403 คีย์ไม่มีสโคปที่ต้องการ หรือแพ็กเกจไม่รวมฟีเจอร์นี้
  • 429 เกินอัตราคำขอ ให้ปฏิบัติตาม Retry-After

ดึงวิดีโอ

GET/v1/videos/{video_id}

วิดีโอที่จัดเก็บไว้หนึ่งรายการพร้อมตัวนับ

สโคปcontent:readเครดิตอ่านข้อมูลแคช

พารามิเตอร์ใน path

พารามิเตอร์ใน path · GET /v1/videos/{video_id}
NameTypeDescription
video_idRequired
stringvideo id ของ TikTok

คำขอ

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 พารามิเตอร์หรือ body ไม่ถูกต้อง code จะระบุปัญหา
  • 401 ไม่มี API key หรือไม่รู้จัก API key
  • 402 กระเป๋าเครดิตของเวิร์กสเปซมีไม่พอสำหรับการเรียกนี้ resetAt บอกเวลาที่เครดิตจะรีเซ็ต
  • 403 คีย์ไม่มีสโคปที่ต้องการ หรือแพ็กเกจไม่รวมฟีเจอร์นี้
  • 429 เกินอัตราคำขอ ให้ปฏิบัติตาม Retry-After

แสดงรายการความคิดเห็นของวิดีโอ

GET/v1/videos/{video_id}/comments

ความคิดเห็นที่จัดเก็บไว้ ส่ง parentCommentId เพื่อดูการตอบกลับของความคิดเห็นหนึ่ง

สโคปcontent:readเครดิตอ่านข้อมูลแคช

พารามิเตอร์ใน path

พารามิเตอร์ใน path · GET /v1/videos/{video_id}/comments
NameTypeDescription
video_idRequired
stringvideo id ของ TikTok

พารามิเตอร์ query

พารามิเตอร์ query · GET /v1/videos/{video_id}/comments
NameTypeDescription
parentCommentIdOptional
stringส่งคืนการตอบกลับของความคิดเห็นนี้
cursorOptional
stringcursor แบบทึบจาก 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 พารามิเตอร์หรือ body ไม่ถูกต้อง code จะระบุปัญหา
  • 401 ไม่มี API key หรือไม่รู้จัก API key
  • 402 กระเป๋าเครดิตของเวิร์กสเปซมีไม่พอสำหรับการเรียกนี้ resetAt บอกเวลาที่เครดิตจะรีเซ็ต
  • 403 คีย์ไม่มีสโคปที่ต้องการ หรือแพ็กเกจไม่รวมฟีเจอร์นี้
  • 429 เกินอัตราคำขอ ให้ปฏิบัติตาม Retry-After
หน้านี้มีประโยชน์หรือไม่