Public Ads API
Get API key
Last updated 21 October 2026View as Markdown

Search, YouTube, ShoppingDomain or advertiserRegionsSandbox

Google Ads Transparency Center API

Search the Google Ads Transparency Center from your own software. Send an advertiser’s domain or Google advertiser id and get up to 100 ads a page as JSON.

Read the quickstart
  • Sandbox key straight away
  • 100 credits a month free
  • No card

GET /v1/google/ads?domain=example.com&country=GB

authorization: Bearer $PADS_API_KEY

Sandbox sample text, no media
GoogleText · 4 versions

Tailspin Travel Ltd

tailspin-travel.example

Tailspin Travel | City breaks from £99

Flights and hotel together. ATOL protected. Book by Sunday.

Text read from the ad’s image

Shown
13 Oct 2025 to 18 Oct 2026
Where
Search
Regions
GB, DE, IE
google_AR10000000000000000001_CR20000000000000000001In the library
A sandbox ad from a made-up advertiser
Up to 100 ads a page1 credit a page with adsEmpty pages freeSandbox instantLive status →

What you can search

Search the Google Ads Transparency Center

GET /v1/google/ads takes one of two subjects and the filters this library has. A filter it doesn’t have is refused by name, so nothing is silently ignored.

A domain

domain returns the ads of the advertiser verified for it. Google has no keyword search.

One advertiser

advertiser_id takes Google’s AR id, from any result’s advertiser.id.

  • domain
    Values
    The advertiser’s verified domain. Google has no keyword search.
    Default
    One subject is required
  • advertiser_id
    Values
    Google’s AR id, from a search result’s advertiser.id.
    Default
    One subject is required
  • country
    Values
    ISO 3166 alpha-2, or ALL
    Default
    ALL
  • format
    Values
    text, image, video
    Default
    All
  • surface
    Values
    search, youtube, shopping, maps, play
    Default
    All
  • political
    Values
    true, false
    Default
    false
  • date_from
    Values
    YYYY-MM-DD
    Default
    Any
  • date_to
    Values
    YYYY-MM-DD
    Default
    Any
  • cursor
    Values
    next_cursor from the last page, with the same parameters
    Default
    First page

One ad

What one ad’s detail adds

GET /v1/ads/{id} returns the ad with everything the Google Ads Transparency Center shows about it, in one call, for 1 credit.

  • Every variant of the ad.
  • Each country it ran in, with the first and last day it was shown.
  • For ads shown in the EU: impressions ranges by country, which targeting was used, and who paid.
  • Text ads come from Google only as an image, in media; their text may be null (text_source says ocr where it was read off the image).

GET https://api.publicadsapi.com/v1/ads/google_AR10000000000000000001_CR20000000000000000001

Where the library is thin

Google covers US ads with the dates they ran, but no impressions or targeting: those come only for ads shown in the EU and for political ads. Some advertisers verify under a different domain from the one they advertise, so a domain can come back empty when the advertiser does run ads.

ScrapeCreators, Adyntel (by domain only), SearchAPI, SerpApi, DataForSEO and Apify scrapers also search the Google Ads Transparency Center.

Sandbox

Every answer, before your first live search

Your sandbox key comes the moment you sign up. Any search returns sample ads from made-up advertisers in the live shape, and these searches return what a live one can. None of them uses a credit.

Read the quickstart

  • 200, no ads

    domain=empty.example

    A search that finds nothing. An empty page uses no credits.

  • 503 UPSTREAM_BLOCKED

    domain=blocked.example

    The platform refused every address we tried. Retry-After says when to try again.

  • 504 TIMEOUT

    domain=timeout.example

    The platform didn’t answer in time. Retry, or narrow the search.

  • 502 UPSTREAM_CHANGED

    domain=changed.example

    The platform’s page changed and we couldn’t read it. We are alerted.

1 credit

a page of ads, or one ad

Up to 100 ads a page. 100 credits a month free, no card.

$0.020

per 1,000 ads on Growth

With full pages: $49 a month for 25,000 credits.

$0

when there is nothing

Empty pages, blocks, timeouts and errors use no credits.

See pricing

Ask your AI about this API

It reads this page, then tells you if it fits, what it costs and what building it takes.

Ask ChatGPT about this(opens in a new tab)Ask Claude about this(opens in a new tab)

Questions

Before you build

Is there an official Google Ads Transparency API?

Google’s own API covers ads shown in the EEA only. Public Ads API reads the public Transparency Center instead, so ads shown anywhere come back, with each region they ran in.

What does a Google search cost?

A page of up to 100 ads uses 1 credit, and so does one ad with all its detail. On Growth ($49 for 25,000 credits) that is about $0.020 per 1,000 ads with full pages. An empty page, a block, an error and every sandbox call use nothing. The free plan has 100 credits a month and needs no card.

Can I search Google ads by keyword?

No. The Transparency Center has no keyword search, so neither do we. Search by the advertiser’s domain, or by its advertiser id.

Why does a domain come back empty?

Google files ads under the domain the advertiser verified, which is not always the one in the ads. An empty page uses no credits. Try the advertiser’s other domains, or its advertiser id.

Do text ads come back as text?

Not always. Google shows search text ads only as an image, which comes back in media. Their text may be null; where we have read the words off the image, text_source is ocr.

Your first Google Ads Transparency Center search, in the next ten minutes

Sandbox key straight away. 100 credits a month free.

Read the quickstart