我们自己的访问统计默认开启。Google Analytics 只在你同意后启用，用来了解公开页面是否有用，不统计登录后的工作台。详见 隐私政策。

万有引擎
搜索⌘K
中文
登录免费开始
Google 广告透明度中心

Google 广告透明度中心 API

按域名或广告主 ID 读某个公司在 Google 上投过的广告（一次最多 100 条）：广告 ID、形式（文字、图片、视频）、首次和最近投放时间、预览图和透明度中心链接，可按国家、形式、投放产品（搜索、YouTube 等）和日期筛选，用来看竞品在 Google 投什么、投了多久；不含花费和展示量。 调用 POST /api/v1/social ；返回结构化 JSON，$0.68 / 千次；失败不计费。

免费开始 文档

平台运行状态

24h 健康值
正常
正常

30 天趋势

Google 广告透明度中心 能力清单

能力做什么单价24 小时运行状态
广告素材ads用 ads 按域名或广告主 ID 读一个公司在 Google 上投过的广告，一次最多 100 条。$0.68 / 千次正常

点能力名进它的文档：参数、返回字段、代码示例和试用。

Google 广告透明度中心 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

能力必填参数可选参数单次条数模式单价返回字段
adsadvertisercountry, end_date, format, start_date, surface默认 100 · 最多 100同步$0.68 / 千次rank · ad_id · advertiser_id · advertiser_name · domain · format · first_shown_at · last_shown_at · image_url · url · advertiser_ads_estimate · platform

怎么调用 Google 广告透明度中心 广告素材 API？

ads

使用 platform="google_ads_transparency"、action="ads" 调用“广告素材”能力；返回列表，默认 100 条、单次最多 100 条，主要包含 rank、ad_id、advertiser_id、advertiser_name、domain、format 等 12 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Google 广告透明度中心 ads 的参数分别是什么意思？

advertiser必填
查谁的广告：域名（如 nike.com）或广告主 ID（AR 开头，如 AR01614014350098432001，也收透明度中心的广告主链接）。

Google 帮助页说明广告主要用法律文件完成身份验证，广告透明度中心可以按广告主名称或网站搜索，并按投放地区和日期筛选。这里支撑按域名或广告主查、按国家和日期筛；本接口的参数由 EveryInfra 定义，该来源不证明结果。官方来源：Google 我的广告中心帮助：广告主验证与广告透明度中心来源核查：

country可选
只看在这个国家投放的广告，两位国家代码（如 us、gb）；不填看全部地区。
end_date可选
只要这天及以前首次投放的广告，YYYY-MM-DD。
format可选
只看某种广告形式：text、image、video。
查看全部 3 个允许值

imagetextvideo

start_date可选
只要这天及以后首次投放的广告，YYYY-MM-DD。
surface可选
只看投在某个 Google 产品上的广告：search（搜索）、youtube、play、maps、shopping。
Google 广告透明度中心 返回字段与含义（11）
rank
该广告在这次结果里的顺序，从 1 开始（大致按最近一次投放从新到旧）。
ad_id
Google 广告透明度中心的广告创意 ID（CR 开头）。
advertiser_id
广告主 ID（AR 开头），可以当 advertiser 再查。
advertiser_name
广告主经 Google 验证的名称（可能是子公司或代理，如某品牌的加拿大公司）。
domain
广告关联的域名。
format
广告形式：text（文字）、image（图片）、video（视频）。
first_shown_at
这条广告第一次投放的时间，UTC，ISO 8601。
last_shown_at
这条广告最近一次投放的时间，UTC，ISO 8601。
image_url
广告预览图（Google 存档的创意截图）；部分文字广告没有。
url
这条广告在 Google 广告透明度中心的页面。
advertiser_ads_estimate
透明度中心估计这个广告主（在所选国家、形式下）一共有多少条广告，每行相同。
Google 广告透明度中心 ads 调用流程一次 Google 广告透明度中心 ads 调用的全过程：向 POST /api/v1/social 发送 platform="google_ads_transparency"、action="ads"，以及必填参数 advertiser;返回结构化 JSON，含 rank、ad_id、advertiser_id、advertiser_name、domain 等字段；返回列表，单次最多 100 条，计费 $0.68 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "google_ads_transparency"action: "ads"advertiserEveryInfra$0.68 / 千次2 · 响应 · 列表rankad_idadvertiser_idadvertiser_namedomain
一次 Google 广告透明度中心 ads 调用的全过程：向 POST /api/v1/social 发送 platform="google_ads_transparency"、action="ads"，以及必填参数 advertiser;返回结构化 JSON，含 rank、ad_id、advertiser_id、advertiser_name、domain 等字段；返回列表，单次最多 100 条，计费 $0.68 / 千次，失败与空结果不计费。

Google 广告透明度中心 原始字段名

