RoomScope

Cập nhật lần cuối

LIVE

Phiên LIVE đã ghi, hiệu suất theo creator, nguồn video LIVE và chat LIVE gần đây.

Mọi thao tác đều xác thực bằng API key (Authorization: Bearer <key>) và lỗi dùng chung envelope được mô tả trong Lỗi. Được tạo từ tài liệu OpenAPI của API.

Liệt kê người tặng quà

GET/v1/gifters

Những người tặng quà trong các phòng LIVE mà RoomScope đã ghi lại trong 7 hoặc 30 ngày qua, xếp theo kim cương: số quà, số phiên, số creator được tặng, creator của phòng gần nhất và số kim cương của khoảng thời gian trước đó. Mỗi người tặng quà thuộc một phân khúc: whale (ít nhất 10.000 kim cương trong 7 ngày hoặc 30.000 trong 30 ngày), rising (ít nhất 1.000 kim cương và gấp đôi khoảng trước), regular (từ 3 phiên trở lên), one_time (một phiên) hoặc occasional. region chỉ giữ quà tặng cho các creator thuộc khu vực đó. Độ phủ luôn là partial. Cần gói Pro trở lên.

Scopegifter:readCreditĐọc dữ liệu cache

Tham số query

Tham số query · GET /v1/gifters
NameTypeDescription
windowOptional
"7d" | "30d"7d hoặc 30d.
Default: 7d
segmentOptional
"whale" | "rising" | "regular" | "one_time" | "occasional"Chỉ một phân khúc.
regionOptional
stringKhu vực của các creator được tặng quà (ví dụ VN).
limitOptional
integerSố dòng tối đa. Khoảng giá trị …–500.
Default: 50

Request

curl "https://api.next.toktokdata.live/v1/gifters" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

Response

200 OK
{  "data": {    "window": "7d",    "region": "VN",    "segment": null,    "counts": {      "whale": 1,      "rising": 0,      "regular": 0,      "one_time": 0,      "occasional": 0,      "total": 1    },    "gifters": [      {        "gifterUserId": "6987001122334455667",        "gifterUniqueId": "minh.fan",        "gifterNickname": "Minh",        "avatarUrl": null,        "diamondTotal": 18450,        "previousDiamondTotal": 9200,        "giftCount": 312,        "sessions": 4,        "creatorsGifted": 2,        "lastGiftAt": "2026-11-02T15:41:07.512Z",        "lastRoomCreator": "linh.live",        "segment": "whale"      }    ]  },  "provenance": {    "observedAt": "2026-11-02T15:41:07.512Z",    "freshness": "historical",    "source": "platform_observed_gifter_events",    "sourceKind": "derived",    "coverageStatus": "partial",    "methodologyVersion": "gifters-observed-v1",    "window": {      "from": "2026-10-27T04:00:00.000Z",      "to": "2026-11-03T04:00:00.000Z",      "label": "7d"    }  }}

Lỗi

  • 400 Tham số hoặc body không hợp lệ; code cho biết vấn đề.
  • 401 API key bị thiếu hoặc không xác định.
  • 402 Ví credit của workspace không đủ cho lệnh gọi; resetAt cho biết khi nào credit được reset.
  • 403 Key thiếu scope, hoặc gói không bao gồm tính năng này.
  • 429 Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theo Retry-After.

Liệt kê quà tặng

GET/v1/gifts

Các quà tặng TikTok đã thấy trong những phòng LIVE mà RoomScope ghi lại, kèm số xu của một quà, các khu vực nơi quà được tặng và thời điểm thấy lần đầu và lần cuối. isGlobal là true khi một quà đã được thấy ở ít nhất 3 khu vực. Không bao gồm hình ảnh và những quà chưa ai tặng, nên độ phủ là partial. Đồng bộ mỗi ngày.

Scopelive:readCreditĐọc dữ liệu cache

Tham số query

