Douyin Index Fetch Hot Detail

2.07 credits/call
ae_douyin_index_fetch_hot_detail

Retrieve analytics for a single Douyin hot topic in one request. Input: - topic_name (required string): The hot-topic name. You can use a name obtained from current hot-topic results. Documented result contents: - trend_item: Hot-topic index values over time. - content_item: Popular videos, including titles, links, covers, authors, and like/comment counts. - play_rank_author_item, digg_rank_author_item, fans_rank_author_item, comment_rank_author_item: Related creators ranked by plays, likes, followers, and comments respectively. - portrait: Audience distributions by province, city, gender, and age. Values represent proportions in decimal form. The response contains a data payload that may be null. The analytics fields above are documented contents, not a fully specified response schema. Use this tool for a known topic, not to discover a list of current hot topics.

SocialVideo
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
topic_namestringYes热点名称/Hot topic name—

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_index_fetch_hot_detail' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "topic_name": "上海地铁16号线突发故障"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {},
  "docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_hot_detail_api_v1_douyin_index_fetch_hot_detail_get",
  "message": "No data found for hot topic '上海地铁16号线突发故障'. The topic name must be an existing Douyin hot topic and must match exactly. Please get a valid topic_name from the /douyin/index/fetch_current_hot_topic endpoint (topic_name field). This request will incur a char",
  "message_zh": "未找到热点 '上海地铁16号线突发故障' 的数据。热点名必须是抖音上真实存在的热点且需完全匹配,请先调用 /douyin/index/fetch_current_hot_topic 接口获取有效的热点名(topic_name 字段)后再查询。本次请求将被计费。",
  "params": {
    "topic_name": "上海地铁16号线突发故障"
  }
}

This example shows part of the response. Copied content is valid JSON.