Douyin Billboard Fetch Hot Category List

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

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.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
keywordstringNo热点搜索词""
end_datestringNo快照结束时间 格式yyyyMMdd""
start_datestringNo快照开始时间 格式yyyyMMdd""
snapshot_timestringNo快照时间 格式yyyyMMddHHmmss20250106151500
billboard_typestringYes榜单类型—

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_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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.