RoomScope

Son güncelleme

LIVE

Kaydedilen LIVE oturumları, içerik üreticisi başına performans, LIVE video kaynağı ve son LIVE sohbeti.

Her işlemde kimlik doğrulama bir API anahtarıyla yapılır (Authorization: Bearer <key>) ve hatalar şu sayfada açıklanan ortak zarfı kullanır: Hatalar. API’nin OpenAPI belgesinden üretilmiştir.

Hediye gönderenleri listeleme

GET/v1/gifters

Son 7 veya 30 günde RoomScope’un kaydettiği LIVE odalarında hediye gönderenler, elmasa göre: hediye sayısı, oturumlar, hediye gönderilen içerik üreticileri, son odanın içerik üreticisi ve önceki dönemin elmasları. Her hediye gönderenin bir segmenti vardır: whale (7 günde en az 10.000 veya 30 günde en az 30.000 elmas), rising (en az 1.000 elmas ve önceki dönemin iki katı), regular (3 veya daha fazla oturum), one_time (tek oturum) ya da occasional. region yalnızca o bölgedeki içerik üreticilerine gönderilen hediyeleri tutar. Kapsam her zaman partial olur. Pro planı veya üzeri gerekir.

Kapsamgifter:readKredilerÖnbellekten okuma

Sorgu parametreleri

Sorgu parametreleri · GET /v1/gifters
NameTypeDescription
windowOptional
"7d" | "30d"7d veya 30d.
Default: 7d
segmentOptional
"whale" | "rising" | "regular" | "one_time" | "occasional"Yalnızca tek bir segment.
regionOptional
stringHediye gönderilen içerik üreticilerinin bölgesi (ör. VN).
limitOptional
integerMaksimum satır sayısı. Aralık …–500.
Default: 50

İstek

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

Yanıt

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"    }  }}

Hatalar

  • 400 Geçersiz parametre veya gövde; sorunu code belirtir.
  • 401 Eksik veya bilinmeyen API anahtarı.
  • 402 Çalışma alanının kredi cüzdanı çağrıyı karşılayamıyor; kredilerin ne zaman sıfırlanacağını resetAt belirtir.
  • 403 Anahtar gereken kapsama sahip değil ya da plan bu özelliği içermiyor.
  • 429 İstek hızı aşıldı (saniye, dakika veya gün başına); Retry-After değerine uyun.

Hediyeleri listeleme

GET/v1/gifts

RoomScope’un kaydettiği LIVE odalarında görülen TikTok hediyeleri; bir hediyenin jeton değeri, gönderildiği bölgeler ve ilk ile son görüldüğü zamanla birlikte. Bir hediye en az 3 bölgede görüldüyse isGlobal true olur. Görseller ve henüz kimsenin göndermediği hediyeler dahil edilmez, bu yüzden kapsam partial olur. Her gün senkronize edilir.

Kapsamlive:readKredilerÖnbellekten okuma

Sorgu parametreleri

Sorgu parametreleri · GET /v1/gifts
NameTypeDescription
qOptional
stringHediye adının bir kısmı.
minCoinsOptional
integerBir hediyenin en düşük jeton değeri.
maxCoinsOptional
integerBir hediyenin en yüksek jeton değeri.
regionOptional
stringYalnızca bu bölgede görülen hediyeler (ör. VN).
sortOptional
"coins" | "name" | "recent"coins (en çoktan aza), name veya recent.
Default: coins
limitOptional
integerMaksimum satır sayısı. Aralık …–500.
Default: 100

İstek

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

Yanıt

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  }}

Hatalar

  • 400 Geçersiz parametre veya gövde; sorunu code belirtir.
  • 401 Eksik veya bilinmeyen API anahtarı.
  • 402 Çalışma alanının kredi cüzdanı çağrıyı karşılayamıyor; kredilerin ne zaman sıfırlanacağını resetAt belirtir.
  • 403 Anahtar gereken kapsama sahip değil ya da plan bu özelliği içermiyor.
  • 429 İstek hızı aşıldı (saniye, dakika veya gün başına); Retry-After değerine uyun.

