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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
topic_name | string | Yes | 热点名称/Hot topic name | — |
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_index_fetch_hot_detail' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"topic_name": "上海地铁16号线突发故障"
}
}'{
"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.

