RoomScope

Son güncelleme

İçerik üreticileri

Saklanan içerik üreticisi profilleri, değişiklikler, takip grafiği ve analizler.

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.

TikTok LIVE ajanslarını listeleme

GET/v1/agencies

TikTok LIVE ajansları (herkese açık ajans profillerinden); ada veya resmi kullanıcı adına, bölgeye ve herkese açık profile göre aranabilir; boyuta (hostCountMin), gelir aralığına (monthlyDiamondMin), en yeniye veya ada göre sıralanır. Aralıklar TikTok'un kendi aralıklarıdır. İletişim bilgileri yalnızca ajansın yayımladıklarını gösterir.

Kapsamcreator:readKredilerÖnbellekten okuma

Sorgu parametreleri

Sorgu parametreleri · GET /v1/agencies
NameTypeDescription
qOptional
stringAjans adının bir kısmı veya resmi kullanıcı adı.
regionOptional
stringBölge grubu (ör. VN, US+, MENA).
publicOnlyOptional
booleanYalnızca herkese açık profili olan ajanslar.
sortOptional
"size" | "revenue" | "recent" | "name"size, revenue, recent veya name.
Default: size
limitOptional
integerMaksimum satır sayısı. Aralık …–200.
Default: 50
offsetOptional
integerAtlanacak satır sayısı.
Default: 0

İstek

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

Yanıt

