google-ad-library/
ad

通过准确的公开 Google Ads Transparency Center 创意 URL 获取单条广告,返回标准化的广告主、文案、媒体、投放日期、地区、格式、目标链接和可用展示次数。

Google Ad Library Ad API

准确创意 URL
广告主与媒体
公开投放信息
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Google Ad Library Ad

Google Ads Transparency Center 创意是包含广告主身份、可见文案与媒体、目标链接、格式、投放日期、地区和可用展示数据的公开广告记录。这些信息可用于核验创意、补全选定广告、研究投放范围并比较不同采集时间的归档记录。

Google Ad Library Ad API 主要特性

  • 准确解析单条创意将一个路径含 /creative/ 的 adstransparency.google.com URL 解析为最多一条标准化公开广告记录,不会将请求扩大为搜索。
  • 广告主与创意字段以稳定广告结构返回创意标识、公开来源 URL、可用文本、广告主引用、目标链接和格式。
  • 投放范围信息保留可用的开始与结束日期、国家、展示平台,并仅在来源数据可安全标准化时提供单值展示次数。
  • 标准化媒体素材提供可用图片或视频的地址、缩略图、尺寸和时长,同时省略缺失的可选值。

Google Ad Library Ad API 参数

参数必填描述
url必填必填的公开 Google Ads Transparency Center 创意 URL。协议必须是 http 或 https,主机名必须以 adstransparency.google.com 结尾,路径必须包含 /creative/。

如何使用 Google Ad Library Ad API

提交一个准确的公开创意 URL,跟踪异步任务,并从标准结果结构中读取广告记录。

  1. 准备一个 adstransparency.google.com 上的 http 或 https URL,路径必须包含 /creative/。
  2. 将 url POST 到 /v1/google-ad-library/ad,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或失败。
  4. 读取 data.results.items;详情操作最多返回一条记录,因此 has_more 通常为 false,next_cursor 通常为 null。
curl -X POST "https://api.socq.ai/v1/google-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217"}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items;详情操作最多返回一条记录

Google Ad Library Ad API 最佳使用场景

  • 补全选定创意: 使用创意 ID、广告主引用、文案、目标链接、格式、媒体和来源 URL,完善此前发现的广告记录。
  • 复核公开投放证据: 比较可用日期、国家、展示平台和展示次数,记录已知创意曾在何时何地公开展示。
  • 归档创意快照: 保存标准化文本、媒体、广告主、投放、目标链接和 collected_at 字段,供后续比较不同时间点。

Google Ad Library Ad API 使用建议

  • 提交完整创意 URL,不要只填 CR 标识或广告主 URL,确保主机名和 /creative/ 路径通过校验。
  • 区分任务成功但没有记录与供应服务失败;被移除、受限或当前不可用的创意可能无法形成可用记录。
  • 将投放、文本、目标链接、广告主、展示次数和媒体作为可空字段处理,不要把缺失的公开值转换为零或推断性结论。
  • 需要发现广告主或枚举广告时使用对应搜索与公司广告接口;该详情操作只解析提交的创意。

除了 Google Ad Library Ad API,需要其他类型的 Google Ad Library 公开数据时,可以使用以下 API。

  • Google Ad Library Advertiser Search API — 按 query 和可选 region 发现公开 Transparency Center 广告主候选,返回身份、网站、徽标、地区和可用广告数量字段。
  • Google Ad Library Company Ads API — 按公司域名或广告主 ID 采集公开 Transparency Center 创意,并支持主题、地区、日期、Google 界面、格式和结果数量控制。

探索其他平台

还可以将 Google Ad Library 数据与其他已支持社交平台的公开数据结合使用。

Google Ad Library Ad API — 常见问题

Google Ad Library Ad API 是一个用于通过准确 URL 获取单条公开 Google Ads Transparency Center 创意的 API。它返回标准化的广告主、文案、媒体、投放、地区、格式、目标链接和可用展示次数字段。

提交一个 http 或 https URL,主机名须以 adstransparency.google.com 结尾,路径须包含 /creative/。裸创意 ID、广告主 URL、域名、查询词和 URL 列表均不接受。

标准化记录声明标识、来源 URL、文本、广告主、投放日期、国家、展示平台、格式、目标链接、展示次数、媒体、发布时间和采集时间。来源相关字段可为空,媒体也可能是空数组。

有效创意 URL 可能指向已移除、受限、来源结构异常或当前不可用的公开记录。该接口不会替换成其它创意,也不会把详情请求改成搜索。

每条返回记录消耗 0.5 SocQ 积分。没有返回记录时,当前空结果策略只收取为零的基础费用。