TikTok Ads Search Ads
2.07 credits/call
ae_tiktok_ads_search_ads
用于搜索短视频广告创意库中的广告素材,帮助进行创意研究、灵感收集和竞品参考。可在 request_body 中按关键词、广告目标、表现排名、时间范围、行业、页码、每页数量、排序、国家或地区、广告格式、语言、视频时长和创意趋势标签等条件筛选;也可传入搜索 ID 或自定义 Cookie。未填写的筛选条件不参与过滤,页码、每页数量、时间范围、排序方式和国家代码有默认值。返回结果通常包含 data,其中可见 materials 广告素材列表和 pagination 分页信息;素材可能包含素材 ID、视频 ID、描述、创建时间、视频封面与时长、点赞/评论/分享统计,以及广告主和落地页信息。
2.07 credits/call
Pricing
2.07 credits/call
| 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 | No | 用于提交广告创意搜索条件的请求体对象;可按需包含关键词、广告目标、表现分位、时间范围、行业、页码、每页数量、排序方式、国家代码、广告格式、广告语言、视频时长、创意趋势标签、搜索 ID 和自定义 Cookie 等字段。 | — |
request_body.like | integer | null | No | 表现排名(可选)/Performance rank (optional; 1:前1-20% 2:前21-40% 3:前41-60% 4:前61-80% 5:前81-100%) | — |
request_body.page | integer | No | 页码/Page number | 1 |
request_body.limit | integer | No | 每页数量/Items per page | 20 |
request_body.cookie | string | No | 自定义Cookie字符串(可选) | — |
request_body.period | integer | No | 时间段/Time period (days) | 180 |
request_body.keyword | string | No | 搜索关键词/Search keyword | — |
request_body.duration | integer | null | No | 视频时长筛选值(可选)/Video duration filter value (optional) | — |
request_body.industry | string | No | 行业ID/Industry ID | — |
request_body.order_by | string | No | 排序方式/Sort by (for_you, likes) | for_you |
request_body.ad_format | integer | null | No | 广告格式(可选)/Ad format (optional; 1:Spark Ads 2:Non-Spark Ads) | — |
request_body.objective | integer | null | No | 广告目标类型(可选)/Ad objective (optional; 1:流量 2:应用安装 3:转化 4:视频浏览 5:触达 6:潜在客户 7:产品销售) | — |
request_body.search_id | string | No | 搜索ID(可选)/Search ID (optional) | — |
request_body.ad_language | string | null | No | 广告语言(可选)/Ad language (optional) | — |
request_body.country_code | string | No | 国家代码/Country code | US |
request_body.pattern_label | string | null | No | 创意趋势标签(可选)/Creative pattern label (optional) | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_ads_search_ads' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"country_code": "CN",
"keyword": "心理咨询师",
"like": 1,
"limit": 20,
"order_by": "likes",
"period": 30
}
}
}'Response exampleresponse.json
{
"code": 200,
"data": {
"code": 0,
"data": {
"materials": [],
"pagination": {
"has_more": false,
"page": 1,
"size": 20,
"total_count": 0
}
},
"msg": "OK"
},
"docs": "https://api.tikhub.io/#/TikTok-Ads-API/search_ads_api_v1_tiktok_ads_search_ads_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.

