# Google Ads Transparency API

Research advertisers and their creatives in Google's Ads Transparency Center.

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



## Capabilities

### [List advertiser creatives](https://docs.upscrape.com/docs/platforms/google-adstransparency/google-adstransparency.advertiser-ads.list)

- Capability ID: `google-adstransparency.advertiser-ads.list`
- Cost: 1 credit per request

List an advertiser’s Google creatives with pagination and optional delivery country, format and platform filters. Returns raw positional source fields.
### [Search advertisers](https://docs.upscrape.com/docs/platforms/google-adstransparency/google-adstransparency.advertiser.search)

- Capability ID: `google-adstransparency.advertiser.search`
- Cost: 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)

- Capability ID: `google-adstransparency.creative.search`
- Cost: 1 credit per request

Resolves a brand, advertiser name, or domain and returns that advertiser's creative records. Optional source-qualified delivery country (US/DE), creative format (TEXT/IMAGE/VIDEO) and delivery platform (SEARCH/YOUTUBE) filters. Google positional fields are preserved.

## Common uses

- Resolve brand names and domains to Google advertiser ids
- Monitor the creatives associated with a competitor advertiser
- Collect lossless Google ad payloads for ads-intelligence pipelines

## 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).
