Google Ad Library API v1
Find the ads any advertiser is running across Google Search, YouTube, Shopping, Maps and Play, read one ad in full, and download its video and image files, from https://api.fetchlayer.dev/google-ad-library. No Google Cloud project, no OAuth consent screen, no Ads API developer token — just your FetchLayer key.
Google Ad Library API at a glance
This is the reference: every endpoint, its parameters and the fields it returns. The essentials first.
- Returns
- Ads across Search, YouTube and Display, as typed JSON.
- Endpoints
- 8 endpoints, grouped as Ads, Advertisers, Media and Utility. See them all
- Request
POST https://api.fetchlayer.dev/google-ad-library/<endpoint>with a JSON body.- Auth
- Your FetchLayer API key as a Bearer token. One key works for every platform we support. Authentication
- Cost
- 1 credit per page of results a call returns; the exact figure is on every response. Credits are $1.99 per 1,000 pay-as-you-go, plans start at $25 a month, and new accounts get 30 free requests.
- MCP
- Also on our MCP server for AI agents, with the same key and the same billing. Connect an agent
What teams use it for, with worked examples: Google Ad Library API
Read this first
Google's Ads Transparency Center is organised by advertiser, not by ad text. There is no keyword search over ad copy — none exists upstream — so /search-ads resolves a brand name or a website to advertisers and returns their ads. Every search tells you which advertisers it matched, on matchedAdvertisers, so you can confirm it found the right company before you trust the results.
Two further ceilings worth knowing before you build against this: Google publishes ad counts as ranges rather than exact figures, and it publishes ads as pictures of the rendered ad rather than as separate headline, body and call-to-action fields. Every response carries a notes array reporting anything specific to that result — a page walk that stopped short, a listing that may be incomplete, run dates that could not be resolved. Read it before treating a result set as the whole picture.
Available endpoints
/search-ads POST Get every ad one advertiser runs /advertiser-ads POST Find advertisers by name /search-advertisers POST Get an advertiser's verified identity /advertiser-profile POST Get one ad in full /ad-detail POST Get an ad's videos and images /ad-media GET Download an ad media file /media POST Parse an Ad Library URL /resolve-url