TikTok Get Live Daily Rank

2.07 credits/call
ae_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.

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
cookiestringNo用户自己的cookie/User's own cookie""
room_idstringNo直播间id/Live room id7380221319910312750
anchor_idstringNo主播id/Anchor id6952422426752205830
rank_typeintegerNo榜单类型/Rank type8
region_typeintegerNo地区类型/Region type1
gap_intervalintegerNo时间间隔/Time interval0

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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": {}
}'
Response exampleresponse.json
JSONPartial content
{
  "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.