Skip to content
Gridlode
Docs · Reference

Google Ads Transparency Center

GET /v1/social/google/ads2 credits / pagecache 360 min

Ads from Google's public Ads Transparency Center (Search, YouTube, Display, Shopping, Maps and Play) for a website domain or an advertiser id, in any country or anywhere: the advertiser (name, id, legal name, location and whether Google verified its identity), every advertiser running ads for the domain, the estimated total number of ads, and for each ad its creative id, link, format (text, image or video), first and last shown dates, number of days shown, the archived image of text ads and Google's preview URL for image and video ads. Filter by format; 40 ads per page with a token to continue. We never sign in, so age-restricted ads are not listed. Blocked requests, unknown advertisers and empty pages are free.

Query parameters

domain
string
Advertised website, e.g. nike.com (a URL also works): ads that point to this domain, from any advertiser.
Default: null
advertiser_id
string
Advertiser id from the Transparency Center (AR followed by 20 digits): all of that advertiser's ads.
Default: null
region
string
Where the ads were shown: 'anywhere' or a 2-letter country code such as US, GB, DE.
Default: "anywhere"
format
string
Ad format filter.
Default: "all"
Allowed: all, text, image, video
limit
integer
Maximum ads to return (40 per page fetched; each page fetched is one billed unit).
Default: 40
page_token
string
next_page_token from a previous response, to continue the same search.
Default: null
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/social/google/ads?domain=nike.com&region=US" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Google Ads Transparency Center API page.