Tham số query · GET /v1/gifts
NameTypeDescription
qOptional
stringMột phần tên quà.
minCoinsOptional
integerSố xu tối thiểu của một quà.
maxCoinsOptional
integerSố xu tối đa của một quà.
regionOptional
stringChỉ những quà đã thấy ở khu vực này (ví dụ VN).
sortOptional
"coins" | "name" | "recent"coins (nhiều nhất trước), name hoặc recent.
Default: coins
limitOptional
integerSố dòng tối đa. Khoảng giá trị …–500.
Default: 100

Request

curl "https://api.next.toktokdata.live/v1/gifts" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

Response

200 OK
{  "data": {    "gifts": [      {        "giftId": "5655",        "name": "Rose",        "coins": 1,        "imageUrl": null,        "isGlobal": false,        "regions": [          "VN"        ],        "firstSeenAt": "2026-11-01T02:14:09.000Z",        "lastSeenAt": "2026-11-07T08:41:52.000Z"      }    ],    "total": 1  },  "provenance": {    "observedAt": "2026-11-07T03:10:00.000Z",    "freshness": "near_realtime",    "source": "platform_observed_live_stream",    "sourceKind": "derived",    "coverageStatus": "partial",    "methodologyVersion": "gift-catalog-observed-v1",    "window": null  }}

Lỗi

  • 400 Tham số hoặc body không hợp lệ; code cho biết vấn đề.
  • 401 API key bị thiếu hoặc không xác định.
  • 402 Ví credit của workspace không đủ cho lệnh gọi; resetAt cho biết khi nào credit được reset.
  • 403 Key thiếu scope, hoặc gói không bao gồm tính năng này.
  • 429 Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theo Retry-After.

Lấy chat LIVE gần đây của một creator

GET/v1/live/creators/{uid}/comments

Các bình luận chat mới nhất trong phòng LIVE của creator, cũ nhất trước, cho khung chat cạnh trình phát. Gọi lại vài giây một lần và truyền cursor của lần trả lời trước vào after để chỉ nhận bình luận mới hơn (tối đa 100 mỗi lần; nếu có nhiều hơn thì là 100 bình luận mới nhất). Chỉ có bình luận cho các phòng RoomScope theo dõi và workspace của bạn theo dõi (watchlist hoặc đăng ký phòng): status: tracked kèm roomId, nếu không thì status: not_tracked và không có mục nào (followed cho biết workspace có theo dõi creator không). RoomScope giữ 200 bình luận cuối của một phòng trong 10 phút sau bình luận cuối cùng. Miễn phí (không tốn credit), giới hạn 60 yêu cầu mỗi phút cho mỗi người dùng (vượt quá trả 429 kèm Retry-After).

Scopelive:readCreditMiễn phí

Tham số path

Tham số path · GET /v1/live/creators/{uid}/comments
NameTypeDescription
uidRequired
stringHandle của creator (linh.live); ký tự @ ở đầu sẽ bị bỏ qua.

Tham số query

Tham số query · GET /v1/live/creators/{uid}/comments
NameTypeDescription
afterOptional
stringcursor của lần trả lời trước: chỉ bình luận mới hơn.

Request

curl "https://api.next.toktokdata.live/v1/live/creators/linh.live/comments" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

Response

200 OK
{  "status": "tracked",  "followed": true,  "roomId": "7665709659185105682",  "items": [    {      "id": "7568123456789012345",      "createdAt": "2026-11-06T13:05:41.512Z",      "comment": "hello from Hanoi!",      "user": {        "uniqueId": "minh.fan",        "nickname": "Minh",        "avatarUrl": "https://p16-sign-sg.tiktokcdn.com/avatar-minh.jpeg"      }    },    {      "id": "7568123456789012399",      "createdAt": "2026-11-06T13:05:43.208Z",      "comment": "sing the last song again please",      "user": {        "uniqueId": "an.nguyen",        "nickname": "An",        "avatarUrl": null      }    }  ],  "cursor": "1793970343251-0",  "provenance": {    "observedAt": "2026-11-06T13:05:43.251Z",    "freshness": "near_realtime",    "source": "platform_observed_live_stream",    "sourceKind": "derived",    "coverageStatus": "partial",    "methodologyVersion": "live-history-v1",    "window": null  }}