Bir içerik üreticisinin son LIVE sohbetini al

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

İçerik üreticisinin LIVE odasındaki en son sohbet yorumları, en eskisi önce, oynatıcının yanındaki bir sohbet paneli için. Birkaç saniyede bir sorgulayın ve yalnızca daha yeni yorumları almak için önceki yanıtın cursor değerini after olarak gönderin (yanıt başına en fazla 100; daha fazlası geldiyse en yeni 100). Yorumlar yalnızca RoomScope'un takip ettiği ve çalışma alanınızın takip ettiği odalar için vardır (watchlist veya oda aboneliği): roomId ile status: tracked, aksi halde öğesiz status: not_tracked (followed, çalışma alanınızın içerik üreticisini takip edip etmediğini söyler). RoomScope bir odanın son 200 yorumunu son yorumdan sonra 10 dakika saklar. Ücretsiz (kredi yok), kullanıcı başına dakikada 60 istekle sınırlı (aşılırsa Retry-After ile 429).

Kapsamlive:readKredilerÜcretsiz

Yol parametreleri

Yol parametreleri · GET /v1/live/creators/{uid}/comments
NameTypeDescription
uidRequired
stringİçerik üreticisinin kullanıcı adı (linh.live); baştaki @ yok sayılır.

Sorgu parametreleri

Sorgu parametreleri · GET /v1/live/creators/{uid}/comments
NameTypeDescription
afterOptional
stringÖnceki yanıtın cursor değeri: yalnızca daha yeni yorumlar.

İstek

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

Yanıt

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  }}

Hatalar

  • 400 Geçersiz parametre veya gövde; sorunu code belirtir.
  • 401 Eksik veya bilinmeyen API anahtarı.
  • 403 Anahtar gereken kapsama sahip değil ya da plan bu özelliği içermiyor.
  • 429 İstek hızı aşıldı (saniye, dakika veya gün başına); Retry-After değerine uyun.
  • 503 Geçici olarak kullanılamıyor; retryable true olduğunda Retry-After sonrasında yeniden deneyin.

Bir içerik üreticisinin LIVE performansını alma

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

Kaydedilen her oturum için bir satır: süre, zirve izleyici, hediyeler, elmaslar ve farklı hediye gönderen sayısı. Yalnızca çalışma alanının takip listesindeki bir yaratıcı veya üyelerinin takip ettiği bir oda için; aksi halde items boştur ve followed false'tur.

Kapsamlive:readKredilerÖnbellekten okuma

Yol parametreleri

Yol parametreleri · GET /v1/live/creators/{uid}/performance
NameTypeDescription
uidRequired
string@ olmadan içerik üreticisi kullanıcı adı (linh.live) veya sayısal TikTok kullanıcı kimliği.

Sorgu parametreleri

Sorgu parametreleri · GET /v1/live/creators/{uid}/performance
NameTypeDescription
cursorOptional
stringÖnceki sayfanın nextCursor değerinden alınan opak cursor.
limitOptional
integerSayfa başına satır sayısı. Aralık 1–100.
Default: 50

İstek

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

Yanıt

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  }}

Hatalar

  • 400 Geçersiz parametre veya gövde; sorunu code belirtir.
  • 401 Eksik veya bilinmeyen API anahtarı.
  • 402 Çalışma alanının kredi cüzdanı çağrıyı karşılayamıyor; kredilerin ne zaman sıfırlanacağını resetAt belirtir.
  • 403 Anahtar gereken kapsama sahip değil ya da plan bu özelliği içermiyor.
  • 429 İstek hızı aşıldı (saniye, dakika veya gün başına); Retry-After değerine uyun.

Bir içerik üreticisinin LIVE video kaynağını alma

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

