Douyin Billboard Fetch Hot Category List
Retrieve category IDs and popularity information from Douyin hot lists. Inputs: - billboard_type (required): rise for the rising hot list, city for the city hot list, or total for the overall hot list. - snapshot_time: snapshot time in yyyyMMddHHmmss format. The preset default is 20250106151500, not a request for the latest snapshot. - start_date and end_date: snapshot date-range boundaries in yyyyMMdd format. To use them, remove snapshot_time; do not leave its preset default active. - keyword (optional): hot-topic search term. Provide either a snapshot time or a date range; these time inputs must not all be empty. Returns category results with category IDs and popularity information in the response data. The detailed structure of individual results is not specified.
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 |
|---|---|---|---|---|
keyword | string | No | 热点搜索词 | "" |
end_date | string | No | 快照结束时间 格式yyyyMMdd | "" |
start_date | string | No | 快照开始时间 格式yyyyMMdd | "" |
snapshot_time | string | No | 快照时间 格式yyyyMMddHHmmss | 20250106151500 |
billboard_type | string | Yes | 榜单类型 | — |
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_billboard_fetch_hot_category_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"billboard_type": "hot_total"
}
}'{
"detail": {
"code": 400,
"docs": "https://api.tikhub.io/#/Douyin-Billboard-API/fetch_hot_category_list_api_v1_douyin_billboard_fetch_hot_category_list_get",
"headers": {},
"message": "Request failed. Please retry. Check the docs below to verify your parameters, test with the default demo parameters, and send the response JSON to support. You won't be charged for this request.",
"message_zh": "请求失败,请重试。请查看下方文档核对参数,使用默认演示参数测试,并将响应 JSON 提交给支持团队。本次请求不会被扣费。",
"params": {
"billboard_type": "hot_total",
"end_date": "",
"keyword": "",
"snapshot_time": "20250106151500",
"start_date": ""
}
}
}This example shows part of the response. Copied content is valid JSON.