Lỗi

  • 400 Tham số hoặc body không hợp lệ; code cho biết vấn đề.
  • 401 API key bị thiếu hoặc không xác định.
  • 403 Key thiếu scope, hoặc gói không bao gồm tính năng này.
  • 429 Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theo Retry-After.
  • 503 Tạm thời không khả dụng; thử lại sau Retry-After khi retryable là true.

Lấy hiệu suất LIVE của creator

GET/v1/live/creators/{uid}/performance

Mỗi phiên đã ghi một dòng: thời lượng, người xem đỉnh, quà, kim cương và số người tặng quà khác nhau. Chỉ cho creator trong danh sách theo dõi của workspace hoặc phòng mà thành viên theo dõi; nếu không, items rỗng và followed là false.

Scopelive:readCreditĐọc dữ liệu cache

Tham số path

Tham số path · GET /v1/live/creators/{uid}/performance
NameTypeDescription
uidRequired
stringHandle của creator không kèm @ (linh.live) hoặc user id TikTok dạng số.

Tham số query

Tham số query · GET /v1/live/creators/{uid}/performance
NameTypeDescription
cursorOptional
stringCursor mờ lấy từ nextCursor của trang trước.
limitOptional
integerSố dòng mỗi trang. Khoảng giá trị 1–100.
Default: 50

Request

curl "https://api.next.toktokdata.live/v1/live/creators/linh.live/performance" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

Response

200 OK
{  "data": {    "items": [      {        "sessionId": "f18eaa3e-a762-543d-9ea5-178271dc43f9",        "sessionStartedAt": "2026-11-01T07:51:44.935Z",        "creatorUniqueId": "linh.live",        "roomKey": "room:linh.live",        "durationSeconds": 7200,        "peakViewerCount": 2000,        "eventCount": 1000,        "chatCount": 600,        "giftCount": 80,        "totalGiftDiamonds": 5000,        "distinctGifterCount": 2      },      {        "sessionId": "278f3a86-af07-5768-85d2-6dfff8efee7d",        "sessionStartedAt": "2026-10-31T07:51:44.935Z",        "creatorUniqueId": "linh.live",        "roomKey": "room:linh.live",        "durationSeconds": 7200,        "peakViewerCount": 1000,        "eventCount": 500,        "chatCount": 300,        "giftCount": 40,        "totalGiftDiamonds": 2500,        "distinctGifterCount": 2      }    ],    "nextCursor": null,    "historyWindowDays": 365,    "historyTruncated": false,    "followed": true  },  "provenance": {    "observedAt": "2026-11-01T07:51:44.935Z",    "freshness": "historical",    "source": "platform_observed_live_stream",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "live-history-v1",    "window": null  }}

Lỗi

  • 400 Tham số hoặc body không hợp lệ; code cho biết vấn đề.
  • 401 API key bị thiếu hoặc không xác định.
  • 402 Ví credit của workspace không đủ cho lệnh gọi; resetAt cho biết khi nào credit được reset.
  • 403 Key thiếu scope, hoặc gói không bao gồm tính năng này.
  • 429 Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theo Retry-After.

Lấy nguồn video LIVE của creator

GET/v1/live/creators/{uid}/playback

