TikTok Ads Get Trends Hashtag List

2.07 credits/call
ae_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`:分页信息,包括当前页、每页数量、总数和是否还有更多结果。 如果筛选条件较多导致没有结果,可尝试扩大时间范围、取消行业筛选或调整其他筛选条件。结果来自已收录的热门数据,可能不代表完整数据集。

SocialResearch
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectNo查询热门标签榜单的请求对象,可包含分页设置、时间范围、国家/地区代码,以及可选的一级行业筛选和自定义 Cookie。—
request_body.pageintegerNo页码/Page number1
request_body.limitintegerNo每页数量/Items per page20
request_body.cookiestringNo自定义Cookie字符串(可选)/Custom Cookie string (optional)—
request_body.time_rangeintegerNo时间范围(天):7/30/90 /Time range in days7
request_body.industry_idintegerNo一级行业ID(可选),如10000000000=Education/First-level industry ID (optional)—
request_body.country_codestringNo国家/地区代码/Country codeUS

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
Response exampleresponse.json
JSONPartial content

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