> Search the Google Ads Transparency Center by domain or advertiser id. Up to 100 ads a page as JSON, with the regions each ran in. 1 credit a page.

Web version: https://publicadsapi.com/google-ads-transparency-api · Last updated: 2026-10-21

# 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](https://publicadsapi.com/docs/quickstart)

-   Sandbox key straight away
-   100 credits a month free
-   No card

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.

Parameters of GET /v1/google/ads
| Parameter | Values | Default |
| --- | --- | --- |
| `domain` | The advertiser’s verified domain. Google has no keyword search. | One subject is required |
| `advertiser_id` | Google’s AR id, from a search result’s advertiser.id. | One subject is required |
| `country` | ISO 3166 alpha-2, or ALL | ALL |
| `format` | text, image, video | All |
| `surface` | search, youtube, shopping, maps, play | All |
| `political` | true, false | false |
| `date_from` | YYYY-MM-DD | Any |
| `date_to` | YYYY-MM-DD | Any |
| `cursor` | next\_cursor from the last page, with the same parameters | 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](https://publicadsapi.com/docs/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](https://publicadsapi.com/pricing)

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](https://publicadsapi.com/docs/quickstart)