200 OK
{  "data": {    "agencies": [      {        "agencyId": "108474",        "name": "Look Corporation",        "regions": [          "KR"        ],        "onboardedOn": "2025-03-01",        "official": {          "uid": "7012345678901234567",          "handle": "look.corp",          "nickname": "Look Corporation",          "avatarUrl": null,          "followers": 12500        },        "intro": "A TikTok LIVE agency based in Korea.",        "services": [          "1_on_1_support",          "live_skills_training"        ],        "contact": {          "website": "https://example.com"        },        "hostCountBand": "101-200",        "agentCountBand": "11-50",        "monthlyDiamondBand": "1M-5M",        "hostCountMin": 101,        "monthlyDiamondMin": 1000000,        "hasPublicProfile": true,        "lastSeenAt": "2026-10-24T05:34:33.738Z"      }    ],    "total": 1,    "offset": 0  },  "provenance": {    "observedAt": "2026-10-24T05:34:33.738Z",    "freshness": "stale",    "source": "public_creator_profile",    "sourceKind": "derived",    "coverageStatus": "partial",    "methodologyVersion": "agency-directory-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 TikTok LIVE ajansını alma

GET/v1/agencies/{agency_id}

Dizindeki bir ajans, GET /v1/agencies onu nasıl listeliyorsa öyle.

Kapsamcreator:readKredilerÖnbellekten okuma

Yol parametreleri

Yol parametreleri · GET /v1/agencies/{agency_id}
NameTypeDescription
agency_idRequired
stringTikTok ajans kimliği.

İstek

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

Yanıt

200 OK
{  "data": {    "agencyId": "108474",    "name": "Look Corporation",    "regions": [      "KR"    ],    "onboardedOn": "2025-03-01",    "official": {      "uid": "7012345678901234567",      "handle": "look.corp",      "nickname": "Look Corporation",      "avatarUrl": null,      "followers": 12500    },    "intro": "A TikTok LIVE agency based in Korea.",    "services": [      "1_on_1_support",      "live_skills_training"    ],    "contact": {      "website": "https://example.com"    },    "hostCountBand": "101-200",    "agentCountBand": "11-50",    "monthlyDiamondBand": "1M-5M",    "hostCountMin": 101,    "monthlyDiamondMin": 1000000,    "hasPublicProfile": true,    "lastSeenAt": "2026-10-24T05:34:33.738Z"  },  "provenance": {    "observedAt": "2026-10-24T05:34:33.738Z",    "freshness": "stale",    "source": "public_creator_profile",    "sourceKind": "derived",    "coverageStatus": "partial",    "methodologyVersion": "agency-directory-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.

İçerik üreticisi arama

GET/v1/creators

Kullanıcı adı veya görünen ad içinde, büyük/küçük harfe duyarsız alt dize araması; en çok takipçisi olan önce. Boş bir q, saklanan kümeye göz atar.

Kapsamcreator:readKredilerÖnbellekten okuma

Sorgu parametreleri

Sorgu parametreleri · GET /v1/creators
NameTypeDescription
qOptional
stringKullanıcı adı (@ ile veya olmadan) ya da görünen adın bir kısmı.
limitOptional
integerMaksimum sonuç sayısı. Aralık 1–100.
Default: 20

İstek

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

Yanıt

200 OK
{  "data": {    "query": "linh.live",    "results": [      {        "tiktokUserId": "990000000000000001",        "uniqueId": "linh.live",        "displayName": "Linh Live",        "region": "VN",        "avatarUrl": null,        "followerCount": 123456,        "verified": true      }    ]  },  "provenance": {    "observedAt": "2026-11-01T10:36:44.935Z",    "freshness": "near_realtime",    "source": "public_creator_profile",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "creators-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.

İçerik üreticisi profilini alma

GET/v1/creators/{uid}

Kayıtlı herkese açık profil ve sayaçlarının yakın geçmişi. Henüz kaydedilmemiş (ya da uzun süre önce kaydedilmiş) bir içerik üreticisi TikTok'ta aranır: birkaç saniyeden uzun sürerse yanıt status: resolving, bir jobId ve retryAfterSeconds (ayrıca Retry-After) ile 202 olur; o zaman yeniden sorun, profil hazır olur. status: saturated (202) çok fazla aramanın sürdüğünü gösterir; TikTok'un tanımadığı bir kullanıcı adı 404 döner ve on dakika boyunca yeniden aranmaz; 503 resolve_unavailable TikTok'un şu anda okunamadığını gösterir.

Kapsamcreator:readKredilerÖnbellekten okuma

Yol parametreleri

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

İstek

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

Yanıt

200 OK
{  "data": {    "creator": {      "tiktokUserId": "990000000000000001",      "uniqueId": "linh.live",      "secUid": null,      "displayName": "Linh Live",      "region": "VN",      "language": null,      "signature": "Daily LIVE from Hanoi",      "avatarUrl": null,      "followerCount": 123456,      "followingCount": 321,      "awemeCount": 3,      "totalFavorited": 9876543,      "favoritingCount": null,      "verified": true,      "customVerify": null,      "enterpriseVerifyReason": null,      "instagramId": null,      "youtubeChannelId": null,      "twitterId": null,      "firstSeenAt": "2026-10-02T10:51:44.935Z",      "lastRefreshedAt": "2026-11-01T10:36:44.935Z",      "history": []    }  },  "provenance": {    "observedAt": "2026-11-01T10:36:44.935Z",    "freshness": "near_realtime",    "source": "public_creator_profile",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "creators-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 videolarını analiz etme

GET/v1/creators/{uid}/analysis

Yalnızca kayıtlı videolardan hesaplanan etkileşim raporu: toplamlar, medyanlar, paylaşım sıklığı. read en çok beş sade cümledir, en belirleyici önce; her biri params ile bir code (engagement, reach, growth, cadence, posting-gap, breakout, audience-language) olup istemcinin kendi dilinde ifade etmesi içindir; limits raporun neyi kapsamadığını ve bir cümlenin neden eksik olduğunu söyler.

Kapsamcreator:readKredilerÖnbellekten okuma

Yol parametreleri

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

İstek

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

Yanıt

200 OK
{  "data": {    "creator": {      "tiktokUserId": "990000000000000001",      "uniqueId": "linh.live",      "displayName": "Linh Live",      "avatarUrl": null,      "region": "VN",      "verified": true,      "followerCount": 123456,      "followingCount": 321,      "awemeCount": 3,      "totalFavorited": 9876543,      "firstSeenAt": "2026-10-02T10:51:44.935Z",      "lastRefreshedAt": "2026-11-01T10:36:44.935Z"    },    "sample": {      "videosAnalyzed": 3,      "oldestVideoAt": "2026-10-29T10:51:44.935Z",      "newestVideoAt": "2026-10-31T10:51:44.935Z",      "spanDays": 2,      "shareOfCatalog": 1    },    "engagement": {      "totalPlays": 60000,      "totalLikes": 6000,      "totalComments": 600,      "totalShares": 0,      "avgPlays": 20000,      "medianPlays": 20000,      "avgLikes": 2000,      "avgComments": 200,      "avgShares": 0,      "engagementRate": 0.11,      "likeRate": 0.1,      "commentRate": 0.01,      "shareRate": 0,      "viewsPerFollower": 0.162    },    "read": [      {        "code": "engagement",        "params": {          "rate": 0.11,          "band": "typical"        }      },      {        "code": "reach",        "params": {          "ratio": 0.162,          "band": "most-followers"        }      },      {        "code": "growth",        "params": {          "delta": 1840,          "rate": 0.0371,          "days": 29.8,          "direction": "up"        }      },      {        "code": "cadence",        "params": {          "postsPerWeek": 7,          "busiestWeekday": 4        }      }    ],    "cadence": {      "postsPerWeek": 7,      "avgDaysBetweenPosts": 1,      "longestGapDays": 1,      "busiestWeekday": 4,      "postsByWeekday": [        0,        0      ]    },    "topByPlays": [      {        "videoId": "7990000000000000003",        "description": "Video 3",        "createTime": "2026-10-29T10:51:44.935Z",        "playCount": 30000,        "diggCount": 3000,        "commentCount": 300,        "shareCount": null,        "engagementRate": 0.11      },      {        "videoId": "7990000000000000002",        "description": "Video 2",        "createTime": "2026-10-30T10:51:44.935Z",        "playCount": 20000,        "diggCount": 2000,        "commentCount": 200,        "shareCount": null,        "engagementRate": 0.11      }    ],    "topByEngagement": [      {        "videoId": "7990000000000000001",        "description": "Video 1",        "createTime": "2026-10-31T10:51:44.935Z",        "playCount": 10000,        "diggCount": 1000,        "commentCount": 100,        "shareCount": null,        "engagementRate": 0.11      },      {        "videoId": "7990000000000000002",        "description": "Video 2",        "createTime": "2026-10-30T10:51:44.935Z",        "playCount": 20000,        "diggCount": 2000,        "commentCount": 200,        "shareCount": null,        "engagementRate": 0.11      }    ],    "audience": null,    "growth": null,    "limits": [      {        "code": "thin-video-sample",        "message": "Only 3 video(s) analysed — too few to describe the account's typical performance."      },      {        "code": "single-observation",        "message": "This account has been observed only once, so no follower growth can be shown yet."      }    ]  },  "provenance": {    "observedAt": "2026-11-01T10:36:44.935Z",    "freshness": "near_realtime",    "source": "derived_creator_analysis",    "sourceKind": "derived",    "coverageStatus": "partial",    "methodologyVersion": "analysis-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.

Profil değişikliklerini listeleme

GET/v1/creators/{uid}/changes

Zaman içinde gözlemlenen kullanıcı adı, ad, biyografi ve doğrulama değişiklikleri, en yeniden eskiye.

Kapsamcreator:readKredilerÖnbellekten okuma

Yol parametreleri

Yol parametreleri · GET /v1/creators/{uid}/changes
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/creators/{uid}/changes
NameTypeDescription
limitOptional
integerMaksimum değişiklik sayısı. Aralık 1–200.
Default: 50

İstek

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

Yanıt

200 OK
{  "data": {    "tiktokUserId": "990000000000000001",    "uniqueId": "linh.live",    "changes": []  },  "provenance": {    "observedAt": "2026-10-02T10:51:44.935Z",    "freshness": "stale",    "source": "public_creator_profile",    "sourceKind": "derived",    "coverageStatus": "partial",    "methodologyVersion": "creators-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 takipçilerini listeleme

GET/v1/creators/{uid}/followers

Saklanan takipçiler; takip edilenlerle aynı yapıda.

Kapsamcreator:readKredilerÖnbellekten okuma

Yol parametreleri

Yol parametreleri · GET /v1/creators/{uid}/followers
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/creators/{uid}/followers
NameTypeDescription
cursorOptional
stringÖnceki sayfanın nextCursor değerinden alınan opak cursor.
limitOptional
integerSayfa başına giriş sayısı.

İstek

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

Yanıt

200 OK
{  "data": {    "tiktokUserId": "990000000000000001",    "uniqueId": "linh.live",    "direction": "following",    "entries": [],    "nextCursor": null,    "hasMore": false,    "totalReported": null,    "storedCount": 0,    "isPrivate": false  },  "provenance": {    "observedAt": "2026-11-01T11:18:49.084Z",    "freshness": "stale",    "source": "public_follow_graph",    "sourceKind": "derived",    "coverageStatus": "not-covered",    "methodologyVersion": "follow-list-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 takip ettiği hesapları listeleme

GET/v1/creators/{uid}/following

Saklanan takip grafiği. Gizli hesaplar isPrivate: true döndürür ve giriş içermez.

Kapsamcreator:readKredilerÖnbellekten okuma

Yol parametreleri

Yol parametreleri · GET /v1/creators/{uid}/following
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/creators/{uid}/following
NameTypeDescription
cursorOptional
stringÖnceki sayfanın nextCursor değerinden alınan opak cursor.
limitOptional
integerSayfa başına giriş sayısı.

İstek

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

Yanıt

200 OK
{  "data": {    "tiktokUserId": "990000000000000001",    "uniqueId": "linh.live",    "direction": "following",    "entries": [],    "nextCursor": null,    "hasMore": false,    "totalReported": null,    "storedCount": 0,    "isPrivate": false  },  "provenance": {    "observedAt": "2026-11-01T11:18:49.084Z",    "freshness": "stale",    "source": "public_follow_graph",    "sourceKind": "derived",    "coverageStatus": "not-covered",    "methodologyVersion": "follow-list-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 en çok hediye gönderenlerini alma

GET/v1/creators/{uid}/gifters

Son 7 veya 30 günde içerik üreticisinin LIVE odalarında hediye gönderenler, elmasa göre: hediye sayısı, oturumlar, son hediye ve hediye gönderdikleri son odanın içerik üreticisi. RoomScope’un kaydettiği oturumlardan okunur, bu yüzden kapsam her zaman partial olur. Pro planı veya üzeri gerekir.

Kapsamgifter:readKredilerÖnbellekten okuma

Yol parametreleri

Yol parametreleri · GET /v1/creators/{uid}/gifters
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/creators/{uid}/gifters
NameTypeDescription
windowOptional
"7d" | "30d"7d veya 30d.
Default: 7d
limitOptional
integerMaksimum satır sayısı. Aralık …–100.
Default: 20

İstek

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

Yanıt

200 OK
{  "data": {    "creatorUid": "7012345678901234567",    "uniqueId": "linh.live",    "window": "7d",    "gifters": [      {        "gifterUserId": "6987001122334455667",        "gifterUniqueId": "minh.fan",        "gifterNickname": "Minh",        "avatarUrl": null,        "diamondTotal": 18450,        "giftCount": 312,        "sessions": 4,        "lastGiftAt": "2026-11-02T15:41:07.512Z",        "lastRoomCreator": "linh.live"      }    ]  },  "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.

Bir içerik üreticisinin içgörülerini alma

GET/v1/creators/{uid}/insights

Kullanıcı adı geçmişi, son 30 günün günlük elmasları (en yeniden eskiye), günlük lig anlık görüntüleri ve içerik üreticisinin LIVE odası. Günün puanı sıralama sıfırlanırken okunduysa liveExact true olur; aksi hâlde liveScore o gün okunan en yüksek puandır. observedCoins, RoomScope’un içerik üreticisinin LIVE oturumlarında kaydettiği elmasları sayar. Değişmiş bir kullanıcı adı, takma ad geçmişi üzerinden yine çözümlenir.

Kapsamcreator:readKredilerÖnbellekten okuma

Yol parametreleri

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

İstek

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

Yanıt

200 OK
{  "data": {    "creator": {      "uid": "6990000000000000001",      "uniqueId": "linh.live"    },    "aliases": [      {        "uniqueId": "linh.live",        "firstSeenAt": "2026-10-12T09:15:02.118Z",        "lastSeenAt": "2026-11-01T14:02:41.530Z"      },      {        "uniqueId": "linh.official",        "firstSeenAt": "2026-09-30T11:40:19.004Z",        "lastSeenAt": "2026-10-12T08:55:47.912Z"      }    ],    "daily": [      {        "boardDay": "2026-10-31",        "countryCode": "VN",        "tiktokScore": 184250,        "observedCoins": 171932,        "liveScore": 184250,        "liveExact": true,        "leagueClass": "B2"      },      {        "boardDay": "2026-10-30",        "countryCode": "VN",        "tiktokScore": 97410,        "observedCoins": null,        "liveScore": 97410,        "liveExact": false,        "leagueClass": "B2"      }    ],    "league": [      {        "day": "2026-10-31",        "leagueClass": "B2",        "leagueRank": 14,        "leagueCountry": "VN",        "followers": 412880      }    ],    "roomOwner": {      "roomId": "7432000000000000001",      "ownerUid": "6990000000000000001",      "ownerUniqueId": "linh.live",      "claimantUid": null,      "reason": "claim_confirmed",      "checkedAt": "2026-11-01T14:00:03.221Z"    }  },  "provenance": {    "observedAt": "2026-11-01T14:02:41.530Z",    "freshness": "near_realtime",    "source": "creator_analytics",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "creator-analytics-v1",    "window": {      "from": "2026-10-02T14:02:41.530Z",      "to": "2026-11-01T14:02:41.530Z",      "label": "30d"    }  }}

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 yayına çıkmak için en iyi saati alma

GET/v1/insights/best-time

Bir bölgede kaydedilen LIVE oturumlarının son windowDays gündeki elmasları ve hediye gönderen saatleri; haftanın günü (0 = Pazartesi) ve UTC saati bazında. Her gün yeniden hesaplanır; bölge için henüz hiçbir şey kaydedilmemişse cells boştur.

Kapsamcreator:readKredilerÖnbellekten okuma

Sorgu parametreleri

Sorgu parametreleri · GET /v1/insights/best-time
NameTypeDescription
regionOptional
stringISO 3166-1 alpha-2 bölge kodu.
Default: VN

İstek

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

Yanıt

200 OK
{  "data": {    "region": "VN",    "windowDays": 28,    "computedAt": "2026-11-01T01:00:04.870Z",    "cells": [      {        "weekday": 0,        "hour": 12,        "diamonds": 418230,        "gifterHours": 1874      },      {        "weekday": 0,        "hour": 13,        "diamonds": 652910,        "gifterHours": 2410      },      {        "weekday": 0,        "hour": 14,        "diamonds": 701455,        "gifterHours": 2689      }    ]  },  "provenance": {    "observedAt": "2026-11-01T01:00:04.870Z",    "freshness": "near_realtime",    "source": "creator_analytics",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "creator-analytics-v1",    "window": {      "from": "2026-10-04T01:00:04.870Z",      "to": "2026-11-01T01:00:04.870Z",      "label": "28d"    }  }}

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.

Saatlik LIVE varlığını alma

GET/v1/insights/presence

Saat başına, bölgede izlenen ve sıralamaya girmiş içerik üreticilerinden kaçının yayında olduğu, en eskiden yeniye.

Kapsamcreator:readKredilerÖnbellekten okuma

Sorgu parametreleri

Sorgu parametreleri · GET /v1/insights/presence
NameTypeDescription
regionOptional
stringISO 3166-1 alpha-2 bölge kodu.
Default: VN
hoursOptional
integerKaç saat geriye gidileceği. Aralık 1–168.
Default: 48

İstek

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

Yanıt

200 OK
{  "data": {    "region": "VN",    "hours": 48,    "points": [      {        "hourStart": "2026-11-01T12:00:00.000Z",        "liveCreators": 214,        "trackedCreators": 1630      },      {        "hourStart": "2026-11-01T13:00:00.000Z",        "liveCreators": 251,        "trackedCreators": 1642      },      {        "hourStart": "2026-11-01T14:00:00.000Z",        "liveCreators": 268,        "trackedCreators": 1655      }    ]  },  "provenance": {    "observedAt": "2026-11-01T14:05:01.402Z",    "freshness": "near_realtime",    "source": "creator_analytics",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "creator-analytics-v1",    "window": {      "from": "2026-10-30T14:05:01.402Z",      "to": "2026-11-01T14:05:01.402Z",      "label": "48h"    }  }}

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ı?