> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Search Ad Creatives
> Search Google Ads Transparency Center creatives by advertiser id or verified domain, with format and date-window filtering.
Search creatives by advertiser or domain. One of `advertiser_id` or `query` is
required.
**Credits:** 10
Free-text `query` is **domain-based** — it matches verified advertiser domains
like `nike.com`, not brand names. For a brand name, resolve it first with
[`/ads/advertisers`](/api-reference/endpoint/google-ads-transparency/search-advertisers)
and pass the resulting `advertiser_id`.
## Authorization
Your ScrapeBadger API key.
## Query Parameters
Advertiser ID as shown in the Transparency Center URL, e.g.
`AR01614014350098432001`. Required unless `query` is given.
Free text — a verified advertiser domain such as `tesla.com`. Required unless
`advertiser_id` is given.
ISO 3166-1 alpha-2 region the ad was served in, or `anywhere` for no region
filter.
Surface the ad ran on: `SEARCH`, `MAPS`, `PLAY`, `SHOPPING` or `YOUTUBE`.
**Validated but not applied** — see `filters_applied.platform`.
Creative format: `TEXT`, `IMAGE` or `VIDEO`. Applied over the returned page.
`YYYY-MM-DD`. Keeps creatives still running on or after this date.
`YYYY-MM-DD`. Keeps creatives first shown on or before this date.
Restrict to political ads. **Validated but not applied** — see
`filters_applied.political`.
Results per page, `1`–`100`.
`next_page_token` from a previous response.
## Response
The region requested.
Google's reported total for the advertiser or domain, when it sends one.
Creatives in this response **after** the format and date filters — can be
smaller than `num` while `next_page_token` is still set.
Pass as `cursor` for the next page. `null` on the last page.
Which filters were honoured: `region`, `advertiser_id`, `query`, `format`,
`date_range`, `platform`, `political`. `platform` and `political` are always
`false`.
e.g. `CR10484731423840108545`.The advertiser's verified domain.`TEXT`, `IMAGE` or `VIDEO`.Image or video asset, for image and video creatives.Google's rendered preview markup.ISO 8601 UTC.The Transparency Center page for this creative.
## Example
```bash cURL theme={null}
curl "https://scrapebadger.com/v1/google/ads/search?advertiser_id=AR01614014350098432001®ion=US&format=VIDEO&num=40" \
-H "X-API-Key: YOUR_API_KEY"
```
```javascript Node.js theme={null}
const res = await fetch(
"https://scrapebadger.com/v1/google/ads/search?" +
new URLSearchParams({
advertiser_id: "AR01614014350098432001",
region: "US",
format: "VIDEO",
num: "40",
}),
{ headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();
```
```python Python theme={null}
import requests
res = requests.get(
"https://scrapebadger.com/v1/google/ads/search",
headers={"X-API-Key": "YOUR_API_KEY"},
params={
"advertiser_id": "AR01614014350098432001",
"region": "US",
"format": "VIDEO",
"num": 40,
},
)
data = res.json()
```
```json Response theme={null}
{
"region": "US",
"total_results": 1284,
"returned_results": 2,
"next_page_token": "CkgKRkFSMDE2MTQwMTQzNTAwOTg0MzIwMDEQZBgB",
"filters_applied": {
"region": true,
"advertiser_id": true,
"query": false,
"format": true,
"date_range": false,
"platform": false,
"political": false
},
"creatives": [
{
"creative_id": "CR10484731423840108545",
"advertiser_id": "AR01614014350098432001",
"advertiser_name": "Nike, Inc.",
"target_domain": "nike.com",
"format": "VIDEO",
"media_url": "https://www.youtube.com/embed/dQw4w9WgXcQ",
"preview_html": "",
"first_shown_utc": 1749513600,
"first_shown_at": "2026-06-10T00:00:00Z",
"last_shown_utc": 1754870400,
"last_shown_at": "2026-08-11T00:00:00Z",
"days_shown": 63,
"details_link": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10484731423840108545"
},
{
"creative_id": "CR17738822901234567890",
"advertiser_id": "AR01614014350098432001",
"advertiser_name": "Nike, Inc.",
"target_domain": "nike.com",
"format": "VIDEO",
"media_url": "https://www.youtube.com/embed/abc123XYZ",
"first_shown_utc": 1752105600,
"first_shown_at": "2026-07-10T00:00:00Z",
"last_shown_utc": 1754784000,
"last_shown_at": "2026-08-10T00:00:00Z",
"days_shown": 32,
"details_link": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR17738822901234567890"
}
]
}
```
The date window matches on **overlap**, not on start: a creative shown
2026-01-01 to 2026-06-01 matches a March query, because callers ask "what was
running then", not "what started then".
## Errors
| Status | Meaning |
| ------ | ---------------------------------------------------------------------------------------- |
| `400` | Neither `advertiser_id` nor `query` given; unknown `platform`, `format`, region or date. |
| `502` | Upstream Transparency Center failure — **not billed**. |