Douyin Creator Fetch Creator Hot Topic Billboard

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

Social
2.07 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
order_keyintegerNo排序键: 1=播放最高, 2=点赞最多, 3=评论最多, 4=投稿最多/Order key: 1=highest views, 2=most likes, 3=most comments, 4=most submissions1
time_filterintegerNo时间筛选: 1=24小时, 2=7天, 3=30天/Time filter: 1=24 hours, 2=7 days, 3=30 days1
billboard_tagintegerNo榜单标签,0=全部,其他值请通过config接口获取/Billboard tag, 0=all, other values can be obtained through config interface0

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