URL video có chữ ký, có thời hạn của phòng LIVE hiện tại của creator. Trình phát của bạn tải trực tiếp từ CDN của TikTok (source: tiktok-cdn); RoomScope không bao giờ proxy video. Ưu tiên hlsUrl; flvUrl là nguồn của các phòng chỉ có FLV (phát bằng một engine MSE như mpegts.js); ít nhất một trong hai có giá trị khi status: live, và expiresAt là thời điểm URL đó hết hiệu lực. renditions thường trống. avatarUrl, followerCount và region là null khi chưa biết. Các câu trả lời khác: status: offline (không live), status: no_playback (đang live nhưng TikTok không cung cấp nguồn phát được), 202 status: resolving (gọi lại cùng URL sau Retry-After), 503 collection_saturated hoặc live_playback_upstream_unavailable (thử lại), và 503 live_playback_not_configured khi tính năng đang tắt trên bản triển khai này (không thử lại). Cần scope live:stream, không phải live:read.

Scopelive:streamCreditĐọc dữ liệu cache

Tham số path

Tham số path · GET /v1/live/creators/{uid}/playback
NameTypeDescription
uidRequired
stringHandle của creator (linh.live); ký tự @ ở đầu sẽ bị bỏ qua.

Request

curl "https://api.next.toktokdata.live/v1/live/creators/linh.live/playback" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

Response

200 OK
{  "status": "live",  "roomId": "7665709659185105682",  "title": "Friday night karaoke",  "nickname": "Linh",  "hlsUrl": "https://pull-hls-l1-sg01.tiktokcdn.com/stage/stream-7665709727191485202_hd/index.m3u8?expire=1786024940&sign=ea92cabbf90993d50a0e3d50ee9ed526",  "flvUrl": "https://pull-flv-l1-sg01.tiktokcdn.com/stage/stream-7665709727191485202_hd.flv?expire=1786024940&sign=ea92cabbf90993d50a0e3d50ee9ed526",  "expiresAt": "2026-08-06T14:02:20.000Z",  "startedAt": "2026-07-23T09:46:40.000Z",  "renditions": [],  "avatarUrl": "https://p16-sign-sg.tiktokcdn.com/avatar.jpeg",  "verified": true,  "followerCount": 894314,  "region": "VN",  "source": "tiktok-cdn",  "cached": false}

Lỗi

  • 401 API key bị thiếu hoặc không xác định.
  • 402 Ví credit của workspace không đủ cho lệnh gọi; resetAt cho biết khi nào credit được reset.
  • 403 Key thiếu scope, hoặc gói không bao gồm tính năng này.
  • 429 Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theo Retry-After.
  • 503 Tạm thời không khả dụng; thử lại sau Retry-After khi retryable là true.

Xếp hàng làm mới trạng thái live

POST/v1/live/creators/{uid}/refresh

Yêu cầu worker kiểm tra ngay xem creator có đang live không. Tính phí theo mức làm mới.

Scopelive:readCreditLàm mới trạng thái live

Tham số path

Tham số path · POST /v1/live/creators/{uid}/refresh
NameTypeDescription
uidRequired
stringHandle của creator không kèm @ (linh.live) hoặc user id TikTok dạng số.

Request

curl -X POST "https://api.next.toktokdata.live/v1/live/creators/linh.live/refresh" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

Response

202 Accepted
{  "queued": true,  "jobId": "1761994604935-0"}

Lỗi

  • 400 Tham số hoặc body không hợp lệ; code cho biết vấn đề.
  • 401 API key bị thiếu hoặc không xác định.
  • 402 Ví credit của workspace không đủ cho lệnh gọi; resetAt cho biết khi nào credit được reset.
  • 403 Key thiếu scope, hoặc gói không bao gồm tính năng này.
  • 429 Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theo Retry-After.

Liệt kê các phiên LIVE đã ghi

GET/v1/live/sessions

Các phiên RoomScope đã ghi cho creator trong danh sách theo dõi của workspace và các phòng mà thành viên theo dõi, mới nhất trước; phiên của workspace khác không bao giờ xuất hiện. Phiên vẫn đang chạy có endedAt: null.

