Douyin Creator Fetch Creator Hot Spot Billboard

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

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
city_codestring | nullNo城市代码,当hot_search_type=2时必需/City code - required when hot_search_type=2—
billboard_tagstringNo热点标签,多个标签用逗号分隔,如'1004,1000,1002'/Hot spot tag - multiple tags separated by comma, like '1004,1000,1002'0
hot_search_typeintegerNo热搜类型: 1=热点总榜, 2=同城热点榜, 3=热点上升榜/Hot search type: 1=Overall ranking, 2=Local ranking, 3=Rising ranking1

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