google-ad-library/
advertiser-search

按查询词和可选地区发现公开 Google Ads Transparency Center 广告主候选,返回标准化身份、网站、Logo、地区和可用广告数量字段。

Google Ad Library Advertiser Search API

广告主候选
可选地区上下文
稳定身份字段
每条结果 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Google Ad Library Advertiser Search

Google Ad Library Advertiser Search 根据广告主、品牌、组织名称或网站查询 Google Ads Transparency Center 中的公开广告主。接口返回广告主 ID、名称、网站、Logo、地区和可用广告数量,便于核验广告主身份并继续采集其公开广告。

Google Ad Library Advertiser Search API 主要特性

  • 按名称发现广告主使用一个非空品牌、组织、广告主或网站词搜索,返回标准化广告主候选,而不是广告创意。
  • 可选地区上下文传入 US 等地区为上游搜索提供地理上下文,同时明确区分广告主地区与广告投放地区。
  • 候选身份字段比较公开广告主 ID、名称、URL、网站、Logo、地区和来源提供的广告数量,不推断或补全缺失值。
  • 保存单次完整响应保存一次上游搜索响应中的所有可用广告主;不应用调用方结果数量限制,也不循环翻页。

Google Ad Library Advertiser Search API 参数

参数必填描述
query必填必填的非空广告主、品牌、组织或网站搜索词。匹配行为取决于来源,不保证是精确、前缀或模糊匹配。
region可选可选的非空地区字符串,例如 US,作为地理搜索上下文转发。它不能证明任何广告主的广告投放地区。

如何使用 Google Ad Library Advertiser Search API

提交搜索词,跟踪异步任务,并在后续研究使用其身份前逐条核验标准化广告主候选。

  1. 选择具体的广告主、品牌、组织或网站词,可选添加 US 等地区。
  2. 将 query 和可选 region POST 到 /v1/google-ad-library/advertiser-search,并保存 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或失败。
  4. 读取 data.results.items;选用广告主 ID 前,不要只依赖名称相似度,应核验多项身份信息。
curl -X POST "https://api.socq.ai/v1/google-ad-library/advertiser-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Nike","region":"US"}'

# 轮询 GET /v1/tasks/{task_id}
# 将 data.results.items 作为广告主候选逐条核验

Google Ad Library Advertiser Search API 最佳使用场景

  • 将品牌解析为广告主 ID: 先通过名称或网站词建立候选列表,再为独立的公开广告库存请求选择广告主 ID。
  • 区分地区或法律实体: 出现多个近似记录时,比较名称、地区、网站和公开广告主页,识别子公司、经销商或无关组织。
  • 建立人工核验队列: 保存候选身份和采集时间供人工复核,不因名称相似就断言其归属关系。

Google Ad Library Advertiser Search API 使用建议

  • 使用具体法律名称、品牌或类似域名的搜索词;宽泛词可能产生歧义候选,且匹配规则没有保证。
  • 将 region 视为搜索上下文,而不是广告主所有广告都在该地区投放的证据。
  • 合并记录或采集创意前,使用 ID、名称、网站、地区和公开广告主页共同核验候选。
  • 不要发送 results_limit:该操作保存一次上游响应中的可用广告主数组,不会对来源翻页。

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

  • Google Ad Library Ad API — 通过 URL 获取一条已知公开 Transparency Center 创意,返回广告主、文案、媒体、投放、地区、格式、目标链接和展示次数字段。
  • Google Ad Library Company Ads API — 按公司域名或广告主 ID 采集公开 Transparency Center 创意,并支持主题、地区、日期、Google 界面、格式和结果数量控制。

探索其他平台

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

Google Ad Library Advertiser Search API — 常见问题

Google Ad Library Advertiser Search API 是一个用于按查询词和可选地区发现公开 Google Ads Transparency Center 广告主候选的 API。它返回标准化广告主身份及来源相关的网站、Logo、地区和广告数量字段,而不是广告创意。

它只返回广告主候选。需要枚举公开创意时,应先核验广告主 ID 或域名,再使用独立的 company-ads 操作。

region 是转发给广告主搜索的地理上下文,可用于缩小候选,但既不是有保证的精确筛选,也不能证明广告投放地区。

不是。结果是采集时一次上游搜索响应返回的完整可用广告主数组,没有 SocQ 翻页循环或调用方可控数量限制。

每条保存的广告主记录消耗 0.5 SocQ 积分。预估按 100 条计算并允许超额;成功但为空时只收取配置为零的基础费用。