Ad(广告)对象
4 个平台的 11 个接口都返回 Ad(广告)对象,14 个字段名完全一样,给一个平台写的代码不用改就能读其他平台。每次调用 $0.0020。它是预览结构,之后可能调整。
广告(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.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"
}相关
其他对象
Post(内容)对象Comment(评论)对象Account(账号)对象Trend(热点)对象Transcript(逐字稿)对象Creator rates(达人报价)对象Community(社区)对象Product(商品)对象Review(评价)对象Keyword index history(关键词指数历史)对象Related keyword(关联词)对象Keyword audience(关键词人群画像)对象Account recent change(账号近期变化)对象Brand index history(品牌指数历史)对象Brand index averages(品牌指数均值)对象Creator(达人)对象Audience(粉丝画像)对象Xingtu creator metrics(星图达人传播数据)对象Xingtu creator video(星图达人作品)对象PGY creator metrics(蒲公英博主数据表现)对象PGY creator note(蒲公英博主笔记)对象Advertiser(广告主)对象Douyin trend-index creator metrics(巨量算数达人核心指标)对象Xingtu creator content keywords(星图达人内容热词)对象Xingtu creator scores(星图达人指数)对象Xingtu creator content mix(星图达人内容分布)对象Xingtu creator conversion(星图达人转化能力)对象Xingtu campaign(星图营销活动)对象Channels collection(视频号合集)对象Topic(话题)对象