Scopelive:readCreditĐọc dữ liệu cache

Tham số query

Tham số query · GET /v1/live/sessions
NameTypeDescription
creatorUniqueIdOptional
stringChỉ các phiên của creator này (handle không kèm @).
cursorOptional
stringCursor mờ lấy từ nextCursor của trang trước.
limitOptional
integerSố phiên mỗi trang. Khoảng giá trị 1–100.
Default: 50

Request

curl "https://api.next.toktokdata.live/v1/live/sessions" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

Response

200 OK
{  "data": {    "items": [      {        "id": "f18eaa3e-a762-543d-9ea5-178271dc43f9",        "roomKey": "room:linh.live",        "roomId": "7990000000000000001",        "creatorUniqueId": "linh.live",        "creatorAvatarUrl": null,        "startedAt": "2026-11-01T07:51:44.935Z",        "endedAt": "2026-11-01T09:51:44.935Z",        "peakViewerCount": 2000,        "eventCount": 1000,        "chatCount": 600,        "giftCount": 80,        "totalGiftDiamonds": 5000,        "durationSeconds": 7200      },      {        "id": "278f3a86-af07-5768-85d2-6dfff8efee7d",        "roomKey": "room:linh.live",        "roomId": "7990000000000000001",        "creatorUniqueId": "linh.live",        "creatorAvatarUrl": null,        "startedAt": "2026-10-31T07:51:44.935Z",        "endedAt": "2026-10-31T09:51:44.935Z",        "peakViewerCount": 1000,        "eventCount": 500,        "chatCount": 300,        "giftCount": 40,        "totalGiftDiamonds": 2500,        "durationSeconds": 7200      }    ],    "nextCursor": null,    "historyWindowDays": 365,    "historyTruncated": false  },  "provenance": {    "observedAt": "2026-11-01T09:51:44.935Z",    "freshness": "historical",    "source": "platform_observed_live_stream",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "live-history-v1",    "window": null  }}

Lỗi

  • 400 Tham số hoặc body không hợp lệ; code cho biết vấn đề.
  • 401 API key bị thiếu hoặc không xác định.
  • 402 Ví credit của workspace không đủ cho lệnh gọi; resetAt cho biết khi nào credit được reset.
  • 403 Key thiếu scope, hoặc gói không bao gồm tính năng này.
  • 429 Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theo Retry-After.

Lấy một phiên LIVE

GET/v1/live/sessions/{session_id}

Một phiên kèm tổng hợp quà và người tặng quà. Phiên của creator hoặc phòng mà workspace không theo dõi trả về 404.

Scopelive:readCreditĐọc dữ liệu cache

Tham số path

Tham số path · GET /v1/live/sessions/{session_id}
NameTypeDescription
session_idRequired
stringSession id lấy từ danh sách.

Request

curl "https://api.next.toktokdata.live/v1/live/sessions/f18eaa3e-a762-543d-9ea5-178271dc43f9" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

Response

200 OK
{  "data": {    "id": "278f3a86-af07-5768-85d2-6dfff8efee7d",    "roomKey": "room:linh.live",    "roomId": "7990000000000000001",    "creatorUniqueId": "linh.live",    "creatorAvatarUrl": null,    "startedAt": "2026-10-31T07:51:44.935Z",    "endedAt": "2026-10-31T09:51:44.935Z",    "peakViewerCount": 1000,    "eventCount": 500,    "chatCount": 300,    "giftCount": 40,    "totalGiftDiamonds": 2500,    "durationSeconds": 7200,    "giftRollups": [      {        "giftId": "5269",        "giftName": "TikTok",        "giftType": 1,        "giftCount": 10,        "diamondTotal": 2470,        "senderCount": 2      },      {        "giftId": "5655",        "giftName": "Rose",        "giftType": 1,        "giftCount": 30,        "diamondTotal": 30,        "senderCount": 2      }    ],    "gifterRollups": [      {        "gifterUserId": "991000000000000001",        "gifterUniqueId": "gifter.1",        "gifterNickname": "Gifter 1",        "giftCount": 20,        "diamondTotal": 1500      },      {        "gifterUserId": "991000000000000002",        "gifterUniqueId": "gifter.2",        "gifterNickname": "Gifter 2",        "giftCount": 20,        "diamondTotal": 1000      }    ]  },  "provenance": {    "observedAt": "2026-10-31T09:51:44.935Z",    "freshness": "stale",    "source": "platform_observed_live_stream",    "sourceKind": "derived",    "coverageStatus": "stale",    "methodologyVersion": "live-history-v1",    "window": null  }}

