Google Ads Transparency
Provides tools for querying Google Ads Transparency Center data for a domain, returning advertiser, ad format, first/last shown dates, days shown, and links to ads; supports filtering by country, format, minimum days shown, and sort order, with optional ad copy retrieval through the hosted version.
Google Ads Transparency Scraper (Python)
A small Python script that lists the ads any domain runs, taken from the Google Ads Transparency Center (Google's ad library). No API key, no login, no dependencies beyond the standard library.
For each ad you get the advertiser, format, first shown, last shown and days shown, plus a link to the ad in the Transparency Center. Filter by country and format, keep only long-running ads, export JSON or CSV.
python gads_transparency.py nike.com --region US --format text --min-days 30 --sort longestAlso works as an MCP server for Claude, Cursor and other AI clients: a free list_ads tool, plus get_ads_with_copy for ad text through the hosted version. See Use it as an MCP server.
Is there a Google Ads Transparency API?
No. Google does not offer an official API for the Ads Transparency Center. The website loads its data from an internal JSON endpoint, and this script calls that same endpoint the way the site does:
POST https://adstransparency.google.com/anji/_/rpc/SearchService/SearchCreativesThe request is a form field f.req holding a small JSON object: the domain, optional country and format filters, a page size of 40 and a page token for the next page. gads_transparency.py is about 150 lines and you can read all of it in a few minutes.
Related MCP server: Google Ads Library MCP Server
Quick start
Requires Python 3.8+. Nothing to install for the script (the MCP server needs pip install -r requirements.txt).
git clone https://github.com/datalumehq/google-ads-transparency-scraper.git
cd google-ads-transparency-scraper
python gads_transparency.py nike.comOr download gads_transparency.py on its own and run it.
Options
Option | What it does | Example |
| Advertiser website (required) |
|
| Country where the ad was shown: a 2-letter code from the built-in list, or a numeric region ID |
|
|
|
|
| Maximum ads to fetch (default 100) |
|
| Keep ads shown on at least N days |
|
|
|
|
| Write CSV instead of printing JSON |
|
Region IDs are 2000 + ISO 3166-1 numeric country code (United States is 840, so 2840). Pass any numeric ID if your country is not in the built-in list.
Output
Real output from 17 November 2026 (nike.com, US, text ads; Google reported 7,000 to 8,000 ads for this filter):
[
{
"advertiserId": "AR16735076323512287233",
"advertiserName": "Nike, Inc.",
"domain": "nike.com",
"creativeId": "CR18169758746572488705",
"format": "text",
"firstShown": "2022-11-30",
"lastShown": "2026-11-17",
"daysShown": 1401,
"transparencyUrl": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR18169758746572488705?region=anywhere"
}
]daysShown is the number of days Google recorded the ad as shown. An ad that an advertiser keeps paying for over hundreds of days is usually one that works, which is why --min-days 30 --sort longest is a quick way to find a competitor's proven ads.
Why there is no ad copy here
The list endpoint returns dates and IDs, not the headline and description. Getting the copy takes one more request per ad, and then a second problem appears: for many large advertisers Google stores text ads only as images. In our tests, 149 of 150 booking.com and 120 of 120 expedia.com text ads had no text version at all, so the copy has to be read from the screenshot.
That part (per-ad detail requests, screenshot reading, countries per ad, retries when Google rate-limits) is what the hosted version below does. This script stays small on purpose.
Limits of this script
One domain per run, list data only (no ad copy, no per-country breakdown, no impression ranges).
No proxy handling. If you request many pages quickly, Google answers with a non-JSON page; the script stops and tells you. Wait a few minutes and use a smaller
--max.--min-daysand--sortapply to the ads that were fetched, so raise--maxto look deeper.The endpoint is internal and can change without notice. If the script breaks, please open an issue.
Hosted version with ad copy
If you need the copy, many domains, or a daily feed of new ads, the same data source is available as a maintained Apify Actor: Google Ads Transparency Scraper - Ad Copy & Days Running.
It adds:
Ad copy (headline, description, display URL), including screenshot-only text ads and responsive search ads
Countries per ad with last shown date per country, and impression ranges where Google publishes them
Search by domain, advertiser ID or advertiser name, many targets in one run
Platform filter (Search, YouTube, Shopping, Maps, Play) and date range
Only new ads since the last run, for scheduled monitoring
Pay per result; failed rows are not charged
From Python (pip install apify-client, see run_apify_actor.py):
from apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("datalume/google-ads-transparency-scraper").call(run_input={
"domains": ["booking.com"],
"region": "US",
"minDaysRunning": 30,
"sortBy": "longestRunning",
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item["daysShown"], item.get("headline"), item.get("description"))The same features are available to AI agents through the MCP server below (get_ads_with_copy).
Use it as an MCP server
mcp_server.py exposes two tools to any MCP client (Claude Desktop, Claude Code, Cursor, VS Code). Requires Python 3.10+.
Tool | Cost | What it returns |
| Free, no API key | One domain's ads: advertiser, format, first/last shown, days shown, link. Filters: country, format, minimum days shown, sort |
| Paid per result through your Apify account (about $0.002 per ad, $0.0035 per ad with copy on Apify's free plan) | Ad copy (headline, description, display URL) including screenshot-only text ads, countries per ad, many domains or advertiser names. Each call has a spending cap ( |
Install:
git clone https://github.com/datalumehq/google-ads-transparency-scraper.git
cd google-ads-transparency-scraper
pip install -r requirements.txtClaude Desktop (claude_desktop_config.json), Cursor (~/.cursor/mcp.json) and most other clients use the same block. Use the full path to mcp_server.py:
{
"mcpServers": {
"google-ads-transparency": {
"command": "python",
"args": ["/path/to/google-ads-transparency-scraper/mcp_server.py"],
"env": { "APIFY_TOKEN": "<optional, only for get_ads_with_copy>" }
}
}
}Claude Code:
claude mcp add google-ads-transparency -- python /path/to/google-ads-transparency-scraper/mcp_server.pyThen ask in plain language, for example:
"Which text ads has nike.com been running for 30+ days in the US?" (free)
"Show me the headlines of booking.com's longest-running search ads in the US" (uses
get_ads_with_copy)
Without APIFY_TOKEN the free tool works and the paid tool returns a message explaining how to add a token. Get a token at console.apify.com/settings/integrations.
Prefer not to run anything locally? Apify's hosted MCP endpoint serves the same Actor: https://mcp.apify.com?tools=datalume/google-ads-transparency-scraper (sign in with Apify on first use).
FAQ
Is scraping the Google Ads Transparency Center allowed? The Transparency Center is a public site that Google built so anyone can see who is advertising. This script reads the same public data your browser does, without logging in. Use it responsibly: keep request volume low and check the terms that apply to you.
Can I search by advertiser name instead of domain? Not in this script. The hosted version accepts advertiser names, advertiser IDs and Transparency Center links.
Why do I get fewer ads than the website's counter shows?
Google reports a rough range (for example 7,000 to 8,000), and this script stops at --max. Raise it to fetch more pages.
Does it work for Google Ad Library, YouTube ads or Shopping ads? "Google Ad Library" is another name people use for the Ads Transparency Center. The list includes ads from Search, YouTube, Shopping, Maps and Play; this script does not filter by platform, the hosted version does.
More
Tutorial: How to Export Google Ads Transparency Center Data (with Ad Copy) in Python
Other scrapers by datalume: apify.com/datalume
License
MIT. Built with AI assistance; numbers come from real runs on the dates shown. MCP tools tested on 18 November 2026.
Not affiliated with, endorsed by or sponsored by Google. This project only reads publicly available ad information from the Google Ads Transparency Center.
Available Tools
2 toolsget_ads_with_copyA
Get Google ads WITH their ad copy (headline, description, display URL), including text ads that Google stores only as screenshots, plus the countries each ad ran in.
Runs the hosted Apify Actor "datalume/google-ads-transparency-scraper" with your own
Apify account. Requires the APIFY_TOKEN environment variable. It is PAID per result
(about $0.002 per ad, $0.0035 per ad with copy on Apify's free plan; failed rows are free).
The run stops at max_total_charge_usd. Prefer list_ads when the ad text is not needed.
Args:
domains: advertiser websites, e.g. ["booking.com"].
advertiser_names: advertiser names to look up, e.g. ["Samsung Electronics"].
region: 2-letter country code (e.g. "US") or "anywhere".
platform: "all", "search", "youtube", "shopping", "maps" or "play".
ad_format: "all", "text", "image" or "video".
min_days_running: keep ads shown on at least this many days.
sort_by: "recentlyShown", "longestRunning" or "newest".
max_ads_per_target: maximum ads per domain or name (keep small to control cost).
max_total_charge_usd: hard spending cap for this call, in USD.
Inputs: region, domains, sort_by, platform, +5 more. Returns: result
list_adsA
List the ads an advertiser runs, from the Google Ads Transparency Center (Google's ad library). Free, no API key.
Returns one row per ad: advertiser name and ID, format, first shown, last shown,
days shown and a link to the ad. It does NOT return the ad text (headline,
description); use get_ads_with_copy for that.
Args:
domain: advertiser website, e.g. "nike.com".
region: 2-letter country code where the ad was shown, e.g. "US", "GB", "DE". Empty = all countries.
ad_format: "text", "image" or "video". Empty = all formats.
max_ads: how many ads to fetch, 1-200 (40 per page from Google).
min_days_shown: keep only ads shown on at least this many days. Use 30+ to find long-running ads.
sort: "recent" (most recently shown first) or "longest" (most days shown first).
Inputs: domain (required), sort, region, max_ads, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools overlap in that both retrieve Google ads, but the split is clear: list_ads is free metadata-only, while get_ads_with_copy is paid and adds ad copy plus country coverage. Descriptions explicitly guide selection, though an agent might still initially hesitate over which to use when ad text is not the primary need.
Both names use snake_case with a clear verb_noun structure: list_ads and get_ads_with_copy. The get_ads_with_copy variant is more descriptive but remains predictable and consistent with the list/get action pattern.
The server has a narrow purpose, so two tools is defensible: one free listing tool and one paid copy-enrichment tool. It is slightly thin, but each tool has a distinct role and there is no redundant clutter.
The surface covers the main lifecycle of finding ads and retrieving their copy, including filtering by domain, region, format, duration, and spending caps. Minor gaps exist, such as richer advertiser lookup in the free tool or direct ad-detail retrieval, but core workflows are covered.
Maintenance
Related MCP Connectors
Every ad a brand runs on Google Search, YouTube and Display, from Google's Ads Transparency Center: format, first and last shown, days running, ad text, images and links. Find advertisers by name or domain. Runs on Apify.
Every ad an advertiser runs on Google, from the public Ads Transparency Center. Unofficial tool.
Every Google ad a company runs, by domain: advertiser, format, dates. Runs on Apify.
Every ad of any advertiser, as one MCP tool through Apify
Related MCP Servers
- FlicenseAqualityDmaintenanceSearches the Meta (Facebook) Ad Library by keyword and returns ad details including advertiser, ad copy, and EU reach, without requiring an API key.31-
- AlicenseNot gradedqualityDmaintenanceEnables users to search the Google Ads Transparency Center for company ads, inspect ad details and variations, analyze images and videos, and compare competitor advertising strategies.5 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables searching and scraping the public Facebook Ad Library to extract structured ad data such as advertiser, copy, landing URLs, and CTAs for competitive research, all without an account or API token.MIT
- FlicenseNot gradedqualityBmaintenanceEnables querying Google Ads Transparency data for advertiser suggestions, creatives, and ad history through a hosted API with built-in anti-bot handling.-