# Google Ads Transparency Ad API Documentation

Fetch one ad in detail: its creative format, per-region presence with the dates it ran in each region, aggregate first and last shown dates, variants, variant flags and localized creative text. Pass the owning advertiser id taken from the ads list record for that creative.

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

## 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 | Yes | Owning advertiser id beginning with AR, taken from the ads list record for this creative. |
| `creative_id` | string | Yes | Creative id beginning with CR. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/google-ads-transparency/ad?advertiser_id=AR18378488041124659201&creative_id=CR09241904563038978049"
```

## Example response

```json
{
    "success": true,
    "data": {
        "regions": [],
        "first_shown": "2025-10-27",
        "last_shown": "2026-10-02"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | The request validation failed. Not billed. |  |
|  | No creative was returned for those identifiers, 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)