Lỗi

  • 400 Tham số hoặc body không hợp lệ; code cho biết vấn đề.
  • 401 API key bị thiếu hoặc không xác định.
  • 402 Ví credit của workspace không đủ cho lệnh gọi; resetAt cho biết khi nào credit được reset.
  • 403 Key thiếu scope, hoặc gói không bao gồm tính năng này.
  • 429 Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theo Retry-After.

Lấy phiên LIVE theo từng phút

GET/v1/live/sessions/{session_id}/timeline

Chuỗi số liệu theo phút của phiên từ lúc bắt đầu: người xem cao nhất, sự kiện, chat, lượt thích, quà, kim cương, gifter mới và rương kim cương mỗi phút, kèm offsetMinutes tính từ lúc bắt đầu. Chỉ phòng đã ghi; phiên ghi trước khi có chuỗi này không có phút nào (coverageStatus: not-covered). Phạm vi hiển thị giống chính phiên đó.

Scopelive:readCreditĐọc dữ liệu cache

Tham số path

Tham số path · GET /v1/live/sessions/{session_id}/timeline
NameTypeDescription
session_idRequired
stringSession id lấy từ danh sách.

Request

curl "https://api.next.toktokdata.live/v1/live/sessions/f18eaa3e-a762-543d-9ea5-178271dc43f9/timeline" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

Response

200 OK
{  "data": {    "sessionId": "5b9f0c2e-7a51-5d3c-9b0e-1f2a3c4d5e6f",    "creatorUniqueId": "linh.live",    "startedAt": "2026-11-06T12:00:04.211Z",    "endedAt": "2026-11-06T14:00:12.903Z",    "durationSeconds": 7208,    "peakViewerCount": 1240,    "totalGiftDiamonds": 18450,    "minutes": [      {        "minuteAt": "2026-11-06T12:00:00.000Z",        "offsetMinutes": 0,        "viewersMax": 800,        "events": 120,        "chats": 60,        "likes": 300,        "gifts": 4,        "diamonds": 40,        "newGifters": 1,        "envelopes": 0      },      {        "minuteAt": "2026-11-06T12:01:00.000Z",        "offsetMinutes": 1,        "viewersMax": 840,        "events": 130,        "chats": 65,        "likes": 320,        "gifts": 5,        "diamonds": 55,        "newGifters": 2,        "envelopes": 0      },      {        "minuteAt": "2026-11-06T12:02:00.000Z",        "offsetMinutes": 2,        "viewersMax": 880,        "events": 140,        "chats": 70,        "likes": 340,        "gifts": 6,        "diamonds": 70,        "newGifters": 1,        "envelopes": 1      }    ]  },  "provenance": {    "observedAt": "2026-10-31T09:51:44.935Z",    "freshness": "stale",    "source": "platform_observed_live_stream",    "sourceKind": "derived",    "coverageStatus": "stale",    "methodologyVersion": "live-history-v1",    "window": null  }}

Lỗi

  • 400 Tham số hoặc body không hợp lệ; code cho biết vấn đề.
  • 401 API key bị thiếu hoặc không xác định.
  • 402 Ví credit của workspace không đủ cho lệnh gọi; resetAt cho biết khi nào credit được reset.
  • 403 Key thiếu scope, hoặc gói không bao gồm tính năng này.
  • 429 Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theo Retry-After.

