TikTok Ads Get Trends Hashtag Detail
# 用途 获取单个热门标签的趋势详情,用于分析其热度、相关视频和受众特征。 # 输入 参数放在 `request_body` 中: - `hashtag_id`:必填,标签 ID;通常从热门标签列表中获取。 - `time_range`:可选,统计时间范围(天),支持 7、30 或 90,默认 90。应与该标签上榜时使用的时间范围一致,否则可能没有数据。 - `country_code`:可选,国家或地区代码,默认 `US`。 - `cookie`:可选,自定义 Cookie 字符串。 # 返回 返回结果包含标签详情数据,可能包括: - `hashtagName`:标签名称 - `publishCnt`:发布数量 - `vv`:观看量 - `popularityCurve`:热度趋势曲线,包含时间戳和值 - `videoList`:相关视频列表,可能包含封面、视频或条目标识及视频链接 - `ageProfile`:受众年龄分布,包含年龄层及观看量占比 - `representativeCountryProfile`:代表性国家分布,包含国家代码及国家 TGI 分数 - `industryIDs`:所属行业 ID 列表 如果筛选条件过多或时间范围与标签上榜范围不一致,可能不会返回数据;可尝试调整筛选条件或时间范围。
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 |
|---|---|---|---|---|
request_body | object | Yes | 查询单个热门标签趋势详情的请求体,包含必填的 hashtag_id,以及可选的 time_range、country_code 和 cookie。 | — |
request_body.cookie | string | No | 自定义Cookie字符串(可选)/Custom Cookie string (optional) | — |
request_body.hashtag_id | string | Yes | 标签ID/Hashtag ID | — |
request_body.time_range | integer | No | 时间范围(天):7/30/90 /Time range in days | 90 |
request_body.country_code | string | No | 国家/地区代码/Country code | US |
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_tiktok_ads_get_trends_hashtag_detail' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"country_code": "TH",
"hashtag_id": "7014827381856665626",
"time_range": 30
}
}
}'{
"code": 200,
"data": {
"BaseResp": {
"StatusCode": 0,
"StatusMessage": ""
},
"hashtagID": "7014827381856665626"
},
"docs": "https://api.tikhub.io/#/TikTok-Ads-API/get_trends_hashtag_detail_api_v1_tiktok_ads_get_trends_hashtag_detail_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {}
}This example shows part of the response. Copied content is valid JSON.

