Google Ads Transparency API
Ads, advertisers.
The Google Ads Transparency API lets you list an advertiser's ads, find advertisers and read one ad, with no Google Ads Transparency account or login. Each call costs 2 credits ($0.004 to $0.0067); failed calls are free. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-10-17.
Last tested: Last updated:
/v1/call/google.advertiser_ads200 OK2 creditsid: "AR16735076323512287233"- entry_type
- ad
- format
- image
- text
null- landing_url
null- first_shown_at
- 2023-07-11T16:20:02.000Z
- last_shown_at
- 2026-10-12T21:35:00.000Z
titlefields.textfields.landing_urlfields.advertiser.url3 interfaces.
One response format.
Open a row to see its request. Its full parameters and response fields are on its own page.
Google Ads Transparency has none of the 6 shared actions (search, trending, detail, comments, user_profile and user_posts). Every interface here is called by its own op, through POST /v1/call/{op}.
Advertiser's adsPreviewGet an advertiser's ads from the Google Ads Transparency Center, by the advertiser's ID.google.advertiser_ads2 credits
Get an advertiser's ads from the Google Ads Transparency Center, by the advertiser's ID: format (text, image, video), when each was first and last shown, and a picture of it; can be limited to a country and to one format. 40 ads a page; what an ad says and where it leads come from the Google ad capability.
id+2 optionalcurl https://api.socialtoai.com/v1/call/google.advertiser_ads \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "AR16735076323512287233" }'POST /v1/call/google.advertiser_adsYour key goes in the Authorization headerAdvertiser searchPreviewFind advertisers in the Google Ads Transparency Center by name.google.advertiser_search2 credits
Find advertisers in the Google Ads Transparency Center by name: ID, name, the country or region they are registered in, and the center's estimate of how many ads they have. The ID is what the advertiser's ads are asked for by.
query+1 optionalcurl https://api.socialtoai.com/v1/call/google.advertiser_search \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "nike" }'POST /v1/call/google.advertiser_searchYour key goes in the Authorization headerAd detailPreviewGet one ad of the Google Ads Transparency Center by its ID or link.google.ad_detail2 credits
Get one ad of the Google Ads Transparency Center by its ID or link: format, headline, description, landing page, images and videos, when it was first and last shown, the countries or regions it was shown in, and the range of total impressions where the center publishes it.
id or urlcurl https://api.socialtoai.com/v1/call/google.ad_detail \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "AR16735076323512287233/CR13384474926044413953" }'POST /v1/call/google.ad_detailYour key goes in the Authorization headerPreview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.
Does Google Ads Transparency have an official API?
Google publishes Ads Transparency Center data as a free public BigQuery dataset and Cloud Storage download, covering ads served in the EEA and Turkey. Google says it provides API access to data on ads served in the EEA; for other regions, API access may be given only to regulators and self-regulatory organisations.
Source: Google Ads Transparency's developer documentation, checked 2026-10-17.