Google Ads API
Google Ads 搜索 API
从 Google Ads Transparency Center 获取某广告主当前正在投放的广告（素材详情、格式和投放日期），以干净的 JSON 返回。
POST/v1/run/google_ads.search
可用率
99.42%
30d · 173 次调用
请求数
173
30d
响应时间
11.8s
中位数 · 30d
试一试
发出你的第一个请求
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"items": [
{
"advertiser": "example",
"advertiserId": "a1b2c3d4",
"firstShownUtc": 12.5,
"format": "example",
"id": "a1b2c3d4",
"lastShownUtc": 12.5,
"numServedDays": 42,
"previewUrl": "https://example.com/page",
"url": "https://example.com/page",
"variations": [
{
"headline": "Example title",
"imageUrl": "https://example.com/image.jpg",
"text": "A short example description of this item."
}
]
}
]
},
"found": true,
"reason": "not_found"
}响应类型定义
interface GoogleAdsSearchResponse {
data: {
items: {
advertiser?: string;
advertiserId?: string;
firstShownUtc?: number;
format?: string;
id: string;
lastShownUtc?: number;
numServedDays?: number;
previewUrl?: string;
url: string;
variations?: {
headline?: string;
imageUrl?: string;
text?: string;
}[];
}[];
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/google_ads.search
curl -X POST https://api.getanyapi.com/v1/run/google_ads.search \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"limit":3,"url":"https://adstransparency.google.com/?region=US&domain=nike.com"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| url | string | "https://adstransparency.google.com/?region=US&domain=nike.com"选定广告主或域名的 Google Ads Transparency Center URL（例如 https://adstransparency.google.com/advertiser/AR01614014350098432001?region=US）。 |
| limit | integer | 3最多返回的结果数（1-20，默认 20）。按返回的结果数扣费，所以上限越低，费用越少。 |
| 响应 | ||
| data | object | The result wrapper, or null when nothing was found. |
| data.items | object[] | Ad records from the Transparency Center: advertiser, ad format, creative details, preview URL, and first/last shown dates. Populated whenever the provider has data for the entity. |
| data.items[].advertiser | string | Advertiser display name. Populated whenever the provider has data for the entity. |
| data.items[].advertiserId | string | Google Ads advertiser identifier. |
| data.items[].firstShownUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was first shown. |
| data.items[].format | string | Ad format, e.g. TEXT, IMAGE, VIDEO. |
| data.items[].id | string | Google Ads creative identifier. Populated whenever the provider has data for the entity. |
| data.items[].lastShownUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was last shown. |
| data.items[].numServedDays | integer | Number of days the ad has been served. |
| data.items[].previewUrl | string | URL to a rendered preview of the creative. |
| data.items[].url | string | Ads Transparency Center URL for the creative. Populated whenever the provider has data for the entity. |
| data.items[].variations | object[] | Creative variations for the ad, each with image, headline, and body text where present. |
| data.items[].variations[].headline | string | Creative headline text. |
| data.items[].variations[].imageUrl | string | Creative image URL. |
| data.items[].variations[].text | string | Creative body/description text. |
| found | boolean | True when at least one ad record was returned. |
| reason | "not_found" | Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost. |
| 价格 | ||
| 每次请求价格（上限） | USD | US$0.0287 |
| 价格（/千条结果） | USD | US$1.37 |
常见问题
关于 Google Ads 搜索 API
AnyAPI 的 Google Ads 搜索 API 只需一次 POST 请求 /v1/run/google_ads.search，就以统一格式的 JSON 返回 Google Ads 数据。从 Google Ads Transparency Center 获取某广告主当前正在投放的广告（素材详情、格式和投放日期），以干净的 JSON 返回。无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千条结果 US$1.37，单次请求最多 US$0.0287，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Google Ads 搜索 API 调用中有 99.4% 成功，响应时间中位数为 11.8 秒，共测量 173 次调用。
费用：每千条结果 US$1.37，单次请求最多 US$0.0287，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。
从 Google Ads Transparency Center 获取某广告主当前正在投放的广告（素材详情、格式和投放日期），以干净的 JSON 返回。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。
过去 30 天，通过 AnyAPI 发起的 Google Ads 搜索 API 调用中有 99.4% 成功，响应时间中位数为 11.8 秒，共测量 173 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。