So sánh các phiên LIVE

GET/v1/live/sessions/compare

Hai đến bốn phiên đặt cạnh nhau, mỗi phiên có tổng và các phút căn theo offsetMinutes tính từ lúc nó bắt đầu. Phiên nào workspace không theo dõi sẽ trả 404.

Scopelive:readCreditĐọc dữ liệu cache

Tham số query

Tham số query · GET /v1/live/sessions/compare
NameTypeDescription
idsRequired
stringDanh sách id phiên ngăn cách bằng dấu phẩy, từ 2 đến 4.

Request

curl "https://api.next.toktokdata.live/v1/live/sessions/compare?ids=value" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

Response

200 OK
{  "data": {    "sessions": [      {        "sessionId": "5b9f0c2e-7a51-5d3c-9b0e-1f2a3c4d5e6f",        "creatorUniqueId": "linh.live",        "startedAt": "2026-11-06T12:00:04.211Z",        "endedAt": "2026-11-06T14:00:12.903Z",        "durationSeconds": 7208,        "peakViewerCount": 1240,        "totalGiftDiamonds": 18450,        "minutes": [          {            "minuteAt": "2026-11-06T12:00:00.000Z",            "offsetMinutes": 0,            "viewersMax": 800,            "events": 120,            "chats": 60,            "likes": 300,            "gifts": 4,            "diamonds": 40,            "newGifters": 1,            "envelopes": 0          },          {            "minuteAt": "2026-11-06T12:01:00.000Z",            "offsetMinutes": 1,            "viewersMax": 840,            "events": 130,            "chats": 65,            "likes": 320,            "gifts": 5,            "diamonds": 55,            "newGifters": 2,            "envelopes": 0          },          {            "minuteAt": "2026-11-06T12:02:00.000Z",            "offsetMinutes": 2,            "viewersMax": 880,            "events": 140,            "chats": 70,            "likes": 340,            "gifts": 6,            "diamonds": 70,            "newGifters": 1,            "envelopes": 1          }        ]      },      {        "sessionId": "8c1d2e3f-4a5b-5c6d-8e7f-9a0b1c2d3e4f",        "creatorUniqueId": "linh.live",        "startedAt": "2026-11-05T12:01:10.000Z",        "endedAt": "2026-11-05T13:30:40.000Z",        "durationSeconds": 5370,        "peakViewerCount": 980,        "totalGiftDiamonds": 9200,        "minutes": [          {            "minuteAt": "2026-11-06T12:00:00.000Z",            "offsetMinutes": 0,            "viewersMax": 800,            "events": 120,            "chats": 60,            "likes": 300,            "gifts": 4,            "diamonds": 80,            "newGifters": 1,            "envelopes": 0          },          {            "minuteAt": "2026-11-06T12:01:00.000Z",            "offsetMinutes": 1,            "viewersMax": 880,            "events": 130,            "chats": 65,            "likes": 320,            "gifts": 5,            "diamonds": 110,            "newGifters": 2,            "envelopes": 0          }        ]      }    ]  },  "provenance": {    "observedAt": "2026-10-31T09:51:44.935Z",    "freshness": "stale",    "source": "platform_observed_live_stream",    "sourceKind": "derived",    "coverageStatus": "stale",    "methodologyVersion": "live-history-v1",    "window": null  }}

Lỗi

  • 400 Tham số hoặc body không hợp lệ; code cho biết vấn đề.
  • 401 API key bị thiếu hoặc không xác định.
  • 402 Ví credit của workspace không đủ cho lệnh gọi; resetAt cho biết khi nào credit được reset.
  • 403 Key thiếu scope, hoặc gói không bao gồm tính năng này.
  • 429 Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theo Retry-After.
Trang này có hữu ích không?