Google Ads Transparency scraper API
The InsightSocial Google Ads Transparency API has 3 endpoints, from 20 credits a call. A ad library advertisers search call costs 20 credits, about $0.02 on Pro, and your first 10 calls up to 100 credits each are free.
The Google Ads Transparency Center as an API: find an advertiser by name, list the ads a company runs by its domain or advertiser id, and read any one creative with its text, dates and regions.
3 endpoints · from 20 credits a call · 10 free calls up to 100 credits each · no credit card
curl "https://api.insightsocial.app/v1/google/ad-library/advertisers/search?query=example+outdoor" \-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
What Google Ads Transparency data can you get?
Public Google Ads Transparency data only, in the same JSON envelope as every other platform. Every Google Ads Transparency endpoint is beta: inside data it returns Google Ads Transparency's own structure under our naming rules (snake_case keys, string ids, ISO times where Google Ads Transparency gives a timestamp), not the shared profile and post schema, and fields may change.
Advertisers
Advertisers that match a name, with their advertiser id, region and an estimate of how many ads each has run, plus the websites that match.
Every ad a company runs
The ads for a domain or advertiser id, filtered by region, date range, Google surface and format, each with first and last shown dates, impression range, regions and the text of its variations.
One creative
A single ad from its Ads Transparency Center URL: format, advertiser, regions, dates and its headlines, descriptions and landing pages.
What people build with the Google Ads Transparency API
Competitor ad research
Look up a competitor by domain and read every ad they run on Google: headlines, landing pages, formats and how long each ran.
Market entry checks
Filter a company's ads by region to see where it advertises before you launch in the same country.
Creative swipe files
Collect the text and landing pages of a category's ads into one table and see which angles advertisers keep running.
Google Ads Transparency API endpoints
All 3 Google Ads Transparency endpoints and their price in credits. Every one has a fixed price.
| Endpoint | Credits | What it returns |
|---|---|---|
| /ad-library/ads | 20 | Get a single Google Ad Transparency creative by public Ad Transparency URL. |
| /ad-library/advertisers/search | 20 | Search Google Ad Transparency advertisers by name. |
| /ad-library/companies/ads | 320 | List ads a company or advertiser is running in Google Ad Transparency. |
Parameters, response fields and examples for each endpoint are in the Google Ads Transparency API reference.
InsightSocial vs the official Google Ads Transparency API
Google publishes the Ads Transparency Center as a searchable website. The Google Ads API manages campaigns in the accounts you have access to, not other advertisers' ads.
| InsightSocial API | Official Google Ads Transparency API | |
|---|---|---|
| Whose ads | Any advertiser in the Ads Transparency Center | Google Ads API: accounts you manage |
| Setup | Sign in and copy a key | Google Ads API: developer token and OAuth |
| Other ad libraries | TikTok and LinkedIn ad libraries on the same key | Google only |
| Cost per call | 20 credits | No API for other advertisers' ads |
The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.
How much does the Google Ads Transparency API cost?
Google Ads Transparency calls start at 20 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 500 advertiser searches at 20 credits each.
Failed calls are free
A call that errors or finds nothing costs 0 credits.
Repeats and retries
A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
One balance
API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.
Not writing code?
Connect InsightSocial to Claude or ChatGPT and ask for Google Ads Transparency data in plain English. Same account, same credits.
Google Ads Transparency API: frequently asked questions
Yes. /v1/google/ad-library/companies/ads takes a company domain or an advertiser id and returns its ads, each with format, first and last shown dates, impression range, regions and the text and landing page of each variation.
/v1/google/ad-library/advertisers/search takes a name and returns matching advertisers with their ids and regions. You can also skip it and pass the company's domain.
The ads list takes a two-letter region, a start and end date, a Google surface and a creative format.
They return the Ads Transparency Center's own record shapes under our naming rules (snake_case keys, string ids, ISO times) rather than the shared profile and post entities, so fields may change. An advertiser search or a single creative is 20 credits; the list of a company's ads is 320 credits a call. Calls that fail or find nothing are free.
No. There is no Google Ads Transparency app, OAuth flow or review. One API key in the x-api-key header works for Google Ads Transparency and the other 60 platforms.
Yes. Your first 10 calls priced at 100 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.
60 requests a minute and 10 requests in flight at once, per API key. Going over either returns a 429 with a Retry-After header, and a rejected request costs nothing. There is no daily quota: past those two limits, your credit balance is what bounds volume.
List endpoints return rows in data.items and a pagination object with next_cursor and has_more. Send next_cursor back unchanged as the cursor parameter for the next page, and stop when has_more is false. A handful of endpoints page with their own parameter instead; their reference pages name it.
No. A call that errors or finds nothing costs 0 credits. A live fetch costs the endpoint's price, or for a metered endpoint what it actually read. A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
A call fetches live unless a recent copy is in the shared cache, and every response says which with the cached field; a cached answer costs 2 credits. Add fresh=1 or send Cache-Control: no-cache to skip the cache; that call is charged at the normal price.
Collecting publicly available data is generally treated differently from accessing private data, but the answer depends on your jurisdiction, Google Ads Transparency's terms and what you do with personal data afterwards. The API reads public data only. Talk to a lawyer for anything commercial.
Google Ads Transparency API guides
The same key works for 60 more platforms
- TikTok scraper API
- LinkedIn scraper API
- Twitter/X scraper API
- YouTube scraper API
- Reddit scraper API
- Pinterest scraper API
- Bluesky scraper API
- Truth Social scraper API
- Snapchat scraper API
- Telegram scraper API
- Twitch scraper API
- Kick scraper API
- Rumble scraper API
- Kwai scraper API
- Douyin scraper API
- Xiaohongshu (RedNote) scraper API
- Quora scraper API
- TikTok Shop scraper API
- Weibo scraper API
- Zhihu scraper API
- Substack scraper API
- Nextdoor scraper API
- Amazon scraper API
- App Store scraper API
- Apple Music scraper API
- Behance scraper API
- Dailymotion scraper API
- Deezer scraper API
- DEV Community scraper API
- Discord scraper API
- Dribbble scraper API
- Fandom scraper API
- Flickr scraper API
- GitHub scraper API
- Google News scraper API
- Google Trends scraper API
- Gumroad scraper API
- Hacker News scraper API
- Hugging Face scraper API
- Ko-fi scraper API
- Lemmy scraper API
- Letterboxd scraper API
- Linktree scraper API
- Lnk.Bio scraper API
- Mastodon scraper API
- Medium scraper API
- MyAnimeList scraper API
- npm scraper API
- Polymarket scraper API
- Product Hunt scraper API
- Shopify scraper API
- SoundCloud scraper API
- Spotify scraper API
- Stack Overflow scraper API
- Stan Store scraper API
- Steam scraper API
- Vimeo scraper API
- Wikipedia scraper API
- Yahoo Finance scraper API
- Yelp scraper API