Google Ads 搜索 API
Pull the ads an advertiser is running from the Google Ads Transparency Center (creative details, formats, run dates, and headline and text where Google publishes them) as clean JSON. Each ad's detail page is read, so a 20-ad call can take a minute or more; many text ads come back only as an image of the ad.
US$0.947619/千条结果，按请求付费，无需订阅。
Advertiser Details
Patagonia, Inc.
Legal name: Patagonia, Inc.
Based in:
Sponsored
Patagonia, Inc.
Built to Last - Shop Patagonia
Recycled Materials. Fair Trade Certified Sewing. Free Shipping On Orders Over $99.
Patagonia, Inc.
IMAGE
Sponsored
Patagonia, Inc.
Worn Wear Trade-In Program
Trade In Your Old Patagonia Gear For Store Credit. Keep Gear In Use, Not In Landfills.
Patagonia, Inc.
VIDEO
Sponsored
Patagonia, Inc.
Patagonia Fleece - Shop Now
Classic Synchilla Fleece In New Colors For Fall. Free Returns Within 60 Days.
Patagonia, Inc.
TEXT
{"id": "CR07726154893012480099","url": "https://adstransparency.google.com/advertiser/AR07726154893012480003/creative/CR07726154893012480099","advertiser": "Patagonia, Inc.","advertiserId": "AR07726154893012480003","format": "IMAGE","previewUrl": "https://tpc.googlesyndication.com/simgad/4471902837465019283","numServedDays": 42,"firstShownUtc": 1755043200,... 还有 2 个字段}
价格
Google Ads 搜索 API 价格
试一试
一个请求获取 Google Ads 搜索
这个示例展示了 17 个字段中的 16 个。查看全部字段
{
"found": true,
"data": {
"items": [
{
"id": "CR07726154893012480099",
"url": "https://adstransparency.google.com/advertiser/AR07726154893012480003/creative/CR07726154893012480099",
"advertiser": "Patagonia, Inc.",
"advertiserId": "AR07726154893012480003",
"format": "IMAGE",
"previewUrl": "https://tpc.googlesyndication.com/simgad/4471902837465019283",
"numServedDays": 42,
"firstShownUtc": 1755043200,
"lastShownUtc": 1758758400,
"variations": [
{
"imageUrl": "https://tpc.googlesyndication.com/simgad/4471902837465019283",
"headline": "Built to Last - Shop Patagonia",
"text": "Recycled Materials. Fair Trade Certified Sewing. Free Shipping On Orders Over $99."
}
]
},
{
"id": "CR07726154893012480102",
"url": "https://adstransparency.google.com/advertiser/AR07726154893012480003/creative/CR07726154893012480102",
"advertiser": "Patagonia, Inc.",
"advertiserId": "AR07726154893012480003",
"format": "VIDEO",
"previewUrl": "https://tpc.googlesyndication.com/simgad/9930287465019283441",
"numServedDays": 18,
"firstShownUtc": 1757462400,
"lastShownUtc": 1758931200,
"variations": [
{
"imageUrl": "https://tpc.googlesyndication.com/simgad/9930287465019283441",
"headline": "Worn Wear Trade-In Program",
"text": "Trade In Your Old Patagonia Gear For Store Credit. Keep Gear In Use, Not In Landfills."
}
]
},
{
"id": "CR07726154893012480110",
"url": "https://adstransparency.google.com/advertiser/AR07726154893012480003/creative/CR07726154893012480110",
"advertiser": "Patagonia, Inc.",
"advertiserId": "AR07726154893012480003",
"format": "TEXT",
"previewUrl": "https://tpc.googlesyndication.com/simgad/1123344556677889900",
"numServedDays": 65,
"firstShownUtc": 1751328000,
"lastShownUtc": 1758844800,
"variations": [
{
"headline": "Patagonia Fleece - Shop Now",
"text": "Classic Synchilla Fleece In New Colors For Fall. Free Returns Within 60 Days."
}
]
}
]
}
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- urlstring
https://adstransparency.google.com/advertiser/AR07726154893012480003?region=US
选定广告主或域名的 Google Ads Transparency Center URL（例如 https://adstransparency.google.com/advertiser/AR01614014350098432001?region=US）。
- limitinteger
3
最多返回的结果数（1-20，默认 20）。按返回的结果数扣费，所以上限越低，费用越少。
响应
JSON，每个字段一个示例值。
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.
- advertiserstring
Patagonia, Inc.
Advertiser display name. Populated whenever the provider has data for the entity.
- advertiserIdstring
AR07726154893012480003
Google Ads advertiser identifier.
- firstShownUtcnumber
1755043200
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was first shown.
- formatstring
IMAGE
Ad format, e.g. TEXT, IMAGE, VIDEO.
- idstring
CR07726154893012480099
Google Ads creative identifier. Populated whenever the provider has data for the entity.
- lastShownUtcnumber
1758758400
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was last shown.
- numServedDaysinteger
42
Number of days the ad has been served.
- previewUrlstring
https://tpc.googlesyndication.com/simgad/4471902837465019283
URL to a rendered preview of the creative.
- urlstring
https://adstransparency.google.com/advertiser/AR07726154893012480003/creative/CR07726154893012480099
Ads Transparency Center URL for the creative. Populated whenever the provider has data for the entity.
Creative variations for the ad, each with image, headline, and body text where present.
- headlinestring
Built to Last - Shop Patagonia
Creative headline text.
- imageUrlstring
https://tpc.googlesyndication.com/simgad/4471902837465019283
Creative image URL.
- textstring
Recycled Materials. Fair Trade Certified Sewing. Free Shipping On Orders Over $99.
Creative body/description text.
- foundboolean
true
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.
常见问题
关于 Google Ads 搜索 API
AnyAPI 的 Google Ads 搜索 API 只需一次 POST 请求 /v1/run/google_ads.search，就以统一格式的 JSON 返回 Google Ads 数据。Pull the ads an advertiser is running from the Google Ads Transparency Center (creative details, formats, run dates, and headline and text where Google publishes them) as clean JSON. Each ad's detail page is read, so a 20-ad call can take a minute or more; many text ads come back only as an image of the ad.无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千条结果 US$0.95，单次请求最多 US$0.0199，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Google Ads 搜索 API 调用中有 100.0% 成功，响应时间中位数为 9.6 秒，共测量 697 次调用。