TikTok API
TikTok 广告透明度搜索 API
按关键词或广告主 ID 搜索 TikTok 的欧盟 Commercial Content Library。
POST/v1/run/tiktok.ad_transparency_search
可用率
99.92%
30d · 1,301 次调用
请求数
1,301
30d · 按周,近 12 周
响应时间
2.5s
中位数 · 30d
试一试
发出你的第一个请求
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"ads": [
{
"adTitle": "Example title",
"advertiserName": "Example title",
"estimatedAudience": "example",
"firstShownUtc": 12.5,
"format": "example",
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"lastShownUtc": 12.5,
"status": "active",
"videoUrl": "https://example.com/page"
}
],
"hasMore": true,
"nextCursor": "example",
"offset": 42,
"region": "CA",
"total": 12500
},
"found": true,
"reason": "not_found"
}响应类型定义
interface TiktokAdTransparencySearchResponse {
data: {
ads: {
adTitle?: string;
advertiserName?: string;
estimatedAudience?: string;
firstShownUtc?: number;
format?: string;
id: string;
image?: string;
lastShownUtc?: number;
status?: string;
videoUrl?: string;
}[];
hasMore: boolean;
nextCursor: string | null;
offset: number;
region: string;
total: number;
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/tiktok.ad_transparency_search
curl -X POST https://api.getanyapi.com/v1/run/tiktok.ad_transparency_search \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"days":30,"limit":20,"query":"nike","region":"DE"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| advertiserId | string | TikTok Commercial Content Library 的广告主 ID。请提供 advertiserId 或 query。 |
| cursor | string | 来自上一次响应 nextCursor 的搜索游标。 |
| days | integer | 30要搜索的 Commercial Content Library 历史天数,取值 1 到 365。默认 30。 |
| limit | integer | 20最多返回的广告数,取值 1 到 50。默认 20。按请求固定计费。 |
| offset | integer | 从 0 开始的结果偏移量。默认 0。 |
| query | string | "nike"在 TikTok 欧盟 Commercial Content Library 中搜索的关键词。请提供 query 或 advertiserId。 |
| region | string | "DE"透明度搜索的地区代码。默认 DE。 |
| sort | string | 上游排序表达式。默认 last_shown_date,desc。 |
| 响应 | ||
| data | object | Ad transparency search results and pagination, or null when no ads were found. |
| data.ads | object[] | Commercial Content Library ad records returned for the search. Populated whenever the provider has data for the entity. |
| data.ads[].adTitle | string | Ad title as shown in TikTok's ad library. |
| data.ads[].advertiserName | string | Advertiser display name associated with the ad. Populated whenever the provider has data for the entity. |
| data.ads[].estimatedAudience | string | Estimated audience size band the ad reached, as a range string. |
| data.ads[].firstShownUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was first shown. Populated whenever the provider has data for the entity. |
| data.ads[].format | string | Commercial Content Library creative format code for the ad. Populated whenever the provider has data for the entity. |
| data.ads[].id | string | TikTok Commercial Content Library ad identifier. Populated whenever the provider has data for the entity. |
| data.ads[].image | string | Signed cover image URL exactly as returned by the Commercial Content Library. Populated whenever the provider has data for the entity. |
| data.ads[].lastShownUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was last shown. Populated whenever the provider has data for the entity. |
| data.ads[].status | string | Commercial Content Library audit status code for the ad. Populated whenever the provider has data for the entity. |
| data.ads[].videoUrl | string | Signed video asset URL exactly as returned by the Commercial Content Library. Populated whenever the provider has data for the entity. |
| data.hasMore | boolean | Whether the Commercial Content Library reports more matching ads. Populated whenever the provider has data for the entity. |
| data.nextCursor | string | Search cursor to pass as cursor on a subsequent request, or null when there is no next page. Populated whenever the provider has data for the entity. |
| data.offset | integer | Zero-based result offset reported for this page. |
| data.region | string | Region code applied to this transparency search. Populated whenever the provider has data for the entity. |
| data.total | integer | Total number of matching ads reported by the Commercial Content Library. Populated whenever the provider has data for the entity. |
| found | boolean | True when TikTok's EU Commercial Content Library returned at least one 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.0005 |
| 价格(/千次请求) | USD | US$0.50 |
常见问题
关于 TikTok 广告透明度搜索 API
AnyAPI 的 TikTok 广告透明度搜索 API 只需一次 POST 请求 /v1/run/tiktok.ad_transparency_search,就以统一格式的 JSON 返回 TikTok 数据。按关键词或广告主 ID 搜索 TikTok 的欧盟 Commercial Content Library。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$0.50 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 TikTok 广告透明度搜索 API 调用中有 99.9% 成功,响应时间中位数为 2.5 秒,共测量 1,301 次调用。
费用:每千次请求 US$0.50 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
按关键词或广告主 ID 搜索 TikTok 的欧盟 Commercial Content Library。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 TikTok 广告透明度搜索 API 调用中有 99.9% 成功,响应时间中位数为 2.5 秒,共测量 1,301 次调用。这些是 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$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$1.20 起热门推荐流/千次请求 US$0.80 起热门话题标签/千次请求 US$1.20 起视频下载/千次请求 US$0.90 起视频转录文本(完整版)/千分钟音频 US$5.94 起