# Google Ads Transparency Ads API Documentation

List the ads an advertiser runs, identified either by domain or by advertiser id. Filter by the region the ad was shown in, by creative format, and by a shown-date window. Results are ordered by last shown, most recent first. Image creatives expose asset_url; html5 and video creatives expose rendered_creative_url instead, because their URL is a renderer document rather than a creative asset. The list is paged: while a continuation token is present the response reports itself as incomplete and never claims a total.

- **Documentation:** [https://scrappa.co/docs/google-ads-transparency-api/google_ads_transparency_ads](https://scrappa.co/docs/google-ads-transparency-api/google_ads_transparency_ads)
- **API group:** Google Ads Transparency API
- **Endpoint:** `GET https://scrappa.co/api/google-ads-transparency/ads`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `advertiser_id` | string | No | Owning advertiser id beginning with AR. Provide this or domain, not both. |
| `domain` | string | No | Advertiser domain, for example nike.com. |
| `format` | string | No | Creative format: image, html5 or video. Filters where the ad was shown by creative format. |
| `region` | integer | No | Single region id the ad was shown in, for example 2840 for United States. This filters where the ad ran, not where the advertiser is based. An unsupported id is rejected before any upstream call. |
| `date_from` | string | No | Include ads shown on or after this date, YYYY-MM-DD. |
| `date_to` | string | No | Include ads shown on or before this date, YYYY-MM-DD. |
| `page_size` | integer | No | Records per page. Defaults to 20, maximum 100. |
| `page_token` | string | No | Continuation token from the previous page. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/google-ads-transparency/ads?domain=nike.com&format=image&region=2840&page_size=50"
```

## Example response

```json
{
    "success": true,
    "data": {
        "ads": [],
        "has_more": false,
        "complete": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | The request validation failed. Not billed. |  |
|  | An advertiser-scoped list came back empty and the advertiser could not be confirmed from a domain, or the upstream service refused the request. Not billed. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)