GET /api/v1/transparency支持关键词、域名、创意 ID 三种查询方式
面向 Google 广告情报的 Ads Transparency API
支持按关键词搜索 Google Ads 透明度数据、按域名查询广告主、按创意 ID 反查域名。
适用于广告情报、竞品监控、投放研究和合规分析场景。
一个接口，三种查询模式，共享 API Key、积分和请求日志。
API Tester
登录后可直接测试 Ads Transparency 接口，积分和请求日志会记录到当前账户。
该页面会发送真实请求。上游成功返回后，会从当前账户扣除积分。
接口
预估消耗：2 积分
Ads Transparency 查询方式
关键词
Demo：
请求预览
https://api-hub.sitedata.dev/api/v1/transparency
这个页面提供什么能力
不仅是透明度接口转发，还包含完整的产品化测试与交付能力。
三种查询模式
同一个接口支持 `keyword`、`domain`、`creativeIds` 三种查询方式。
广告主与域名关系数据
可返回关键词联想广告主、域名关联广告主，以及创意 ID 关联域名。
积分计费
成功请求后自动扣减积分，并在响应中返回本次消耗和剩余积分。
统一 API Key 鉴权
沿用整套 SiteData API 的 API Key 鉴权模型，无需额外接入一套权限系统。
请求日志
每次成功请求都会写入日志，方便用户和管理端追踪。
文档、复制页与测试模块
页面内直接连接到文档、复制页和测试模块，方便快速评估和接入。
常见使用方式
大多数团队会按照以下几种查询路径使用：
1
按关键词探索市场
从 `ai image` 这类关键词出发，快速查看广告主名称、广告主 ID 和相关域名。
2
按域名查广告主
输入目标域名，查询对应广告主、国家、广告数量和创意 ID。
3
按创意 ID 反查域名
将创意 ID 批量输入后，快速反查关联落地域名，用于聚合广告投放线索。
4
从请求记录回溯
通过内置日志查看历史查询和积分变化，便于复盘与运维。
Ads Transparency API 常见问题
常见的产品和接入问题集中回答在这里。