TikTok Ads Search Ads

2.07 credits/call
ae_tiktok_ads_search_ads

用于搜索短视频广告创意库中的广告素材,帮助进行创意研究、灵感收集和竞品参考。可在 request_body 中按关键词、广告目标、表现排名、时间范围、行业、页码、每页数量、排序、国家或地区、广告格式、语言、视频时长和创意趋势标签等条件筛选;也可传入搜索 ID 或自定义 Cookie。未填写的筛选条件不参与过滤,页码、每页数量、时间范围、排序方式和国家代码有默认值。返回结果通常包含 data,其中可见 materials 广告素材列表和 pagination 分页信息;素材可能包含素材 ID、视频 ID、描述、创建时间、视频封面与时长、点赞/评论/分享统计,以及广告主和落地页信息。

VideoSocial
2.07 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
request_bodyobjectNo用于提交广告创意搜索条件的请求体对象;可按需包含关键词、广告目标、表现分位、时间范围、行业、页码、每页数量、排序方式、国家代码、广告格式、广告语言、视频时长、创意趋势标签、搜索 ID 和自定义 Cookie 等字段。—
request_body.likeinteger | nullNo表现排名(可选)/Performance rank (optional; 1:前1-20% 2:前21-40% 3:前41-60% 4:前61-80% 5:前81-100%)—
request_body.pageintegerNo页码/Page number1
request_body.limitintegerNo每页数量/Items per page20
request_body.cookiestringNo自定义Cookie字符串(可选)—
request_body.periodintegerNo时间段/Time period (days)180
request_body.keywordstringNo搜索关键词/Search keyword—
request_body.durationinteger | nullNo视频时长筛选值(可选)/Video duration filter value (optional)—
request_body.industrystringNo行业ID/Industry ID—
request_body.order_bystringNo排序方式/Sort by (for_you, likes)for_you
request_body.ad_formatinteger | nullNo广告格式(可选)/Ad format (optional; 1:Spark Ads 2:Non-Spark Ads)—
request_body.objectiveinteger | nullNo广告目标类型(可选)/Ad objective (optional; 1:流量 2:应用安装 3:转化 4:视频浏览 5:触达 6:潜在客户 7:产品销售)—
request_body.search_idstringNo搜索ID(可选)/Search ID (optional)—
request_body.ad_languagestring | nullNo广告语言(可选)/Ad language (optional)—
request_body.country_codestringNo国家代码/Country codeUS
request_body.pattern_labelstring | nullNo创意趋势标签(可选)/Creative pattern label (optional)—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request 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
JSONPartial content
{
  "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.