Google Ad Library Advertiser Search
Google Ad Library Advertiser Search 根据广告主、品牌、组织名称或网站查询 Google Ads Transparency Center 中的公开广告主。接口返回广告主 ID、名称、网站、Logo、地区和可用广告数量，便于核验广告主身份并继续采集其公开广告。
主要特性
- 按名称发现广告主使用一个非空品牌、组织、广告主或网站词搜索，返回标准化广告主候选，而不是广告创意。
- 可选地区上下文传入 US 等地区为上游搜索提供地理上下文，同时明确区分广告主地区与广告投放地区。
- 候选身份字段比较公开广告主 ID、名称、URL、网站、Logo、地区和来源提供的广告数量，不推断或补全缺失值。
- 保存单次完整响应保存一次上游搜索响应中的所有可用广告主；不应用调用方结果数量限制，也不循环翻页。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
query | 必填 | 必填的非空广告主、品牌、组织或网站搜索词。匹配行为取决于来源，不保证是精确、前缀或模糊匹配。 |
region | 可选 | 可选的非空地区字符串，例如 US，作为地理搜索上下文转发。它不能证明任何广告主的广告投放地区。 |
如何使用
提交搜索词，跟踪异步任务，并在后续研究使用其身份前逐条核验标准化广告主候选。
- 选择具体的广告主、品牌、组织或网站词，可选添加 US 等地区。
- 将 query 和可选 region POST 到 /v1/google-ad-library/advertiser-search，并保存 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
- 读取 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 作为广告主候选逐条核验最佳使用场景
- 将品牌解析为广告主 ID： 先通过名称或网站词建立候选列表，再为独立的公开广告库存请求选择广告主 ID。
- 区分地区或法律实体： 出现多个近似记录时，比较名称、地区、网站和公开广告主页，识别子公司、经销商或无关组织。
- 建立人工核验队列： 保存候选身份和采集时间供人工复核，不因名称相似就断言其归属关系。
使用建议
- 使用具体法律名称、品牌或类似域名的搜索词；宽泛词可能产生歧义候选，且匹配规则没有保证。
- 将 region 视为搜索上下文，而不是广告主所有广告都在该地区投放的证据。
- 合并记录或采集创意前，使用 ID、名称、网站、地区和公开广告主页共同核验候选。
- 不要发送 results_limit：该操作保存一次上游响应中的可用广告主数组，不会对来源翻页。
相关 API
需要其他类型的 Google Ad Library 公开数据时，可以使用以下 API。
- Google Ad Library Ad API — 通过 URL 获取一条已知公开 Transparency Center 创意，返回广告主、文案、媒体、投放、地区、格式、目标链接和展示次数字段。
- Google Ad Library Company Ads API — 按公司域名或广告主 ID 采集公开 Transparency Center 创意，并支持主题、地区、日期、Google 界面、格式和结果数量控制。