---

README

Google Ads Library

Search and extract Google ads for any advertiser. Find who is advertising, what they are saying, and how long their campaigns have been running. Works for Search, Shopping, YouTube, Maps, and Display ads across every country.

Two modes: find an advertiser by brand name or domain, then pull their full ad inventory.

---

Pricing

Action	Cost
Advertiser search	$1 per 1000 searches
Ad results	$1 per 1,000 ads

No monthly fee. Pay only for what you use.

---

What you get per ad

Field	Description
advertiser_id	Unique advertiser identifier
advertiser_name	Registered advertiser name
creative_id	Unique ad creative ID
format	IMAGE, VIDEO, or TEXT
status	ACTIVE, RECENTLY_ACTIVE, or INACTIVE
is_active	true if ad ran in the last 3 days
first_shown	Date the ad first appeared
last_shown	Date the ad was last shown
days_shown	Total days the ad has run
days_since_last_shown	Days since it last ran
headline	Ad headline (where available)
description	Ad description text
cta	Call-to-action text
destination_url	Landing page domain
display_url	Display URL shown in the ad
image_url	Direct image URL for display creatives
image_width / image_height	Image dimensions
transparency_url	Link to view the ad publicly

---

Modes

Find Advertiser

Search by brand name or domain and get a list of matching advertisers with their IDs, ad counts, and verified status. Results are sorted by ad volume so the most active advertiser appears first.

{
  "mode": "find_advertiser",
  "advertisers": ["Tanishq", "nalli.com"],
  "maxResults": 10
}

Use this first to find the correct advertiser ID before running a full ad scrape.

Scrape Ads

Fetch all ads for one or more advertisers. Pass a name, domain, or advertiser ID directly.

{
  "mode": "scrape_ads",
  "advertisers": ["AR16478616112506863617"],
  "region": "IN",
  "datePreset": "LAST_30_DAYS",
  "maxAdsPerAdvertiser": 200,
  "includeInactive": false
}

---

Input reference

Advertisers

Pass brand names, domains, or IDs. Mix freely.

"advertisers": [
  "Tanishq",
  "nalli.com",
  "AR16478616112506863617"
]

Region

ISO country code or anywhere for global results.

Examples: IN, US, GB, AE, SG, AU, DE

Platform

Value	Platform
ALL	All platforms (default)
SEARCH	Google Search
SHOPPING	Google Shopping
YOUTUBE	YouTube
MAPS	Google Maps
PLAY	Google Play

Date range

Value	Range
ANY_TIME	All time (default)
LAST_7_DAYS	Last 7 days
LAST_30_DAYS	Last 30 days
TODAY	Today only
YESTERDAY	Yesterday only

Or use startDate and endDate in YYYY-MM-DD format for a custom range.

Other options

Option	Default	Description
maxAdsPerAdvertiser	0 (unlimited)	Cap results per advertiser
includeInactive	true	Set false for active ads only
decodeAdContent	true	Decode headline and description from ad encoding

---

Example runs

Active ads for a competitor right now:

{
  "mode": "scrape_ads",
  "advertisers": ["nalli.com"],
  "region": "IN",
  "datePreset": "LAST_7_DAYS",
  "includeInactive": false
}

Bulk sweep across multiple brands:

{
  "mode": "scrape_ads",
  "advertisers": [
    "Tanishq",
    "Kalyan Jewellers",
    "Malabar Gold",
    "PNG Jewellers",
    "Joyalukkas"
  ],
  "region": "IN",
  "datePreset": "LAST_30_DAYS",
  "maxAdsPerAdvertiser": 100
}

YouTube video ads only:

{
  "mode": "scrape_ads",
  "advertisers": ["samsung.com"],
  "platform": "YOUTUBE",
  "formats": ["VIDEO"],
  "region": "anywhere"
}

Find the right advertiser before scraping:

{
  "mode": "find_advertiser",
  "advertisers": ["Pothys"],
  "maxResults": 5
}

---

Output example

{
  "advertiser_id": "AR16478616112506863617",
  "advertiser_name": "POTHYS SWARNA MAHAL PRIVATE LIMITED",
  "creative_id": "CR06718390446600486913",
  "format": "TEXT",
  "status": "ACTIVE",
  "is_active": true,
  "first_shown": "2024-10-02",
  "last_shown": "2026-04-18",
  "days_shown": 536,
  "days_since_last_shown": 1,
  "headline": "Rush to our Store today",
  "description": "25% off on MC on Antique Silver Articles and 0% MC on Plain Silver Articles",
  "cta": "Contact us",
  "destination_url": "pothysswarnamahal.com",
  "transparency_url": "https://adstransparency.google.com/advertiser/AR16478616112506863617/creative/CR06718390446600486913?region=IN"
}

---

Notes

Ad text (headline, description, CTA) is available for roughly 10 to 15 percent of ads. These are Search ads with fixed copy. Responsive and video ads assemble their text dynamically on Google's side and the copy is not publicly accessible. For those ads, the transparency_url field links directly to a viewable version of the ad.

Image ads include a direct image_url to the creative hosted on Google's CDN.

Data is sourced from public ad records that advertisers are required to make available. Coverage goes back to 2018.