EveryInfra 统一字段名

左边是 Google 广告透明度中心 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Google 广告透明度中心 的独有字段名（当前目录）

全站 106 个平台的当前目录中，这 4 个字段名只在 Google 广告透明度中心 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • ad_id
  • first_shown_at
  • last_shown_at
  • advertiser_ads_estimate

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

rank
该广告在这次结果里的顺序，从 1 开始（大致按最近一次投放从新到旧）。
ad_id
Google 广告透明度中心的广告创意 ID（CR 开头）。
advertiser_id
广告主 ID（AR 开头），可以当 advertiser 再查。
advertiser_name
广告主经 Google 验证的名称（可能是子公司或代理，如某品牌的加拿大公司）。
domain
广告关联的域名。
format
广告形式：text（文字）、image（图片）、video（视频）。
first_shown_at
这条广告第一次投放的时间，UTC，ISO 8601。
last_shown_at
这条广告最近一次投放的时间，UTC，ISO 8601。
image_url
广告预览图（Google 存档的创意截图）；部分文字广告没有。
url
这条广告在 Google 广告透明度中心的页面。
advertiser_ads_estimate
透明度中心估计这个广告主（在所选国家、形式下）一共有多少条广告，每行相同。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

请求填写示例

advertiser 填域名或 AR 开头的广告主 ID；一次最多 100 条，按次计价。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

google_ads_transparency_ads.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"google_ads_transparency","action":"ads","params":{"advertiser":"lululemon.com"}}'

记录字段预览（非真实响应）

仅展示 ads 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "rank": null,
  "ad_id": null,
  "advertiser_id": null,
  "advertiser_name": null,
  "domain": null,
  "format": null,
  "first_shown_at": null,
  "last_shown_at": null,
  "image_url": null,
  "url": null,
  "advertiser_ads_estimate": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

Google 广告透明度中心 API 如何查竞品在 Google 投的广告？

用 ads 按域名或广告主 ID 读一个公司在 Google 上投过的广告，一次最多 100 条。

查看 ads 的 advertiser 参数
  • advertiser 填域名（如 lululemon.com）或 AR 开头的广告主 ID；country 只看某国投放，format 选 text、image、video，surface 选 search、youtube、play、maps、shopping，start_date、end_date 按首次投放日期筛。
  • 每行有广告 ID ad_id、广告形式 format、首次和最近投放时间、预览图 image_url 和透明度中心链接 url；不含广告文案、花费和展示量，只有完成 Google 验证的广告主才查得到。

Google 广告透明度中心 API 常见问题

Google 广告透明度中心 API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="google_ads_transparency"、action 和 params。以 ads 为例，必填 advertiser，可选 country、end_date、format、start_date。advertiser 填域名或 AR 开头的广告主 ID；一次最多 100 条，按次计价。 Google 广告透明度中心 共 1 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Google 广告透明度中心 API 怎么收费？

$0.68 / 千次，Google 广告透明度中心 全部 1 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 1,468 次 Google 广告透明度中心 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Google 广告透明度中心 API 一次能返回多少条数据？

Google 广告透明度中心 有 1 个列表接口，包括 ads。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Google 广告透明度中心 API 返回哪些字段？

当前目录为 ads 列出 rank、ad_id、advertiser_id、advertiser_name、domain、format 等 12 个字段名。按全站当前目录统计，4 个字段名只在 Google 广告透明度中心 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

Google 广告透明度中心 API 如何查竞品在 Google 投的广告？

用 ads 按域名或广告主 ID 读一个公司在 Google 上投过的广告，一次最多 100 条。 advertiser 填域名（如 lululemon.com）或 AR 开头的广告主 ID；country 只看某国投放，format 选 text、image、video，surface 选 search、youtube、play、maps、shopping，start_date、end_date 按首次投放日期筛。 每行有广告 ID ad_id、广告形式 format、首次和最近投放时间、预览图 image_url 和透明度中心链接 url；不含广告文案、花费和展示量，只有完成 Google 验证的广告主才查得到。

可以先免费试用 Google 广告透明度中心 API 吗？

可以。注册免费，在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星，就能在控制台「余额与充值」领取 $1 额度（≈720 次数据调用），直接进赠送余额，不用输码，24 小⁠时内有效。请先选择 Google 广告透明度中心 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 1 个能力。无需信用卡。

更多全网搜索 API

Apple 地图 APIBing 搜索 APIBing 地图 API公司数据 API加密行情 API加密新闻 APIDuckDuckGo 搜索 APIDuckDuckGo 地图 API全部 106 平台 ↗

开始调用 Google 广告透明度中心 API

在 GitHub 给两个仓库点星领 $1 额度，注册后在控制台领取，24 小⁠时内有效，先选一个 Google 广告透明度中心 接口验证结果。

免费开始