Skip to content
Gridlode
Launching soonSocial media and video2 credits / page

Google Ads Transparency Center API

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.

GEThttps://api.gridlode.com/v1/social/google/ads
Get an API keyReference docs
This engine is built and is waiting for a terms review of the target site before we switch it on. Join early access through the contact form and we'll email you on launch day.

Parameters

NameTypeDescription
domainstringAdvertised website, e.g. nike.com (a URL also works): ads that point to this domain, from any advertiser.
Default: null
advertiser_idstringAdvertiser id from the Transparency Center (AR followed by 20 digits): all of that advertiser's ads.
Default: null
regionstringWhere the ads were shown: 'anywhere' or a 2-letter country code such as US, GB, DE.
Default: "anywhere"
formatstringAd format filter.
Default: "all"
One of: all, text, image, video
limitintegerMaximum ads to return (40 per page fetched; each page fetched is one billed unit).
Default: 40
page_tokenstringnext_page_token from a previous response, to continue the same search.
Default: null
max_ageintegerAccept a cached answer up to this many seconds old, billed at 50%. Default 0 (always fresh).

Response fields

    Code

    curl "https://api.gridlode.com/v1/social/google/ads?domain=nike.com&region=US" \
  -H "Authorization: Bearer $GRIDLODE_KEY"
    2 credits per page
    One credit is $0.001 on the smallest pack, from $0.0003 on enterprise plans.
    Half price for cached data
    Cached for up to 6 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Market reference: SerpApi Google Ads Transparency Center (plans from ~$15 per 1k searches); Apify Google Ads Transparency scrapers ~$1-5 per 1k ads.

    Questions

    Part of these solutions
    How much does the Google Ads Transparency Center API cost?

    2 credits per page. One credit costs $0.001 on the smallest pack and as little as $0.0003 on enterprise plans. Cached answers cost half and failed calls are free.

    Social media and video

    Related APIs in this category

    All 13 in Social media and video · 7 live
    Live

    YouTube Video Details

    Public metadata of one YouTube video from its watch page, as a signed-out visitor sees it

    1 credit / requestDocs
    Live

    TikTok Profile

    A public TikTok creator or brand profile exactly as a signed-out visitor sees it

    2 credits / requestTry freeDocs
    Live

    YouTube Comments

    Public comments on one YouTube video, in YouTube's Top or Newest order, exactly as a signed-out visitor can load them

    0.05 credits / commentDocs
    Soon

    Meta Ad Library

    Search Meta's public Ad Library (Facebook, Instagram, Messenger, Audience Network) by keyword or advertiser Page id for any country

    2 credits / pageDocs