Skip to main content
POST
tiktok search_ads
搜索广告 计费 — 按成功调用计费,最终扣费按你的套餐倍率浮动。仅当上游响应体 code 为 200 时计费。

示例

请求规范

完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

公开参考价格:每次成功请求 $0.001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.001
  • 计费依据: fixed_success
  • 公开参考倍率: 1.0
  • 结算证据来源: request_snapshot

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
ad_format
integer | null

Ad format (optional): 1=Spark Ads, 2=Non-Spark Ads

ad_language
string | null

Ad language (optional)

Custom Cookie string, optional parameter, can be used to fetch more data

country_code
string
默认值:US

Country code

duration
integer | null

Video duration filter value (optional)

industry
string

Industry ID list, multiple IDs separated by commas. Full industry ID list: https://github.com/TikHub/TikTok-Ads-Industry-Code

keyword
string

Search keyword, optional, returns all ads if empty

like
integer | null

Performance rank (optional; 1=top 1-20%, 2=top 21-40%, 3=top 41-60%, 4=top 61-80%, 5=top 81-100%)

limit
integer
默认值:20

Items per page, default 20, max 50

必填范围: x <= 50
objective
integer | null

Ad objective (optional): 1=Traffic, 2=App install, 3=Conversion, 4=Video views, 5=Reach, 6=Lead generation, 7=Product sales

order_by
string
默认值:for_you

Sort method, "for_you"=Recommended, "likes"=Sort by likes

page
integer
默认值:1

Page number, default 1

pattern_label
string | null

Creative pattern label (optional)

period
integer
默认值:180

Time period in days, e.g., 7, 30, 120, 180 days

search_id
string

Search ID (optional)

响应

Successful Response

Return Description

  • materials: List of ad materials
    • id: Ad material ID
    • aweme_id: Ad video ID
    • desc: Ad description
    • create_time: Creation time
    • video_info: Video information
      • cover: Cover image URL
      • duration: Duration in seconds
    • statistics: Statistics
      • digg_count: Number of likes
      • comment_count: Number of comments
      • share_count: Number of shares
    • ads_info: Ad information
      • advertiser_name: Advertiser name
      • landing_page: Landing page URL
  • pagination: Pagination info
    • page: Current page
    • limit: Items per page
    • total: Total count
    • has_more: Whether there are more items

The media-type example is an illustrative response from the official documentation, not a live response. Its router and params metadata use upstream naming.

cache_message
string | null
默认值:This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.

Cache message (EN-US)

cache_message_zh
string | null
默认值:本次响应已缓存,可通过下方 URL 直接查看,有效期 24 小时,访问缓存链接无额外费用。缓存仅用于请求溯源,不影响接口数据的时效性,也不会再次通过接口返回。

Cache message (ZH-CN)

cache_url
string | null

The URL to access the cached result

code
integer
默认值:200

HTTP 状态码

data
any

Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.

docs
string | null

Link to the API Swagger documentation for this endpoint

message
string
默认值:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh
string
默认值:请求成功,本次请求将被计费。

Response message (ZH-CN)

params
any
默认值:{}

The parameters used in the request

request_id
string | null

Unique request identifier

router
string
默认值:""

The endpoint that generated this response

support
string
默认值:Discord: https://discord.gg/aMEAS8Xsvz

Support message

time
string

The time the response was generated

time_stamp
integer

The timestamp the response was generated

time_zone
string
默认值:America/Los_Angeles

The timezone of the response time