TikTok API

TikTok 广告库搜索 API

按关键词或广告主搜索 TikTok 公开的 Ads Library(广告主、标题、受众区间、投放日期、广告库链接和视频)。

POST/v1/run/tiktok.ad_library_search
可用率
42.86%
30d · 42 次调用
请求数
42
30d · 按周,近 12 周
响应时间
2.6s
中位数 · 30d

价格

一个价格,以美元计

标记为暂停服务的服务商因响应不稳定,已移出轮换,你的调用会转到其他服务商。它恢复稳定响应后会自动重新加入。

试一试

发出你的第一个请求

打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "ads": [
      {
        "adId": "a1b2c3d4",
        "adTitle": "Example title",
        "brandName": "Acme Inc",
        "coverUrl": "https://example.com/page",
        "estimatedAudience": "example",
        "firstShownUtc": 42,
        "format": "example",
        "lastShownUtc": 42,
        "status": "active",
        "url": "https://example.com/page",
        "videoUrl": "https://example.com/page"
      }
    ],
    "hasMore": true,
    "nextCursor": "example",
    "total": 12500
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface TiktokAdLibrarySearchResponse {
  data: {
    ads: {
      adId: string;
      adTitle: string;
      brandName: string;
      coverUrl: string;
      estimatedAudience: string;
      firstShownUtc?: number;
      format?: string;
      lastShownUtc?: number;
      status?: string;
      url?: string;
      videoUrl: string;
    }[];
    hasMore: boolean;
    nextCursor: string | null;
    total: number;
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/tiktok.ad_library_search
curl -X POST https://api.getanyapi.com/v1/run/tiktok.ad_library_search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"spotify"}'
字段类型示例值
请求体
advertiserNamestring要列出广告的广告主名称(例如 Spotify)。advertiserName 和 query 二选一,不能同时提供。
cursorstring来自上一次响应 nextCursor 的不透明游标。第一页请省略。
querystring"spotify"用于搜索广告标题和内容的关键词(例如 spotify)。query 和 advertiserName 二选一,不能同时提供。
regionstringTikTok Commercial Content Library 的两字母地区代码,例如 DE、FR、GB 或 IT。每个地区收录的广告各不相同。省略时使用该库自身的默认地区 DE。覆盖范围为欧盟和欧洲经济区;US 等非欧盟代码不予处理。
响应
dataobject
data.adsobject[]Populated whenever the provider has data for the entity.
data.ads[].adIdstringTikTok ad id. Populated whenever the provider has data for the entity.
data.ads[].adTitlestringAd title as shown in TikTok's ad library. Populated whenever the provider has data for the entity.
data.ads[].brandNamestringAdvertiser name on the ad.
data.ads[].coverUrlstringCover image URL of the ad's first video. Populated whenever the provider has data for the entity.
data.ads[].estimatedAudiencestringAudience size band TikTok publishes for the ad, for example "100K-200K".
data.ads[].firstShownUtcintegerUTC epoch timestamp in seconds (Unix time) when TikTok first showed the ad. Multiply by 1000 for a JS Date in milliseconds.
data.ads[].formatstringTikTok's creative format code for the ad, as the ad library reports it.
data.ads[].lastShownUtcintegerUTC epoch timestamp in seconds (Unix time) when TikTok last showed the ad. Multiply by 1000 for a JS Date in milliseconds.
data.ads[].statusstringTikTok's audit status code for the ad, as the ad library reports it.
data.ads[].urlstringLink to the ad's detail page in TikTok's public Ads Library.
data.ads[].videoUrlstringPlayable URL of the ad's first video. Populated whenever the provider has data for the entity.
data.hasMoreboolean
data.nextCursorstringOpaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue.
data.totalinteger
foundboolean
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.ad_library_search,就以统一格式的 JSON 返回 TikTok 数据。按关键词或广告主搜索 TikTok 公开的 Ads Library(广告主、标题、受众区间、投放日期、广告库链接和视频)。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 TikTok 广告库搜索 API 调用中有 42.9% 成功,响应时间中位数为 2.6 秒,共测量 42 次调用。

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

按关键词或广告主搜索 TikTok 公开的 Ads Library(广告主、标题、受众区间、投放日期、广告库链接和视频)。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

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