Ad(广告)对象

4 个平台的 11 个接口都返回 Ad(广告)对象,14 个字段名完全一样,给一个平台写的代码不用改就能读其他平台。每次调用 $0.0020。它是预览结构,之后可能调整。

预览对象 · 更新于 2026-10-17在 ChatGPT 里打开在 Claude 里打开

广告(Ad)是平台公开广告库,或 TikTok 创意中心的热门广告里列出的一条广告:素材形态、标题、文案、图片和视频、落地页、广告主,广告库里还有开始和最近投放的时间。标准字段里没有花了多少钱;展示量区间、互动数、定向,平台给的话放在 ext。

advertiser 是投这条广告的人,有编号的广告库还带 id;按名称查到的广告主可以列出它的广告。Meta 广告库里视频广告说的话,用逐字稿取。

字段

平台给不了的字段不会出现在这条数据里,而是写在 meta.unavailable 里。不会用猜的数或 0 顶上。

id 文本

编号,可原样传给取广告详情的接口

url 链接

这条广告在平台广告库里的页面

format 文本

素材形态;other 是平台自己的其他形式:video image carousel text other

title 文本

标题

text 文本

文案

landing_url 链接 standard

点击后去的地址

advertiser 对象

广告主

advertiser.id 文本

广告主编号

advertiser.name 文本

广告主名称

advertiser.url 链接 standard

广告主在平台上的主页

advertiser.avatar_url 链接 standard

广告主的头像或标志

images 链接列表 standard

图片素材的地址

videos 链接列表 full

视频素材的地址,会过期

first_shown_at 时间

开始投放的时间

last_shown_at 时间

最近一次投放的时间;还在投的广告是平台最近一次看到它的时间

哪些平台给不了哪些字段

一个平台的所有接口都给不了某个字段时,它才列在那个字段后面。

字段给不了的平台
advertiser.urlTikTokGoogle 广告
advertiser.avatar_urlTikTokGoogle 广告
同一个平台上,可能一个接口给不了、另一个接口能给:每个接口的页面列着它给不了的字段,每次返回也都写在 meta.unavailable 里。

返回 Ad(广告)的接口

每个平台旁边的数字,是它有几个接口返回这种对象。

接口路径价格
TikTok 广告库搜索GET/v1/tiktok/ads/search$0.0020
TikTok 广告库广告详情GET/v1/tiktok/ads/get$0.0020
TikTok 创意中心热门广告详情GET/v1/tiktok/creative_center/ads/get$0.0020
TikTok 创意中心热门广告搜索GET/v1/tiktok/creative_center/ads/search$0.0020
LinkedIn 广告详情GET/v1/linkedin/ads/get$0.0020
LinkedIn 广告库搜索GET/v1/linkedin/ads/search$0.0020
Meta 广告详情GET/v1/meta/ads/get$0.0020
Meta 广告库搜索GET/v1/meta/ads/search$0.0020
Meta 广告主的广告GET/v1/meta/advertisers/ads/list$0.0020
Google 广告详情GET/v1/google/ads/get$0.0020
Google 广告主的广告GET/v1/google/advertisers/ads/list$0.0020

示例

tiktok.ads.search 返回的一条,录制于 2026-10-12 22:12 UTC。名字、正文和编号是示例,链接也是;数字是原样。

Ad(广告) · tiktok.ads.search
{
  "id": "1886449558577687",
  "url": "https://library.tiktok.com/ads/detail/?ad_id=1886449558577687",
  "format": null,
  "title": "Start running shoes with the kit made for beginners",
  "advertiser": { "id": null, "name": "Brightline Studio" },
  "images": [],
  "first_shown_at": "2026-09-29T00:00:00.000Z",
  "last_shown_at": "2026-09-30T00:00:00.000Z"
}

完整的返回在这个接口的页面上 →

相关

其他对象