TikTok Ads Get Trends Hashtag List
获取趋势榜单中的热门标签,并可按国家/地区、时间范围和一级行业筛选。 输入参数: - `time_range`:时间范围(天),可选 7、30 或 90,默认 7。 - `country_code`:国家/地区代码,默认 `US`。 - `page`:页码,默认 1。 - `limit`:每页数量,默认 20。 - `industry_id`:可选的一级行业 ID;不传则不按行业筛选。可用行业包括教育、汽车与交通、母婴、金融服务、美妆个护、科技与电子、家用电器、旅游、家居用品、宠物、应用软件、家装、服装配饰、新闻娱乐、商业服务、游戏、生活服务、食品饮料、运动户外和健康,对应 ID 分别为 10000000000、11000000000、12000000000、13000000000、14000000000、15000000000、16000000000、17000000000、18000000000、19000000000、20000000000、21000000000、22000000000、23000000000、24000000000、25000000000、26000000000、27000000000、28000000000 和 29000000000。 - `cookie`:可选的自定义 Cookie 字符串;仅在需要并且调用者能够提供时使用。 返回内容: - `items`:热门标签列表,可能包含标签 ID、标签名称、所属行业 ID、热度曲线、发布数量、排名、头部创作者和观看量。 - `pagination`:分页信息,包括当前页、每页数量、总数和是否还有更多结果。 如果筛选条件较多导致没有结果,可尝试扩大时间范围、取消行业筛选或调整其他筛选条件。结果来自已收录的热门数据,可能不代表完整数据集。
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
Each call has a fixed charge of 2.07 credits. 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 | No | 查询热门标签榜单的请求对象,可包含分页设置、时间范围、国家/地区代码,以及可选的一级行业筛选和自定义 Cookie。 | — |
request_body.page | integer | No | 页码/Page number | 1 |
request_body.limit | integer | No | 每页数量/Items per page | 20 |
request_body.cookie | string | No | 自定义Cookie字符串(可选)/Custom Cookie string (optional) | — |
request_body.time_range | integer | No | 时间范围(天):7/30/90 /Time range in days | 7 |
request_body.industry_id | integer | No | 一级行业ID(可选),如10000000000=Education/First-level industry ID (optional) | — |
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_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"country_code": "TH",
"industry_id": 11101000000,
"limit": 20,
"page": 1,
"time_range": 30
}
}
}'{
"code": 200,
"data": {
"BaseResp": {
"StatusCode": 0,
"StatusMessage": ""
},
"items": [],
"pagination": {
"hasMore": false,
"limit": 20,
"page": 1,
"totalCount": 0
}
},
"docs": "https://api.tikhub.io/#/TikTok-Ads-API/get_trends_hashtag_list_api_v1_tiktok_ads_get_trends_hashtag_list_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.

