Douyin Creator Fetch Creator Hot Spot Billboard
## Purpose Retrieve Douyin creator hot-spot billboard data to explore overall, local, or rising topics for content planning. ## Inputs - `billboard_tag` (string, default `"0"`): Hot-spot tag codes. Use `"0"` for all tags, or separate multiple codes with commas, such as `"1004,1000,1002"`. - `hot_search_type` (integer, default `1`): `1` = overall hot-spot ranking; `2` = local hot-spot ranking; `3` = rising hot-spot ranking. - `city_code` (string or null): Required when `hot_search_type=2`. Otherwise it may be omitted or null. Supply a city code, not a city name. ### Tag codes by category - Platform features: `1004,1000,1002,1003,1001` - Topic interaction: `20001,20006,20000,20003,20005,20002,20` - Entertainment: `2007,2000,2011,2012,2009,2010,2004,2005,2003,2008,2001,2002,2006` - Society: `4005,4006,4007,4003,4004,4000` - Anime: `13000`; transportation: `23000`; parenting: `19000` - Sports: `5002,5000,5001`; military: `21000`; drama: `18000` - Animals and pets: `8000`; weather: `22001,22002`; talent: `17000` - Culture and education: `14000`; travel: `10000`; fashion: `16000` - Politics: `3000,3001,3002`; campus: `15000`; automotive: `11000` - Gaming: `12000,12001`; technology: `6000`; food: `9000`; finance: `7000` ## Result Returns the creator hot-spot billboard data for the requested ranking and filters in `data`, together with response status metadata. The detailed fields of individual entries are not specified. This is a topic billboard, not a creator-account ranking. ## Example `{"billboard_tag":"0","hot_search_type":1}` requests the overall ranking across all tags.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
A fixed fee of 2.07 credits is charged 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 |
|---|---|---|---|---|
city_code | string | null | No | 城市代码,当hot_search_type=2时必需/City code - required when hot_search_type=2 | — |
billboard_tag | string | No | 热点标签,多个标签用逗号分隔,如'1004,1000,1002'/Hot spot tag - multiple tags separated by comma, like '1004,1000,1002' | 0 |
hot_search_type | integer | No | 热搜类型: 1=热点总榜, 2=同城热点榜, 3=热点上升榜/Hot search type: 1=Overall ranking, 2=Local ranking, 3=Rising ranking | 1 |
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_spot_billboard' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"billboard_tag": "0",
"hot_search_type": 1
}
}'{
"code": 200,
"data": {
"item_list": [
{
"aweme_list": null,
"category": "体育",
"cover": {
"uri": "tos-cn-i-0813c000-ce/oADAPPPwOnqxlIMvAAEAizrPuAwvaDJ5BBWxi",
"url_list": [
"https://p26-sign.douyinpic.com/tos-cn-i-0813c000-ce/oADAPPPwOnqxlIMvAAEAizrPuAwvaDJ5BBWxi~tplv-dy-resize-walign-adapt-aq:720:q75.jpeg?lk3s=138a59ce&x-expires=1795579200&x-signature=28BYoqFfOpKEM2B6TLIKkl%2FWgp8%3D&from=327834062&s=PackSourceEnum_PUBLISH&se"
]
},
"hot_score": 11993497,
"key_words": null,
"title": "凯尔特人大胜76人"
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Creator-API/fetch_creator_hot_spot_billboard_api_v1_douyin_creator_fetch_creator_hot_spot_billboard_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "ec439906-9dd0-48f9-a4e0-b996d8b39be7"
}This example shows part of the response. Copied content is valid JSON.

