Douyin Billboard Fetch Hot Account Trends List
Retrieve trend data for a Douyin account's new likes, posts, comments, or shares. Inputs: - sec_uid (required string): The account's sec_id identifier. - option (optional integer): Metric to retrieve: 2 = new likes, 3 = new posts, 4 = new comments, 5 = new shares. Default: 2. - date_window (optional integer): Data-point interval in hours. Use 1 for hourly points or 24 for daily points. Default: 24. This sets granularity, not the overall date range. Returns: Account trend data for the selected metric in the response data payload. The payload's detailed structure is not specified and it may be null. The documented metric options do not include follower counts.
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 |
|---|---|---|---|---|
option | integer | No | 选项,2 新增点赞量 3 新增作品量 4 新增评论量 5 新增分享量 | 2 |
sec_uid | string | Yes | 用户sec_id | — |
date_window | integer | No | 数据点粒度(小时),可选 1/24,代表每小时一个点/每天一个点,默认24 | 24 |
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_billboard_fetch_hot_account_trends_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"date_window": 24,
"option": 4,
"sec_uid": "MS4wLjABAAAAKm6DAzqZgqQ6Qm5suS-55ynX-fvAK-iuvZoUOdOiOSaEhry_H5u6sklwS0S7yN1B"
}
}'{
"code": 200,
"data": {
"code": 0,
"data": {
"avg": 0.0898876404494382,
"trends": [
{
"datetime": 1786550400,
"value": 0
}
]
},
"extra": {
"now": 1794383772000
},
"message": ""
},
"docs": "https://api.tikhub.io/#/Douyin-Billboard-API/fetch_hot_account_trends_list_api_v1_douyin_billboard_fetch_hot_account_trends_list_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"date_window": "24",
"option": "4",
"sec_uid": "MS4wLjABAAAAKm6DAzqZgqQ6Qm5suS-55ynX-fvAK-iuvZoUOdOiOSaEhry_H5u6sklwS0S7yN1B"
}
}This example shows part of the response. Copied content is valid JSON.

