Douyin Xingtu Get Ranking List Catalog
Retrieve the category catalog for Douyin Xingtu hot rankings. Inputs (both optional): - `codes`: Category-code string; defaults to `""`. The category-code format is not specified. - `biz_scene`: Ranking context. Defaults to `douyin_flow_split_video_author_ranks` for short-video creators. Use `douyin_flow_split_live_author_ranks` for live-stream creators. Returns ranking-category information, including identifiers such as `qualifier_id`. This is a category catalog, not a list of ranked creators. The detailed category payload structure is not specified. Example: `{"codes":"","biz_scene":"douyin_flow_split_video_author_ranks"}`.
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.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
codes | string | No | 分类代码,默认为空字符串/Classification codes, default is empty string | "" |
biz_scene | string | No | 业务场景/Business scene | douyin_flow_split_video_author_ranks |
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_douyin_xingtu_get_ranking_list_catalog' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"biz_scene": "douyin_flow_split_video_author_ranks",
"codes": ""
}
}'{
"code": 200,
"data": {
"base_resp": {
"status_code": 0,
"status_message": ""
},
"catalog": {
"1": [
{
"attribute_datas": {},
"code": 1,
"date": "20261031",
"display_name": "品牌种草·品牌优选榜",
"period": "30",
"qualifier": "3C及电器"
}
],
"10": [
{
"attribute_datas": {},
"code": 10,
"date": "20251228",
"display_name": "应用下载·高潜榜",
"period": "7",
"qualifier": "平台电商"
}
]
}
},
"docs": "https://api.tikhub.io/#/Douyin-Xingtu-V2-API/get_ranking_list_catalog_api_v1_douyin_xingtu_v2_get_ranking_list_catalog_get",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

