Kuaishou App Live Top List

2.07 credits/call
ae_kuaishou_app_live_top_list

# Purpose Retrieve live-stream ranking data, either for the overall ranking or for a documented category. # Inputs - `subTabId`: Optional integer identifying the sub-ranking. Use `0` for the overall ranking, or one of these category IDs: `102` music, `107` dance, `101` beauty, `105` traditional arts, `111` dating, `106` games, `110` ACG, `104` stories, `113` group streaming, and `114` nine-grid. - `subTabName`: Optional category name. When selecting a category, pair the ID with its matching name: `音乐`, `舞蹈`, `颜值`, `国艺`, `相亲`, `游戏`, `二次元`, `故事`, `团播`, or `九宫格`. For the overall ranking, leave it empty or omitted. # Returns The live ranking data for the selected overall or category list.

VideoEntertainmentSocial
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

Each call has a fixed charge of 2.07 credits. Charges are per query. A successful query is billed even if it returns no results.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
subTabIdintegerNo用于选择直播总榜或分类子榜单的 ID。默认值为 0,表示总榜;分类对应关系为:102 音乐、107 舞蹈、101 颜值、105 国艺、111 相亲、106 游戏、110 二次元、104 故事、113 团播、114 九宫格。查询分类榜时与对应的 subTabName 配套使用。0
subTabNamestringNo用于指定直播分类子榜单的名称,与 subTabId 对应:音乐(102)、舞蹈(107)、颜值(101)、国艺(105)、相亲(111)、游戏(106)、二次元(110)、故事(104)、团播(113)、九宫格(114)。查询总榜(subTabId 为 0)时可省略,默认值为空字符串。""

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_kuaishou_app_live_top_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "subTabId": 0
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "result": 1,
    "topList": {
      "data": [
        {
          "list": [
            {}
          ],
          "subTabId": 100,
          "subTabName": "总榜"
        }
      ],
      "dataType": 2
    }
  },
  "docs": "https://api.tikhub.io/#/Kuaishou-App-API/fetch_live_top_list_api_v1_kuaishou_app_fetch_live_top_list_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "fe6fa822-d677-4013-9f8d-5a7195bf9790"
}

This example shows part of the response. Copied content is valid JSON.