Son güncelleme
Sıralamalar
Sıralama, bölge ve dönem bazında resmî sıralama tabloları.
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.
Bir sıralamanın günlük barajını alma
/v1/rankings/day-barsSon days gündeki her sıralama günü için: sıralamada kaç içerik üreticisinin yer aldığı, sıralamadaki en düşük puan (sıralamaya girme barajı) ve en yüksek puan; bunlar RoomScope'un günlük sıfırlamadan önce gözlemlediği son tam sıralamadan okunur. Ayrıca o gün kaç tam sıralama okunduğu. daily ve lig sıralamaları (league_a1 ile league_d5 arası).
Sorgu parametreleri
| Name | Type | Description |
|---|---|---|
regionOptional | string | Bölge kodu. Default: VN |
boardOptional | string | daily veya bir lig sıralaması.Default: daily |
daysOptional | integer | Geriye doğru gün sayısı. Aralık …–90. Default: 30 |
İstek
curl "https://api.next.toktokdata.live/v1/rankings/day-bars" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"Yanıt
{ "data": { "region": "VN", "board": "daily", "days": [ { "boardDay": "2026-11-06", "dayEnd": "2026-11-06T17:00:00.000Z", "leagueClass": null, "entryCount": 99, "minScore": 23150, "maxScore": 880338, "boardCount": 12 } ] }, "provenance": { "observedAt": "2026-11-07T09:00:00.000Z", "freshness": "near_realtime", "source": "tiktok_observed_rank_board", "sourceKind": "official", "coverageStatus": "observed", "methodologyVersion": "board-day-bar-v1", "window": { "from": "2026-10-09", "to": "2026-11-07", "label": "30d" } }}Hatalar
400Geçersiz parametre veya gövde; sorunucodebelirtir.401Eksik 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ıresetAtbelirtir.403Anahtar 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-Afterdeğerine uyun.
Bir sıralamanın geçmiş dönemlerini listeleme
/v1/rankings/historyBir sıralamanın tamamlanmış dönemleri, en yeniden eskiye, planın geçmiş penceresi içinde.
Sorgu parametreleri
| Name | Type | Description |
|---|---|---|
boardRequired | string | Sıralama anahtarı: daily, hourly, popular_live, gaming_daily, gaming_weekly, shopping_daily, shopping_weekly (shop:read gerekir) veya bir lig sıralaması league_a1 … league_d5. |
regionOptional | string | ISO 3166-1 alpha-2 bölge kodu. Default: VN |
cursorOptional | string | Önceki sayfanın nextCursor değerinden alınan opak cursor. |
limitOptional | integer | Sayfa başına dönem sayısı. Aralık 1–24. Default: 24 |
leagueTierOptional | string | Lig seviyesi filtresi, A1 … D5. |
İstek
curl "https://api.next.toktokdata.live/v1/rankings/history?board=daily" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"Yanıt
{ "data": { "board": "daily", "region": "VN", "periods": [ { "periodKey": "2026-10-31", "observedAt": "2026-11-01T10:46:44.935Z", "coverageStatus": "observed", "publishable": true, "entries": [ { "rank": 1, "creatorUid": "990000000000000001", "uniqueId": "linh.live", "nickname": "Linh Live", "avatarUrl": null, "isLive": false, "roomId": null, "score": 99000, "leagueClass": null, "leagueClassSource": null, "leagueClassAsOf": null, "movement": "same", "previousRank": null, "masked": false, "unmaskTier": null }, { "rank": 2, "creatorUid": "990000000000000102", "uniqueId": "creator.02", "nickname": "Creator 02", "avatarUrl": null, "isLive": false, "roomId": null, "score": 98000, "leagueClass": null, "leagueClassSource": null, "leagueClassAsOf": null, "movement": "same", "previousRank": null, "masked": false, "unmaskTier": null } ] } ], "nextCursor": null, "hasMore": false, "historyWindowDays": 365, "historyTruncated": false }, "provenance": { "observedAt": "2026-11-01T10:46:44.935Z", "freshness": "historical", "source": "tiktok_observed_rank_board", "sourceKind": "official", "coverageStatus": "observed", "methodologyVersion": "rankings-official-v1", "window": null }}Hatalar
400Geçersiz parametre veya gövde; sorunucodebelirtir.401Eksik 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ıresetAtbelirtir.403Anahtar 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-Afterdeğerine uyun.
Gizli bir satırın LIVE toplamlarını al
/v1/rankings/masked/{ref}Sıralamanın döndürdüğü maskedRef ile gizli bir sıralama satırının son 30 gündeki LIVE toplamları: oturumlar, canlı yayın saniyesi ve ortalama zirve izleyici. Asla yaratıcının kimliği yoktur; adı olan bir satırla eşleştirilebilecek günlük veya oturum bazlı bir seri de yoktur. Bir ref yalnızca onu alan çalışma alanında çalışır ve sıralamanın her okunuşu yeni ref'ler üretir.
Yol parametreleri
| Name | Type | Description |
|---|---|---|
refRequired | string | Gizli bir sıralama satırının maskedRef değeri. |
İstek
curl "https://api.next.toktokdata.live/v1/rankings/masked/ref" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"Yanıt
{ "data": { "sessionsSummary": { "sessions": 6, "liveSeconds": 31400, "averagePeakViewers": 1640 } }, "provenance": { "observedAt": "2026-11-02T13:05:11.000Z", "freshness": "historical", "source": "creator_analytics", "sourceKind": "derived", "coverageStatus": "partial", "methodologyVersion": "masked-creator-v3", "window": { "from": "2026-10-04T08:00:00.000Z", "to": "2026-11-03T08:00:00.000Z", "label": "30d" } }}Hatalar
400Geçersiz parametre veya gövde; sorunucodebelirtir.401Eksik 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ıresetAtbelirtir.403Anahtar 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-Afterdeğerine uyun.
Resmî bir sıralamayı alma
/v1/rankings/officialBir bölge için, TikTok'un yayımladığı haliyle bir sıralama. Sıralamalar yalnızca kapsama bir eşiği geçtikten sonra yeniden üretilir: girdileri göstermeden önce publishable ve coverage değerlerini okuyun. Planın gösterdiğinin ötesindeki girdiler rank ve score değerlerini korur, ancak masked: true ile, kimlik olmadan (creatorUid, avatarUrl ve roomId null) ve onları gösteren unmaskTier ile döner; maskedRef, LIVE toplamlarını /v1/rankings/masked/{ref} üzerinden okur. Gizli bir girdinin movement, previousRank ve sparkline değerleri de null'dır, çünkü bunlar daha önce nerede olduğunu gösterirdi. Mevcut dönemde diğer her girdi sparkline taşır: son yedi tamamlanmış dönemin her birindeki puanı, en eskiden başlayarak, sıralamada olmadığı yerde null.
Sorgu parametreleri
| Name | Type | Description |
|---|---|---|
boardRequired | string | Sıralama anahtarı: daily, hourly, popular_live, gaming_daily, gaming_weekly, shopping_daily, shopping_weekly (shop:read gerekir) veya bir lig sıralaması league_a1 … league_d5. |
regionOptional | string | ISO 3166-1 alpha-2 bölge kodu. Default: VN |
periodOptional | "current" | "history" | current devam eden dönem, history ise son tamamlanan dönemdir.Default: current |
limitOptional | integer | Maksimum giriş sayısı. Aralık 1–200. Default: 200 |
liveOnlyOptional | "true" | "false" | Yalnızca şu anda yayında olan içerik üreticileri. Default: false |
leagueTierOptional | string | Lig seviyesi filtresi, A1 … D5. |
İstek
curl "https://api.next.toktokdata.live/v1/rankings/official?board=daily" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"Yanıt
{ "data": { "board": { "kind": "official", "board": "daily", "region": "VN", "periodKey": "2026-10-31", "resetAt": null, "publishable": true, "coverage": { "completeBoards": 1, "expectedBoards": 22, "ratio": 0.045454545454545456, "threshold": 0.8 }, "entries": [ { "rank": 1, "creatorUid": "990000000000000001", "uniqueId": "linh.live", "nickname": "Linh Live", "avatarUrl": null, "isLive": true, "roomId": "7990000000000000001", "score": 99000, "leagueClass": null, "leagueClassSource": null, "leagueClassAsOf": null, "movement": "new", "previousRank": null, "masked": false, "unmaskTier": null, "sparkline": [ null, 812000, 846500, 901200, 955000, 1010300, 99000 ] }, { "rank": 2, "creatorUid": "990000000000000102", "uniqueId": "creator.02", "nickname": "Creator 02", "avatarUrl": null, "isLive": false, "roomId": null, "score": 98000, "leagueClass": null, "leagueClassSource": null, "leagueClassAsOf": null, "movement": "new", "previousRank": null, "masked": false, "unmaskTier": null, "sparkline": [ null, 803880, 838035, 892188, 945450, 1000197, 97020 ] } ] } }, "provenance": { "observedAt": "2026-11-01T10:46:44.935Z", "freshness": "historical", "source": "tiktok_observed_rank_board", "sourceKind": "official", "coverageStatus": "observed", "methodologyVersion": "rankings-official-v1", "window": { "from": null, "to": null, "label": "daily" } }}Hatalar
400Geçersiz parametre veya gövde; sorunucodebelirtir.401Eksik 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ıresetAtbelirtir.403Anahtar 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-Afterdeğerine uyun.
Kapsanan bölgeleri listeleme
/v1/rankings/regionsŞu anda gözlemlenen sıralamaları olan bölgeler, görünen bir adla birlikte. Bir gün boyunca önbelleğe alın.
İstek
curl "https://api.next.toktokdata.live/v1/rankings/regions" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"Yanıt
{ "data": { "regions": [ { "region": "VN", "label": "VN · Vietnam", "coverage": { "completeBoards": 1, "expectedBoards": 22, "ratio": 0.045454545454545456, "threshold": 0.8 }, "boards": [ "daily" ], "notOfferedBoards": [] } ] }, "provenance": { "observedAt": "2026-11-01T10:46:44.935Z", "freshness": "historical", "source": "tiktok_observed_rank_board", "sourceKind": "official", "coverageStatus": "observed", "methodologyVersion": "rankings-official-v1", "window": null }}Hatalar
400Geçersiz parametre veya gövde; sorunucodebelirtir.401Eksik 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ıresetAtbelirtir.403Anahtar 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-Afterdeğerine uyun.