Rankings

Get real-time leaderboard data for a live room - top gifters, online audience rankings, and engagement scores. Uses the ‘sign-and-return’ pattern for authenticated data.

GET /webcast/rankings

Get real-time leaderboard data for a live room - top gifters, online audience rankings, and engagement scores. Uses the “sign-and-return” pattern for authenticated data.

Data available: In-room top gifters (online_audience - ranked by diamonds sent this session), all-time gifter leaderboard (anchor_rank_list), and entrance configuration (ranking tabs, timer info, class/league badges).

Authentication: For full leaderboard data, include your TikTok session cookies via x-cookie-header. Without authentication, the endpoint returns limited ranking data.

Response pattern: Returns a signed_url that you fetch with session cookies to get TikTok’s ranking data. Each rank entry includes user (nickname, avatar, follower count), score (diamonds), and rank position.

Parameters

Parameter	Type	Required	Description
room_id	string	No	TikTok room ID
unique_id	string	No	TikTok username (alternative to room_id)

Response

{ "status_code": 0, "data": { "room_id": "...", "rankings": [...] } }

Examples

Node.js

const res = await fetch('https://api.tik.tools/webcast/rankings?unique_id=username&apiKey=YOUR_KEY');
const { data } = await res.json();
console.log(data.rankings);