TikTok V2 API: Get TikTok LIVE creator rankings

Returns a TikTok LIVE ranking board. Every input is optional: rank_type, region_type, and gap_interval pick the board and time window, and room_id or anchor_id scope it to one room or host.

2 credits / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

anchor_id?string

Anchor (streamer) user ID, obtainable from the live room info endpoint. Changes which live room's rank data comes back.

room_id?string

Live room ID, obtainable from the live room info endpoint. Changes which live room's rank data comes back.

rank_type?string

Rank board type: 0 hourly, 1 weekly, 5 rookie star, 6 sale (e-commerce), 8 daily (default), 10/11 weekly/daily game rank, 12 hall of fame, 16 ranking league, 20-25 per-game ranks, among others that are not fully enumerated.

region_type?string

Region scope for the rank board. What each value maps to beyond the default (1) is not documented — leave unset to use it.

gap_interval?string

Time window for the rank board: 0 (default) for today's ranking, -1 for historical ranking records.

curl -X GET "https://example.com/v2/tiktok/app/live/daily-rank" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "data": null,    "property1": null,    "property2": null  }}