Douyin Creator Fetch Creator Hot Topic Billboard
Retrieve the Douyin creator hot-topic leaderboard to discover popular topics by category, ranking measure, and time window. Inputs (all optional integers): - billboard_tag: category ID; defaults to 0 for all categories. Documented values: 333=Food, 334=Travel, 299=Lifestyle, 335=Automotive, 336=Technology, 302=Gaming, 296=Anime, 337=Entertainment, 311=Celebrity, 298=Sports, 300=Culture & Education, 301=Campus, 297=Government, 305=Fashion, 306=Talent, 669=Finance, 314=Everyday snapshots, 307=Animals & Plants, 309=Images & Text, 308=Drama, 315=Parenting, 718=Agriculture & Rural Affairs, 310=Creative, 312=Outdoor, 926=Public Welfare. Other category IDs should be obtained from category configuration rather than guessed. - order_key: ranking measure; 1=highest views (default), 2=most likes, 3=most comments, 4=most submissions. - time_filter: time window; 1=24 hours (default), 2=7 days, 3=30 days. Returns creator hot-topic leaderboard data for the selected filters in the response data field. The detailed structure of leaderboard entries is not specified. This is a topic leaderboard, not an individual creator ranking. Example: billboard_tag=0, order_key=1, time_filter=1 requests topics across all categories ranked by highest views over 24 hours.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
A fixed charge of 2.07 credits per 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 |
|---|---|---|---|---|
order_key | integer | No | 排序键: 1=播放最高, 2=点赞最多, 3=评论最多, 4=投稿最多/Order key: 1=highest views, 2=most likes, 3=most comments, 4=most submissions | 1 |
time_filter | integer | No | 时间筛选: 1=24小时, 2=7天, 3=30天/Time filter: 1=24 hours, 2=7 days, 3=30 days | 1 |
billboard_tag | integer | No | 榜单标签,0=全部,其他值请通过config接口获取/Billboard tag, 0=all, other values can be obtained through config interface | 0 |
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_creator_fetch_creator_hot_topic_billboard' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"billboard_tag": 0,
"order_key": 4,
"time_filter": 1
}
}'{
"code": 200,
"data": {
"item_list": [
{
"aweme_list": null,
"collection_count": 0,
"comment_count": 41554,
"cover": {
"url_list": [
"https://p5-ex-gddgtc-sign.douyinpic.com/web.business.image/c3e4bedd6ecf58ac930357e62c860e67~noop.jpeg?lk3s=70809c85&x-expires=1794380400&x-signature=Q6cr0n55Hn4uKy%2BEFVZQ92QyC40%3D&from=1887476869"
]
},
"hot_involve_ratio": "",
"hot_involve_type": ""
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Creator-API/fetch_creator_hot_topic_billboard_api_v1_douyin_creator_fetch_creator_hot_topic_billboard_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "81516d60-3b44-4a38-a6c1-3d0a94021ff3"
}This example shows part of the response. Copied content is valid JSON.

