Google Ads Transparency Center API
The Google Ads Transparency Center lists ads from verified advertisers across Google Search, YouTube, Google Play, Maps and Shopping. ads lists up to 100 ads for one advertiser, found by domain or advertiser ID.
Pass a domain such as lululemon.com or an advertiser ID starting with AR as advertiser. Ads are listed roughly by most recent run. Rows carry no ad text, spend or impressions; open url or image_url to see the creative. advertiser_name is the verified name, which may be a subsidiary or agency. Only advertisers that completed Google's verification appear.
Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each Google Ads Transparency Center action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Adsads | List up to 100 ads a company has run on Google, from the Google Ads Transparency Center, by advertiser domain or advertiser ID. | $0.68 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each Google Ads Transparency Center action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and features of the official site are not part of the EveryInfra API unless this page lists them.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
adsAds List up to 100 ads a company has run on Google, from the Google Ads Transparency Center, by | advertiser | country, end_date, format, start_date, surface | Sync delivery | Catalog values: defaultLimit=100, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.68 per 1,000 requests | rank · ad_id · advertiser_id · advertiser_name · domain · format · first_shown_at · last_shown_at · image_url · url · advertiser_ads_estimate · platform |
What do the Google Ads Transparency Center ads parameters mean?
List up to 100 ads a company has run on Google, from the Google Ads Transparency Center, by advertiser domain or advertiser ID. Each row has ad ID, format (text, image or video), first and last shown time, preview image and the ad's Transparency Center link. Filter by country, format, surface and first-shown dates. Spend and impressions are not included.
advertiserRequired- Whose ads to list: a domain such as
nike.com, or an advertiser ID starting with AR such asAR01614014350098432001. A Transparency Center advertiser link also works.My Ad Center Help: Advertiser Verification and the Ads Transparency Center — Google's help page says advertisers must verify their identity with legal documentation, and that the Ads Transparency Center lets you search by advertiser name or website and filter by serving region and date. The source supports searching by domain or advertiser and filtering by country and dates; this API's parameters are defined by EveryInfra, and the source does not vouch for results. · Checked countryOptional- A two-letter country code such as
usorgbto keep only ads shown in that country. Leave it out for all regions. end_dateOptional- Keep only ads first shown on or before this date, YYYY-MM-DD; not before
start_date. formatOptional- Keep only one ad format:
text,imageorvideo.Allowed values:imagetextvideo start_dateOptional- Keep only ads first shown on or after this date, YYYY-MM-DD.
surfaceOptional- Keep only ads shown on one Google product:
search,youtube,play,mapsorshopping.
How to use the Google Ads Transparency Center API
- 01Choose a platform action from the public catalog.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Read the result from the response. For an asynchronous action, poll the returned job ID.
- 04Store the response fields that your application needs.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_ads_transparency","action":"ads","params":{"advertiser":"<advertiser>"}}'
Google Ads Transparency Center API questions
What can I retrieve with the Google Ads Transparency Center API?
Set platform to google_ads_transparency. The current catalog lists ads. These action names identify different Google Ads Transparency Center objects or views; they are not interchangeable search modes.
Which input starts the Google Ads Transparency Center ads request?
Whose ads to list: a domain such as nike.com, or an advertiser ID starting with AR such as AR01614014350098432001. A Transparency Center advertiser link also works. Send it as advertiser inside params.
Which fields can Google Ads Transparency Center ads return?
Its declared schema includes rank, ad_id, advertiser_id, and advertiser_name. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every Google Ads Transparency Center action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.