İçerik üreticisinin mevcut LIVE odasının imzalı ve süresi dolan video URL’si. Oynatıcınız onu doğrudan TikTok’un CDN’inden yükler (source: tiktok-cdn); RoomScope videoyu asla proxy üzerinden aktarmaz. hlsUrl tercih edilir; flvUrl, yalnızca FLV sunan odaların kaynağıdır (mpegts.js gibi bir MSE motoruyla oynatın); status: live durumunda en az biri doludur ve expiresAt, o URL’nin çalışmayı bıraktığı zamandır. renditions çoğu zaman boştur. avatarUrl, followerCount ve region bilinmediğinde null olur. Diğer yanıtlar: status: offline (yayında değil), status: no_playback (yayında, ancak TikTok oynatılabilir bir kaynak sunmuyor), 202 status: resolving (Retry-After sonrasında aynı URL’yi yeniden yoklayın), 503 collection_saturated veya live_playback_upstream_unavailable (yeniden deneyin) ve özellik bu kurulumda kapalıyken 503 live_playback_not_configured (yeniden denemeyin). live:read değil, live:stream kapsamı gerekir.

Kapsamlive:streamKredilerÖnbellekten okuma

Yol parametreleri

Yol parametreleri · GET /v1/live/creators/{uid}/playback
NameTypeDescription
uidRequired
stringİçerik üreticisinin kullanıcı adı (linh.live); baştaki @ yok sayılır.

İstek

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

Yanıt

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}

Hatalar

  • 401 Eksik veya bilinmeyen API anahtarı.
  • 402 Çalışma alanının kredi cüzdanı çağrıyı karşılayamıyor; kredilerin ne zaman sıfırlanacağını resetAt belirtir.
  • 403 Anahtar gereken kapsama sahip değil ya da plan bu özelliği içermiyor.
  • 429 İstek hızı aşıldı (saniye, dakika veya gün başına); Retry-After değerine uyun.
  • 503 Geçici olarak kullanılamıyor; retryable true olduğunda Retry-After sonrasında yeniden deneyin.

Canlı durum yenilemesini kuyruğa alma

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

Worker’lardan içerik üreticisinin yayında olup olmadığını hemen kontrol etmelerini ister. Yenileme ücretiyle faturalandırılır.

Kapsamlive:readKredilerCanlı yenileme

Yol parametreleri

Yol parametreleri · POST /v1/live/creators/{uid}/refresh
NameTypeDescription
uidRequired
string@ olmadan içerik üreticisi kullanıcı adı (linh.live) veya sayısal TikTok kullanıcı kimliği.

İstek

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

Yanıt

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

Hatalar

  • 400 Geçersiz parametre veya gövde; sorunu code belirtir.
  • 401 Eksik veya bilinmeyen API anahtarı.
  • 402 Çalışma alanının kredi cüzdanı çağrıyı karşılayamıyor; kredilerin ne zaman sıfırlanacağını resetAt belirtir.
  • 403 Anahtar gereken kapsama sahip değil ya da plan bu özelliği içermiyor.
  • 429 İstek hızı aşıldı (saniye, dakika veya gün başına); Retry-After değerine uyun.

Kaydedilen LIVE oturumlarını listeleme

GET/v1/live/sessions

RoomScope'un çalışma alanının takip listesindeki yaratıcılar ve üyelerinin takip ettiği odalar için kaydettiği oturumlar, en yenisi önce; diğer çalışma alanlarının oturumları asla görünmez. Hâlâ süren bir oturumda endedAt: null olur.

Kapsamlive:readKredilerÖnbellekten okuma

Sorgu parametreleri

Sorgu parametreleri · GET /v1/live/sessions
NameTypeDescription
creatorUniqueIdOptional
stringYalnızca bu içerik üreticisinin oturumları (@ olmadan kullanıcı adı).
cursorOptional
stringÖnceki sayfanın nextCursor değerinden alınan opak cursor.
limitOptional
integerSayfa başına oturum sayısı. Aralık 1–100.
Default: 50

İstek

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

Yanıt

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  }}

