TikTok Get Live Daily Rank
Retrieve ranking data for a live room. All inputs are optional. `anchor_id` and `room_id` identify the anchor and room (defaults: `6952422426752205830` and `7380221319910312750`). `rank_type` selects the ranking (default `8`, daily rank): `0` hourly, `1` weekly, `5` rookie star, `6` sales, `8` daily, `10` weekly game, `11` daily game, `12` hall of fame, `13` champion tournament, `14` daily rookie star, `15` fan team, `16` ranking league, `20` PUBG, `21` MLBB, `22` Free Fire, `23`–`25` sub-weekly game ranks 1–3, `26` collectibles, `27` beauty, `28` women's wear, `29` daily sales, `1001` league campaign, and `-1` unknown. `region_type` defaults to `1`; its specific meaning is not defined here. `gap_interval` defaults to `0` for the current day; `-1` selects ranking-record data. `cookie` is an optional string. On success, `data` contains the ranking payload and may be null; its exact fields depend on the selected ranking. The response may also include status and request metadata.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
The selected ranking type does not affect the fixed charge per call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
cookie | string | No | 用户自己的cookie/User's own cookie | "" |
room_id | string | No | 直播间id/Live room id | 7380221319910312750 |
anchor_id | string | No | 主播id/Anchor id | 6952422426752205830 |
rank_type | integer | No | 榜单类型/Rank type | 8 |
region_type | integer | No | 地区类型/Region type | 1 |
gap_interval | integer | No | 时间间隔/Time interval | 0 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_get_live_daily_rank' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {}
}'{
"code": 200,
"data": {
"data": {
"rank_view": {
"bulletin": {
"enable": false
},
"countdown": 57787,
"cut_off_line": [
{
"content": {},
"cut_off_index": 20
}
],
"has_last_rank": true,
"is_position_safe": true,
"midday_peak_time_stamp": 1794942000
}
},
"extra": {
"now": 1794916613168
},
"status_code": 0
},
"docs": "https://api.tikhub.io/#/TikTok-App-V3-API/fetch_live_daily_rank_api_v1_tiktok_app_v3_fetch_live_daily_rank_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "ac03b592-50ac-4fa5-8774-e9653bfa4bea"
}This example shows part of the response. Copied content is valid JSON.

