TikTok API

TikTok 热门广告搜索 API

按关键词搜索 TikTok Creative Center 的热门视频广告,可按推广目标、效果百分位和时间窗口筛选。

POST/v1/run/tiktok.top_ads_search
可用率
100.00%
30d · 708 次调用
请求数
802
30d · 按周,近 12 周
响应时间
0.9s
中位数 · 30d

价格

一个价格,以美元计

试一试

发出你的第一个请求

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "ads": [
      {
        "adId": "a1b2c3d4",
        "adTitle": "Example title",
        "brandName": "Acme Inc",
        "cost": 19.99,
        "ctr": 12.5,
        "durationSeconds": 12.5,
        "height": 42,
        "image": "https://example.com/image.jpg",
        "industry": "general",
        "likes": 12500,
        "objective": "example",
        "videoUrl": "https://example.com/page",
        "width": 1024
      }
    ],
    "hasMore": true,
    "page": 29,
    "pageSize": 29,
    "total": 12500
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface TiktokTopAdsSearchResponse {
  data: {
    ads: {
      adId: string;
      adTitle?: string;
      brandName?: string;
      cost?: number;
      ctr?: number;
      durationSeconds?: number;
      height?: number;
      image?: string;
      industry?: string;
      likes?: number;
      objective?: string;
      videoUrl?: string;
      width?: number;
    }[];
    hasMore: boolean;
    page: number;
    pageSize: number;
    total: number;
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考:这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/tiktok.top_ads_search
curl -X POST https://api.getanyapi.com/v1/run/tiktok.top_ads_search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"glasses"}'
字段类型示例值
请求体
querystring"glasses"在 TikTok Creative Center 热门视频广告中搜索的关键词。
limitinteger本页请求的最多广告数,取值 1 到 20(默认 20)。
objectiveenum推广目标筛选。省略时搜索所有目标。
pageinteger从 1 开始的服务商页码(默认 1)。
performanceRankenum广告效果百分位区间,其中 top_1_20 表示效果最好的前 20%。省略时搜索所有区间。
periodenum回溯天数(默认 180)。
响应
dataobjectTop-ad results and page metadata, or null when no matching ads were found.
data.adsobject[]TikTok Creative Center top-ad records returned for this page. Populated whenever the provider has data for the entity.
data.ads[].adIdstringTikTok Creative Center ad material identifier. Populated whenever the provider has data for the entity.
data.ads[].adTitlestringTitle or primary copy shown for the ad. Populated whenever the provider has data for the entity.
data.ads[].brandNamestringAdvertiser brand name when supplied by TikTok Creative Center. Populated whenever the provider has data for the entity.
data.ads[].costnumberTikTok Creative Center's relative cost ranking value for the ad. Populated whenever the provider has data for the entity.
data.ads[].ctrnumberTikTok Creative Center's click-through rate value for the ad. Populated whenever the provider has data for the entity.
data.ads[].durationSecondsnumberVideo duration in seconds. Populated whenever the provider has data for the entity.
data.ads[].heightintegerVideo height in pixels. Populated whenever the provider has data for the entity.
data.ads[].imagestringSigned video cover image URL exactly as returned by TikTok Creative Center. Populated whenever the provider has data for the entity.
data.ads[].industrystringTikTok Creative Center industry classification key. Populated whenever the provider has data for the entity.
data.ads[].likesintegerNumber of likes reported for the ad. Populated whenever the provider has data for the entity.
data.ads[].objectivestringTikTok Creative Center campaign objective key. Populated whenever the provider has data for the entity.
data.ads[].videoUrlstringSigned 720p video asset URL exactly as returned by TikTok Creative Center. Populated whenever the provider has data for the entity.
data.ads[].widthintegerVideo width in pixels. Populated whenever the provider has data for the entity.
data.hasMorebooleanWhether TikTok Creative Center reports another page of matching ads. Populated whenever the provider has data for the entity.
data.pageintegerOne-based page number reported by TikTok Creative Center. Populated whenever the provider has data for the entity.
data.pageSizeintegerPage size reported by TikTok Creative Center. Populated whenever the provider has data for the entity.
data.totalintegerTotal number of matching top ads reported by TikTok Creative Center. Populated whenever the provider has data for the entity.
foundbooleanTrue when TikTok Creative Center returned at least one matching top ad.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
价格
每次请求价格USDUS$0.0012
价格(/千次请求)USDUS$1.20

常见问题

关于 TikTok 热门广告搜索 API

AnyAPI 的 TikTok 热门广告搜索 API 只需一次 POST 请求 /v1/run/tiktok.top_ads_search,就以统一格式的 JSON 返回 TikTok 数据。按关键词搜索 TikTok Creative Center 的热门视频广告,可按推广目标、效果百分位和时间窗口筛选。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 TikTok 热门广告搜索 API 调用中有 100.0% 成功,响应时间中位数为 0.9 秒,共测量 708 次调用。

费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

按关键词搜索 TikTok Creative Center 的热门视频广告,可按推广目标、效果百分位和时间窗口筛选。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 TikTok 热门广告搜索 API 调用中有 100.0% 成功,响应时间中位数为 0.9 秒,共测量 708 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。