Google 广告 API
3 个接口读 Google 广告：广告库、广告主。一次 $0.0020 起。不用登录 Google 广告，不用 Cookie；失败不收费。
调一次，拿回来的样子
录下来的真实返回，字段已经整理好，直接给 AI 或表格用。2026-10-12 21:59 UTC 录下的真实返回，这里是前 3 行。
在 Playground 里跑一次 · $0.0020{
"code": "ok",
"request_id": "2c6d1a4f-a2f2-4537-b339-dfd44262a0ec",
"data": {
"item": {
"id": "AR16957588921303948228/CR14623979096670259597",
"url": "https://adstransparency.google.com/advertiser/AR16957588921303948228/creative/CR14623979096670259597",
"format": "text",
"title": "Weekend hiking essentials, 20% off this week only",
"text": "Weekend hiking essentials, 20% off this week only",
"landing_url": null,
"advertiser": { "id": "AR12673385717193703136" },
"images": [
"https://tpc.googlesyndication.com/simgad/10334992425704947224",
"https://tpc.googlesyndication.com/simgad/13598759742669398477",
// … 另有 1 条
],
"first_shown_at": "2024-05-06T00:00:00.000Z",
"last_shown_at": "2026-10-12T21:34:42.000Z"
}
},
"warnings": [],
"meta": {
"capability": "google.ads.get",
"result_status": "complete",
"fetched_at": "2026-10-12T21:59:26.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"advertiser.name": "capability",
"advertiser.url": "platform",
"advertiser.avatar_url": "platform"
},
"billing": {
"amount": "0.002",
"currency": "USD",
"balance_after": "9.998"
}
}
}取自 2026-10-12 21:59 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。
能拿到什么
每一行是一个接口：返回什么，一次多少钱。
在 Claude、Cursor 里直接问 Google 广告
加上 DataXAPI 的 MCP，AI 会自己找到合适的 Google 广告接口去调，回答里带原始链接。花多少钱按调了哪些接口算。
https://api.dataxapi.com/mcp三步开始
这里演示的是 Google 广告详情。Google 广告的其他接口都是同样的调法，返回同样的格式。
拿一把 Key
用邮箱验证码或 Google 登录。可免费试用，不用绑卡。
自己调，或者让你的 AI 调
代码里一次 GET。或者把下面这段话带着你的 Key 贴给你的 agent：它自己接好，然后能自己找到并调用这些接口。
每次读到的都是同一种格式
数据在 data.items（单个对象在 data.item），下一页在 page.next_cursor，扣了多少在 meta.billing.amount。失败不扣费。
curl -G "https://api.dataxapi.com/v1/google/ads/get" \ --data-urlencode "id=AR16735076323512287233/CR13384474926044413953" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.google.ads.get(id="AR16735076323512287233/CR13384474926044413953") print(result["data"]["item"])
import { DataXAPI } from "@dataxapi/sdk";
const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.google.ads.get({ id: "AR16735076323512287233/CR13384474926044413953" });
console.log(result.data.item);dataxapi call google.ads.get id=AR16735076323512287233/CR13384474926044413953
{
"mcpServers": {
"dataxapi": {
"type": "http",
"url": "https://api.dataxapi.com/mcp",
"headers": {
"Authorization": "Bearer ${DATAXAPI_API_KEY}"
}
}
}
}把这段加进你的 MCP 客户端，然后让你的 AI 调用 google.ads.get。
边界情况
Google 广告这些接口在边界上怎么表现，以及调用结果不对时先看哪里。
- 每页条数
- 列表每页 10 到 40 条，各接口不同。2 个列表里有 1 个能翻页：把
page.next_cursor作为cursor传回，每一页是一次单独的调用。其余只有一页。 - 给不了的字段
- 3 个接口里有 3 个填不满它返回的对象。每个接口的页面列出了给不了哪些，每次返回也在
meta.unavailable里再写一遍：缺的字段不会被悄悄写成 0。 - 对象不存在时读起来像空结果
- Google 广告主的广告：对象不存在和对象下面没有东西分不出来，所以返回空结果而不是 404，并按空结果计费。
- 广告主编号
- 广告主编号是 AR 加一串数字，用广告主搜索按名称查，不写地区时在美国查。
- 广告编号
- 广告编号是广告主编号和素材编号用 / 连起来（AR…/CR…），和它的链接 adstransparency.google.com/advertiser/AR…/creative/CR… 对得上。
- 广告列表里没有的
- 广告主的广告列表只有形态、投放日期和一张图；广告说了什么、链到哪里、视频，都要看单条广告详情。
- 透明度中心没给的
- 透明度中心没公布展示量的，区间是 null。广告只写了个域名当落地页的，原样留在
ext.variations里。 - 空结果不等于不存在
- 不存在的广告主编号取广告，返回空列表，按空结果计费。
关于 Google 广告 API 的常见问题
回答从简，细节在各接口的页面。
Google 广告 API 怎么收费？
按次收费，没有订阅。3 个接口都是一次 $0.0020。拿到数据才扣费，失败不收。
需要 Google 广告账号或 Cookie 吗？
不需要。你只拿一把 DataXAPI 的 Key：不用登录 Google 广告，不用 Cookie，也不用养设备。接口只返回公开可见的数据。
数据是实时的吗？
每次调用都当场去 Google 广告取，meta.fetched_at 写明取到的时间。结果保留 24 小时，带同一个 Idempotency-Key 重试不会再扣一次。
空结果收费吗？
列表返回空结果时照价收费：搜索已经执行了。读单个对象而对象不存在时返回 not_found，不收费。
Google 广告改版了怎么办？
调用失败不管什么原因都不扣费。被暂停的接口返回 capability_paused，同样不扣费；GET /v1/catalog/status 写着现在哪些能用。
相关
一把 Key 调 Google 广告。
免费试用：按 $0.0020 一次，最多可调 50 次，不用绑卡。 不用登录 Google 广告，不用 Cookie，没有订阅。失败不收费。