# Google Ads Transparency API

Scrapes Google's Ads Transparency Center (adstransparency.google.com): search creatives by text/region, list every…

- Platform ID: `google-adstransparency`
- Capabilities: 3
- Execute endpoint: `POST https://data.upscrape.com/execute`
- OpenAPI: https://upscrape.com/scrapers/google-adstransparency/openapi.json

## Capabilities

| Endpoint | Capability ID | Cost | Description |
| --- | --- | --- | --- |
| [List Advertiser Creatives](https://docs.upscrape.com/docs/platforms/google-adstransparency/google-adstransparency.advertiser-ads.list) | `google-adstransparency.advertiser-ads.list` | 1 credit per request | Lists every creative run by a specific advertiser, identified by their Google advertiser id (e.g. AR…), within a region. Returns raw creative payloads. |
| [Search Advertisers](https://docs.upscrape.com/docs/platforms/google-adstransparency/google-adstransparency.advertiser.search) | `google-adstransparency.advertiser.search` | 1 credit per request | Resolves an advertiser name or domain to its Google advertiser id(s) and disclosed metadata. Use the returned advertiser id with advertiser-ads.list. |
| [Search Creatives](https://docs.upscrape.com/docs/platforms/google-adstransparency/google-adstransparency.creative.search) | `google-adstransparency.creative.search` | 1 credit per request | Searches the Ads Transparency Center by text (brand, advertiser name, or domain) within a region. Returns raw creative payloads. Use advertiser.search first when you only know the advertiser by name. |


## Integration contract

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).