Hatalar

  • 400 Geçersiz parametre veya gövde; sorunu code belirtir.
  • 401 Eksik veya bilinmeyen API anahtarı.
  • 402 Çalışma alanının kredi cüzdanı çağrıyı karşılayamıyor; kredilerin ne zaman sıfırlanacağını resetAt belirtir.
  • 403 Anahtar gereken kapsama sahip değil ya da plan bu özelliği içermiyor.
  • 429 İstek hızı aşıldı (saniye, dakika veya gün başına); Retry-After değerine uyun.

Bir LIVE oturumunu alma

GET/v1/live/sessions/{session_id}

Hediye ve hediye gönderen özetleriyle bir oturum. Çalışma alanının takip etmediği bir yaratıcının veya odanın oturumu 404 döndürür.

Kapsamlive:readKredilerÖnbellekten okuma

Yol parametreleri

Yol parametreleri · GET /v1/live/sessions/{session_id}
NameTypeDescription
session_idRequired
stringListedeki oturum kimliği.

İstek

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

Yanıt

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  }}

Hatalar

  • 400 Geçersiz parametre veya gövde; sorunu code belirtir.
  • 401 Eksik veya bilinmeyen API anahtarı.
  • 402 Çalışma alanının kredi cüzdanı çağrıyı karşılayamıyor; kredilerin ne zaman sıfırlanacağını resetAt belirtir.
  • 403 Anahtar gereken kapsama sahip değil ya da plan bu özelliği içermiyor.
  • 429 İstek hızı aşıldı (saniye, dakika veya gün başına); Retry-After değerine uyun.

Bir LIVE oturumunu dakika dakika al

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

Oturumun başlangıcından itibaren dakikalık serisi: dakika başına en yüksek izleyici, olay, sohbet, beğeni, hediye, elmas, yeni gifter ve sandık; başlangıçtan beri offsetMinutes ile. Yalnızca kaydedilen odalar; seri yokken kaydedilmiş bir oturumun dakikası yoktur (coverageStatus: not-covered). Görünürlük oturumun kendisiyle aynıdır.

Kapsamlive:readKredilerÖnbellekten okuma

Yol parametreleri

Yol parametreleri · GET /v1/live/sessions/{session_id}/timeline
NameTypeDescription
session_idRequired
stringListedeki oturum kimliği.

İstek

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

Yanıt

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  }}

Hatalar

  • 400 Geçersiz parametre veya gövde; sorunu code belirtir.
  • 401 Eksik veya bilinmeyen API anahtarı.
  • 402 Çalışma alanının kredi cüzdanı çağrıyı karşılayamıyor; kredilerin ne zaman sıfırlanacağını resetAt belirtir.
  • 403 Anahtar gereken kapsama sahip değil ya da plan bu özelliği içermiyor.
  • 429 İstek hızı aşıldı (saniye, dakika veya gün başına); Retry-After değerine uyun.

LIVE oturumlarını karşılaştır

GET/v1/live/sessions/compare

İki ila dört oturum yan yana; her biri toplamları ve kendi başlangıcından beri offsetMinutes ile hizalanmış dakikalarıyla. Çalışma alanının takip etmediği herhangi bir oturum 404 döner.

Kapsamlive:readKredilerÖnbellekten okuma

Sorgu parametreleri

Sorgu parametreleri · GET /v1/live/sessions/compare
NameTypeDescription
idsRequired
stringVirgülle ayrılmış oturum kimlikleri, 2 ila 4.

İstek

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

Yanıt

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  }}

Hatalar

  • 400 Geçersiz parametre veya gövde; sorunu code belirtir.
  • 401 Eksik veya bilinmeyen API anahtarı.
  • 402 Çalışma alanının kredi cüzdanı çağrıyı karşılayamıyor; kredilerin ne zaman sıfırlanacağını resetAt belirtir.
  • 403 Anahtar gereken kapsama sahip değil ya da plan bu özelliği içermiyor.
  • 429 İstek hızı aşıldı (saniye, dakika veya gün başına); Retry-After değerine uyun.
Bu sayfa işinize yaradı mı?