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"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| query | string | "glasses"在 TikTok Creative Center 热门视频广告中搜索的关键词。 |
| limit | integer | 本页请求的最多广告数,取值 1 到 20(默认 20)。 |
| objective | enum | 推广目标筛选。省略时搜索所有目标。 |
| page | integer | 从 1 开始的服务商页码(默认 1)。 |
| performanceRank | enum | 广告效果百分位区间,其中 top_1_20 表示效果最好的前 20%。省略时搜索所有区间。 |
| period | enum | 回溯天数(默认 180)。 |
| 响应 | ||
| data | object | Top-ad results and page metadata, or null when no matching ads were found. |
| data.ads | object[] | TikTok Creative Center top-ad records returned for this page. Populated whenever the provider has data for the entity. |
| data.ads[].adId | string | TikTok Creative Center ad material identifier. Populated whenever the provider has data for the entity. |
| data.ads[].adTitle | string | Title or primary copy shown for the ad. Populated whenever the provider has data for the entity. |
| data.ads[].brandName | string | Advertiser brand name when supplied by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| data.ads[].cost | number | TikTok Creative Center's relative cost ranking value for the ad. Populated whenever the provider has data for the entity. |
| data.ads[].ctr | number | TikTok Creative Center's click-through rate value for the ad. Populated whenever the provider has data for the entity. |
| data.ads[].durationSeconds | number | Video duration in seconds. Populated whenever the provider has data for the entity. |
| data.ads[].height | integer | Video height in pixels. Populated whenever the provider has data for the entity. |
| data.ads[].image | string | Signed video cover image URL exactly as returned by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| data.ads[].industry | string | TikTok Creative Center industry classification key. Populated whenever the provider has data for the entity. |
| data.ads[].likes | integer | Number of likes reported for the ad. Populated whenever the provider has data for the entity. |
| data.ads[].objective | string | TikTok Creative Center campaign objective key. Populated whenever the provider has data for the entity. |
| data.ads[].videoUrl | string | Signed 720p video asset URL exactly as returned by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| data.ads[].width | integer | Video width in pixels. Populated whenever the provider has data for the entity. |
| data.hasMore | boolean | Whether TikTok Creative Center reports another page of matching ads. Populated whenever the provider has data for the entity. |
| data.page | integer | One-based page number reported by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| data.pageSize | integer | Page size reported by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| data.total | integer | Total number of matching top ads reported by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| found | boolean | True 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. |
| 价格 | ||
| 每次请求价格 | USD | US$0.0012 |
| 价格(/千次请求) | USD | US$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 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。
更多接口
TikTok 的其他接口
主页/千次请求 US$0.45 起主页视频/千次请求 US$0.70 起视频转录文本/千次请求 US$1.20 起关键词搜索/千次请求 US$0.70 起视频/千次请求 US$0.45 起视频评论/千次请求 US$0.70 起用户搜索/千次请求 US$0.70 起广告库广告/千次请求 US$1.20 起广告库搜索/千次请求 US$1.20 起广告透明度搜索/千次请求 US$0.50 起受众人口统计/千次请求 US$18.00 起评论回复/千次请求 US$0.90 起粉丝/千次请求 US$0.95 起关注列表/千次请求 US$0.95 起话题标签视频/千次请求 US$0.80 起直播/千次请求 US$1.20 起照片/千次请求 US$1.20 起播放列表视频/千次请求 US$1.20 起主页联系方式/千次请求 US$1.16 起主页播放列表/千次请求 US$1.20 起主页地区/千次请求 US$1.20 起主页转发/千次请求 US$1.20 起搜索话题标签/千次请求 US$1.20 起搜索图文/千次请求 US$1.20 起搜索建议/千次请求 US$0.95 起搜索热门结果/千次请求 US$0.90 起歌曲/千次请求 US$0.90 起歌曲视频/千次请求 US$0.90 起热门推荐流/千次请求 US$0.80 起热门话题标签/千次请求 US$1.20 起视频下载/千次请求 US$0.90 起视频转录文本(完整版)/千分钟音频 US$5.94 起