Ads Transparency
The ads an advertiser has run, from Google's Ads Transparency Center: format, first and last shown dates, and a link to each creative.
GET /api/v1/adsCost: 1 per request (0 if cached)Example request
curl -G "https://goddsapi.com/api/v1/ads" \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "domain=example.com"
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
domainrequired | string | — | Advertiser domain, e.g. example.com (https:// and www. are stripped). |
region | string | — | Two-letter region code to filter by. |
api_key | string | — | Your key, if you can't send the Authorization: Bearer header. Never logged. |
no_cache | boolean | false | true forces a fresh search (charged). Otherwise identical queries within your plan's cache window are served free. |
Example response
Shortened to one item per list.
{
"search_metadata": {
"id": "srch_3f9c0d7b2a41e6c8d5b19a70",
"status": "success",
"api_version": "v1",
"endpoint": "ads",
"provider": "serpapi",
"cached": false,
"credits_charged": 1,
"time_taken_ms": 1840,
"created_at": "2026-11-20T15:04:05.000Z"
},
"search_parameters": {
"endpoint": "ads",
"domain": "example.com"
},
"domain": "example.com",
"total_results": 7000,
"ads": [
{
"advertiser_id": "AR09678401900352897025",
"advertiser_name": "Example Services Company",
"creative_id": "CR09634365291429363713",
"format": "text",
"first_shown": "2022-11-15T08:00:00.000Z",
"last_shown": "2026-11-20T07:46:14.000Z",
"image": null,
"link": "https://adstransparency.google.com/advertiser/AR09678401900352897025/creative/CR09634365291429363713"
}
]
}- This shows ads an advertiser runs anywhere on Google. It does not tell you their spend, and GoddsAPI never estimates it.