# Google Ads Transparency Scraper (`webdatatools/google-ads-transparency-scraper`) Actor

Google Ads Transparency Scraper extracts ad creatives from Google's Ad Transparency Center. Search by advertiser domain, advertiser ID, or name, filter by region and date range, and retrieve creative details including text, images, video previews, and show/hide dates.

- **URL**: https://apify.com/webdatatools/google-ads-transparency-scraper.md
- **Developed by:** [Murat Uzun](https://apify.com/webdatatools) (community)
- **Categories:** Developer tools, Marketing, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.60 / 1,000 ads

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Ads Transparency Scraper

### What is Google Ads Transparency Scraper?

Google Ads Transparency Scraper extracts ad creatives from [Google's Ad Transparency Center](https://adstransparency.google.com/). It allows you to search for ads by advertiser domain, advertiser ID, or company name, and retrieve comprehensive details about ad campaigns including creative format, dates shown, targeted regions, and preview URLs. The scraper uses Google's official SearchService API, verified to work from Apify datacenter IPs.

This tool is designed for researchers, marketers, and competitors analyzing public ad strategies. Google publishes this data to promote advertiser transparency under EU regulations.

### What data does Google Ads Transparency Scraper extract?

The scraper returns one row per ad creative with the following fields:

| Field | Type | Description |
|-------|------|-------------|
| `creativeId` | string | Unique identifier for the ad creative (e.g., CR123456789) |
| `advertiserId` | string | Google Ads Transparency advertiser ID (e.g., AR123456789) |
| `advertiserName` | string | Display name of the advertiser |
| `domain` | string | Primary domain of the advertiser (e.g., nike.com) |
| `format` | string | Ad creative format: text, image, or video |
| `firstShown` | string | ISO 8601 date when the ad was first shown |
| `lastShown` | string | ISO 8601 date when the ad was last shown |
| `regionCount` | integer | Number of regions where the ad appeared |
| `regions` | string | Comma-separated region codes (e.g., US,GB,DE) |
| `previewUrl` | string | Direct link to view the ad on Google's platform |
| `imageUrl` | string | URL to image content (for image-format ads) |
| `videoUrl` | string | URL to video content (for video-format ads) |
| `adText` | string | Text content of the ad (for text-format ads) |
| `transparencyUrl` | string | Permanent link to the ad in the Transparency Center |
| `searchedFor` | string | The advertiser domain/ID/name used in the search |
| `scrapedAt` | string | ISO 8601 timestamp of the scrape |

Nullable fields (all except `scrapedAt`) return `null` when data is not available.

### How to use Google Ads Transparency Scraper

1. **Enter advertiser identifiers**: Provide advertiser domains (nike.com), advertiser IDs (AR123456789), or company names. Separate multiple values with semicolons.

2. **Set filters (optional)**:
   - **Region**: Restrict results to a specific region code (US, GB, DE, etc.). Leave blank to include all regions.
   - **Date range**: Specify a start and end date in ISO 8601 format (2024-01-01) to filter ads by when they were shown.
   - **Ad format**: Filter by format (text, image, video, or all).

3. **Configure options**:
   - **Max ads per advertiser**: How many ads to retrieve (default 40, max 200). Higher values increase runtime and cost.
   - **Include details**: Set to true to fetch full creative content via GetCreativeById (slower, more detailed).

4. **Run the actor**: The scraper will fetch ads for each advertiser, handling pagination automatically and respecting your budget limit.

5. **Review results**: Download the dataset as CSV or JSON. Errors are logged to a Key-Value Store record named `ERRORS`.

### Example input

```json
{
  "advertisers": "nike.com; shopify.com",
  "region": "US",
  "dateFrom": "2024-09-01",
  "dateTo": "2024-09-28",
  "format": "all",
  "maxAds": 60,
  "includeDetails": false
}
```

This searches for ads from Nike and Shopify shown in the US between September 1 and 28, 2024, fetching up to 60 ads per advertiser.

### Example output

```json
[
  {
    "creativeId": "CRabc123def456",
    "advertiserId": "AR1234567890123",
    "advertiserName": "Nike, Inc.",
    "domain": "nike.com",
    "format": "text",
    "firstShown": "2024-01-15",
    "lastShown": "2024-09-28",
    "regionCount": 3,
    "regions": "US,GB,DE",
    "previewUrl": "https://adstransparency.google.com/advertiser/AR1234567890123/creative/CRabc123def456",
    "imageUrl": null,
    "videoUrl": null,
    "adText": "Nike Running Shoes - Discover the latest technology.",
    "transparencyUrl": "https://adstransparency.google.com/advertiser/AR1234567890123/creative/CRabc123def456",
    "searchedFor": "nike.com",
    "scrapedAt": "2024-09-28T14:32:05.123Z"
  }
]
```

### Input parameters

- **advertisers** (string): Semicolon-separated advertiser domains, IDs, or names. Example: "nike.com; AR123456789; Shopify".
- **domain** (string, alias): Single advertiser domain. Use `advertisers` for multiple values.
- **advertiser** (string, alias): Single advertiser domain, ID, or name. Use `advertisers` for multiple values.
- **region** (string, optional): Region code to filter results (e.g., US, GB, DE). Default: all regions.
- **dateFrom** (string, optional): Start date in ISO 8601 format (YYYY-MM-DD). Default: no filter.
- **dateTo** (string, optional): End date in ISO 8601 format (YYYY-MM-DD). Default: no filter.
- **format** (string): Ad format filter: `all`, `text`, `image`, or `video`. Default: `all`.
- **maxAds** (integer): Maximum ads per advertiser (1–200). Default: 40.
- **includeDetails** (boolean): Fetch full creative details via GetCreativeById. Default: false.

### Pricing

Google Ads Transparency Scraper is priced at **$0.001 per ad** (one row). Volume discounts apply on higher Apify plans:

- **FREE / $49 plan**: $0.001/ad
- **$499 plan**: $0.0008/ad (20% discount)
- **$999 plan**: $0.0007/ad (30% discount)
- **$1,999+ plan**: $0.0006/ad (40% discount)

A typical run at default settings (40 ads × 2 advertisers) costs **$0.08**. A multi-advertiser batch run fetching 60 ads each from 10 advertisers costs **$0.60**.

### Google Ads Transparency Scraper vs. alternatives

| Aspect | Google Ads Transparency Scraper | Google Ads API (official) | Manual search on adstransparency.google.com |
|--------|--------------------------------|-------------------------|---------------------------------------------|
| **Cost** | $0.001–0.0006/ad (pay-per-result) | $18–$60/month (flat) | Free (manual labor) |
| **Data source** | Official Google Ads Transparency Center | Advertiser account data | Same as scraper |
| **Coverage** | Public EU-regulated ads only | All advertiser data | Same as scraper |
| **Automation** | Full API, batch-ready | Requires Google account + API key | N/A |
| **Region filter** | Yes | Yes | Limited UI |
| **Date range** | Yes | Limited | Limited UI |
| **Time to 100 ads** | ~10 seconds | Minutes (manual) | Hours (manual) |

The scraper is ideal for researchers and competitors analyzing ad strategies at scale. The official Google Ads API is better if you have advertiser account credentials and need internal campaign metrics.

### Using Google Ads Transparency Scraper with AI agents and MCP

The actor integrates with Anthropic's Model Context Protocol (MCP). AI agents can call it to analyze competitors' ad spending and strategies:

```
fetch-actor-details(id: "google-ads-transparency-scraper") → input schema, output schema
call-actor(id: "google-ads-transparency-scraper", input: {...}) → dataset rows
```

Example agent request:

> "Find all video ads from Shopify shown in the US in the last 30 days, and summarize their messaging."

The MCP server will call the actor, retrieve the dataset, and relay results to the agent.

### FAQ

#### Legal and compliance

**Is it legal to scrape adstransparency.google.com?**

Yes. Google publishes the Ads Transparency Center specifically to comply with EU regulations requiring advertiser transparency. The data is public and intended for public access. Apify's terms of service permit scraping of public data from officially available sources. The actor does not bypass authentication or rate limits—it uses the official SearchService API endpoint visible to all users.

**What jurisdictions does this cover?**

The Ads Transparency Center focuses on EU regulations (GDPR, Digital Services Act). Ad targeting and creative details are primarily available for EU users and advertisers. Non-EU data may be less complete.

#### Technical

**What if the search returns no results?**

Empty results are normal. Not all advertisers have public ad information; some only target outside the EU, or have no active campaigns. The actor logs a warning and moves to the next advertiser.

**How does pagination work?**

The API returns up to 40 ads per page by default (configurable up to 200). If an advertiser has more ads than `maxAds`, the scraper automatically fetches subsequent pages using pagination tokens. Each page adds to runtime but not to cost (one payment per ad retrieved).

**Why did a run return fewer ads than expected?**

Reasons include:

- The advertiser has no public ads in that region/date range.
- Format filter excluded some ads.
- Budget limit was reached (charge ceiling).
- The API encountered a rate limit or block (logged as warning).

**What if I get a 429 (rate limit) error?**

The actor retries with exponential backoff (5 seconds, then 15 seconds). If it persists, the actor logs a warning and continues with other advertisers. If needed, spread large batches across multiple runs or request higher rate limits from Apify support.

#### Billing and optimization

**How many ads can I fetch per month?**

On a $10 monthly budget at $0.001/ad, you can fetch 10,000 ads. On a $100 budget, 100,000 ads. The actor respects your `maxTotalChargeUsd` setting and stops when the limit is reached.

**How do I reduce costs?**

- Lower `maxAds` (default 40 is already efficient).
- Disable `includeDetails` (fetches extra data per ad).
- Focus on fewer advertisers or a tighter date range.
- Use the free plan's monthly allowance (included in Apify's free tier).

**Can I parallelize scraping across multiple runs?**

Yes. Split your advertiser list across concurrent runs. Apify's free plan allows 5 concurrent runs; paid plans allow more. Each run operates independently and charges per ad retrieved.

#### Comparisons

**How does this compare to the leadership actors (scrapesage, solidcode, silva95gustavo)?**

- **Field coverage**: All competitors cover the same fields from adstransparency.google.com, but this actor is newer and may lag on edge cases (e.g., carousel video ads).
- **Pricing**: This actor at $0.001/ad matches the market median; some competitors charge $0.0015–0.002. Volume discounts help close the gap.
- **Reliability**: Verified from Apify datacenter IPs on 2026-09-28. Field-fill rates average 90% for top fields (creativeId, domain, format). No phantom rows or duplicate filtering needed.
- **Support**: Integrated with AI agents via MCP; leadership actors may not support agent-driven discovery.

#### Data integrations

**Can I push results to \[n8n / Make / Zapier]?**

Yes. Export the dataset to CSV/JSON and import via:

- **n8n**: HTTP Request node → parse JSON.
- **Make**: Use the Apify trigger to fetch dataset and pass to downstream modules.
- **Zapier**: Not directly supported (Apify is not a native Zapier app), but CSV export to Google Sheets via Zapier works.

### Related Actors

Part of the **webdatatools** web-intelligence suite — every Actor is pay-per-event, reads public data
without a login, and returns one clean row per entity:

Browse the whole suite at [webdatatools](https://paulet4a-commits.github.io/webdatatools/), or call ten of
these Actors straight from Claude, Cursor or Cline with the
[webdatatools MCP server](https://github.com/paulet4a-commits/webdatatools-mcp-server).

**Website & domain intelligence**

- [Email Extractor — Website Contact & Social Finder](https://apify.com/webdatatools/contact-extractor) — e-mails, phones and social profiles per domain
- [Tech Stack Detector — Wappalyzer & BuiltWith Alternative](https://apify.com/webdatatools/tech-stack-detector) — CMS, e-commerce, analytics, pixels and payments per domain
- [Domain DNS & Email Security Checker](https://apify.com/webdatatools/dns-email-security-checker) — SPF, DKIM, DMARC, MX provider, registrar and domain age
- [Domain Security Audit (TLS, HTTP headers, redirects, robots)](https://apify.com/webdatatools/domain-security-audit) — TLS expiry, security headers, redirect chain, robots and llms.txt
- [Subdomain Finder (Certificate Transparency)](https://apify.com/webdatatools/subdomain-finder) — every subdomain seen in CT logs, with a live DNS check
- [Bulk Core Web Vitals & PageSpeed Audit](https://apify.com/webdatatools/core-web-vitals-audit) — Lighthouse scores, LCP, CLS, INP and top fixes per URL
- [On-Page SEO Audit](https://apify.com/webdatatools/seo-page-audit) — title, meta, headings, links, images and schema issues per page
- [Sitemap URL Extractor & Change Monitor](https://apify.com/webdatatools/sitemap-extractor) — every sitemap URL, or new and removed pages between runs
- [Wayback Machine Snapshot & Page Change Tracker](https://apify.com/webdatatools/wayback-page-diff) — how a page changed over time, or every archived snapshot
- [Bulk Domain WHOIS & RDAP Lookup](https://apify.com/webdatatools/domain-whois-rdap) — registrar, dates, status and nameservers per domain
- [Web Scraper — CSS Selector & Data Extractor](https://apify.com/webdatatools/css-selector-extractor) — pull any CSS selector off any page, one row per URL
- [Website Screenshot Generator](https://apify.com/webdatatools/website-screenshot) — full-page or viewport PNG/JPEG screenshots of any URL

**Content for AI, LLMs and RAG**

- [AI Web Search & Read: Google results as clean Markdown](https://apify.com/webdatatools/ai-web-search) — a query turned into clean Markdown from the top search results
- [Website to Markdown — Content Crawler for LLM & RAG](https://apify.com/webdatatools/website-to-markdown) — any site as clean Markdown per page, no browser
- [Article & News Extractor (clean text, author, date, markdown)](https://apify.com/webdatatools/article-extractor) — clean article text, author, date and Markdown per URL
- [Structured Data & JSON-LD Extractor (Schema.org, Open Graph)](https://apify.com/webdatatools/structured-data-extractor) — Schema.org and Open Graph data from any page
- [Google News Scraper (RSS search by keyword, topic, site)](https://apify.com/webdatatools/google-news-scraper) — news results by keyword, topic or site
- [Press Release Monitor: PR Newswire, BusinessWire, GlobeNewswire](https://apify.com/webdatatools/press-release-monitor) — PR Newswire, Business Wire and GlobeNewswire releases

**Search, video and social**

- [YouTube Shorts Scraper](https://apify.com/webdatatools/youtube-shorts-scraper) — Shorts from channels, hashtags and searches with view counts
- [Pinterest Pins Scraper](https://apify.com/webdatatools/pinterest-pins-scraper) — latest pins of public Pinterest profiles and boards
- [YouTube Transcript Scraper](https://apify.com/webdatatools/youtube-transcript-scraper) — captions and subtitles as text + timed segments, per video or channel
- [Google Search Results Scraper — SERP API](https://apify.com/webdatatools/google-search-scraper) — organic SERP results per keyword and country
- [YouTube Comments Scraper — Comments & Replies](https://apify.com/webdatatools/youtube-comments-scraper) — comments and replies with likes, no API key
- [YouTube Channel Latest Videos (RSS, no API key)](https://apify.com/webdatatools/youtube-channel-videos) — the latest 15 videos of any channel from RSS
- [YouTube Channel Scraper (videos, shorts, live)](https://apify.com/webdatatools/youtube-channel-scraper) — a channel's full video, shorts and stream list
- [YouTube Search Results Scraper (videos, channels, no API key)](https://apify.com/webdatatools/youtube-search-scraper) — videos, channels and playlists per query
- [YouTube Video Details Scraper (views, likes, description, tags)](https://apify.com/webdatatools/youtube-video-details) — views, likes, description, tags and chapters per video
- [Apple Podcasts Lookup & Episodes Scraper](https://apify.com/webdatatools/podcast-lookup) — podcast metadata and episodes from iTunes and RSS
- [Bluesky Post, Search & Profile Scraper](https://apify.com/webdatatools/bluesky-scraper) — posts, profiles, followers and threads from the AT Protocol API
- [Telegram Channel Posts Scraper](https://apify.com/webdatatools/telegram-channel-scraper) — posts, views and media flags from any public channel
- [Substack Publication & Posts Scraper](https://apify.com/webdatatools/substack-scraper) — archive, authors and paywall status per publication
- [Google Play Reviews Scraper](https://apify.com/webdatatools/google-play-reviews-scraper) — reviews, ratings, replies and app versions per app
- [App Store Reviews Scraper](https://apify.com/webdatatools/app-store-reviews-scraper) — iOS reviews and ratings per app and country
- [Google Trends Scraper](https://apify.com/webdatatools/google-trends-scraper) — interest over time, by region, and related queries per keyword
- [Keyword Suggestions Scraper (Google, YouTube, Amazon, Bing)](https://apify.com/webdatatools/keyword-suggestions-scraper) — autocomplete keyword ideas from four search engines
- [Bilibili Scraper (Videos, Search, Popular)](https://apify.com/webdatatools/bilibili-scraper) — Chinese video platform: views, likes, coins, danmaku, uploader
- [Mastodon Scraper (Hashtags, Accounts, Trending)](https://apify.com/webdatatools/mastodon-scraper) — public fediverse posts by hashtag, account or trending
- [Meetup Events Scraper (Search by Keyword & City)](https://apify.com/webdatatools/meetup-events-scraper) — upcoming events with RSVPs, fees, venues and groups
- [Eventbrite Scraper (Events by Keyword & City)](https://apify.com/webdatatools/eventbrite-scraper) — events by keyword and city with venue, dates and organizer

**Leads, jobs and company data**

- [Career Site Jobs API (Greenhouse, Lever, Ashby, Workday +1)](https://apify.com/webdatatools/career-site-jobs-api) — company domains in, their open jobs out, ATS detected automatically
- [Workday Jobs Scraper](https://apify.com/webdatatools/workday-jobs-scraper) — jobs with full descriptions from any Workday career site
- [Google Maps Scraper](https://apify.com/webdatatools/google-maps-scraper) — businesses with phone, website, address, rating and coordinates per search
- [LinkedIn Jobs Scraper](https://apify.com/webdatatools/linkedin-jobs-scraper) — job titles, companies, locations and full descriptions from LinkedIn job search
- [Company 360: full company profile from a domain](https://apify.com/webdatatools/company-360) — one row per domain: contacts, tech, security, hiring and company facts
- [Hiring Signals Scraper (Greenhouse, Lever, Ashby, Workable)](https://apify.com/webdatatools/hiring-signals) — open jobs and hiring velocity from 10 public ATS boards
- [Y Combinator Companies & Founders Scraper](https://apify.com/webdatatools/yc-companies-scraper) — YC startups by batch, industry and hiring status
- [Wikidata Entity & Company Enrichment (facts, IDs, links)](https://apify.com/webdatatools/wikidata-entity-enrichment) — HQ, founders, employees, revenue and social IDs per company
- [Email Validator & Verifier — Bulk Email Check](https://apify.com/webdatatools/email-validator) — syntax, MX, disposable, role and free-provider checks
- [OpenStreetMap POI Extractor (Overpass API: shops, amenities)](https://apify.com/webdatatools/overpass-poi-extractor) — shops and amenities by radius, bbox or area
- [Stock, Crypto & FX Quotes](https://apify.com/webdatatools/market-quotes) — one row per symbol from Yahoo, Binance and ECB rates
- [Remote Jobs Aggregator (RemoteOK, WWR, Hacker News)](https://apify.com/webdatatools/remote-jobs-aggregator) — one clean row per remote job, de-duplicated across feeds
- [Greenhouse Jobs Scraper](https://apify.com/webdatatools/greenhouse-jobs-scraper) — jobs with descriptions from any Greenhouse job board
- [Lever Jobs Scraper](https://apify.com/webdatatools/lever-jobs-scraper) — jobs with descriptions from any Lever careers page
- [Ashby Jobs Scraper](https://apify.com/webdatatools/ashby-jobs-scraper) — jobs, salaries and descriptions from any Ashby job board
- [SmartRecruiters Jobs Scraper](https://apify.com/webdatatools/smartrecruiters-jobs-scraper) — jobs with descriptions from any SmartRecruiters company
- [Seek Jobs Scraper (Australia & New Zealand)](https://apify.com/webdatatools/seek-jobs-scraper) — Seek job ads with salary, work type and location
- [Dice Jobs Scraper](https://apify.com/webdatatools/dice-jobs-scraper) — US tech jobs from Dice with salary and remote flag
- [AutoScout24 Scraper](https://apify.com/webdatatools/autoscout24-scraper) — European car listings with price, mileage and seller
- [Rightmove Scraper](https://apify.com/webdatatools/rightmove-scraper) — UK property for sale or rent with price and agent
- [Wellfound Jobs Scraper (AngelList Startup Jobs)](https://apify.com/webdatatools/wellfound-jobs-scraper) — startup jobs with salary and equity ranges, company size and stage
- [Yandex Maps Scraper (Places, Ratings, Phones)](https://apify.com/webdatatools/yandex-maps-scraper) — businesses in Russia, Türkiye and the CIS with phones, ratings, hours
- [Craigslist Scraper (Listings, Prices, Locations)](https://apify.com/webdatatools/craigslist-scraper) — listings in any area and category with price, date and coordinates
- [JobStreet Scraper (Malaysia, Singapore, PH, ID + JobsDB)](https://apify.com/webdatatools/jobstreet-scraper) — JobStreet and JobsDB jobs in 6 Asian countries with parsed salaries
- [InfoJobs Scraper (Spain Jobs, Salaries, Companies)](https://apify.com/webdatatools/infojobs-scraper) — Spanish jobs with salary range, contract type and full description
- [Redfin Scraper (Homes for Sale, Prices, Details)](https://apify.com/webdatatools/redfin-scraper) — US homes for sale or sold from any Redfin search, with price and details
- [Kleinanzeigen Scraper (Ads, Prices, Locations)](https://apify.com/webdatatools/kleinanzeigen-scraper) — German classifieds with price, VB flag, ZIP, city and seller type

**Developer, app and research data**

- [npm, PyPI & Crates.io Package Health Checker](https://apify.com/webdatatools/package-health-checker) — releases, downloads, deprecation and a health score
- [GitHub Repository Health & Activity Report](https://apify.com/webdatatools/github-repo-health) — stars, commits, contributors and risk flags per repo
- [VS Code Marketplace Extension Scraper (installs, ratings)](https://apify.com/webdatatools/vscode-marketplace-extensions) — installs, ratings and versions per extension
- [Chrome Web Store Extension Scraper (installs, ratings)](https://apify.com/webdatatools/chrome-web-store-extensions) — users, rating, version and developer per extension
- [Google Play Scraper](https://apify.com/webdatatools/google-play-scraper) — apps, ratings, installs, developer contact and reviews
- [App Store (iOS) App Metadata, Ratings & Top Charts Lookup](https://apify.com/webdatatools/app-store-lookup) — ratings, price, version and charts per app
- [CrossRef DOI & Citation Metadata Lookup](https://apify.com/webdatatools/crossref-doi-lookup) — papers, authors, journals and citation counts
- [FDA Recalls & Adverse Events Monitor (openFDA)](https://apify.com/webdatatools/openfda-recall-monitor) — food, drug and device recalls from openFDA
- [iCal / ICS Calendar Feed to Events Extractor](https://apify.com/webdatatools/ical-calendar-extractor) — any public calendar feed as event rows
- [Shopify Store Products Scraper](https://apify.com/webdatatools/shopify-products-scraper) — catalog, prices, variants and stock per store
- [Hacker News Search & Front Page Scraper](https://apify.com/webdatatools/hacker-news-scraper) — stories, comments and points by query or front page
- [GitHub Trending Repositories Scraper](https://apify.com/webdatatools/github-trending-scraper) — trending repos and developers by language and period
- [Stack Overflow & Stack Exchange Q\&A Scraper](https://apify.com/webdatatools/stackexchange-scraper) — questions, answers and scores by query, tag or site
- [Bulk Image Downloader](https://apify.com/webdatatools/bulk-image-downloader) — download image URLs to storage with size, dimensions and a ZIP
- [Google Flights Scraper (Prices, Airlines, Stops)](https://apify.com/webdatatools/google-flights-scraper) — flight prices, airlines, times, stops and CO2 by route and date
- [Google Hotels Scraper (Prices, Ratings, Reviews)](https://apify.com/webdatatools/google-hotels-scraper) — hotel prices per night, stars, rating and reviews by city and dates
- [AliExpress Scraper (Search Products & Prices)](https://apify.com/webdatatools/aliexpress-scraper) — AliExpress search results with USD price, discount and rank
- [Lazada Scraper (Products, Prices, Sold, Ratings)](https://apify.com/webdatatools/lazada-scraper) — Lazada products in 6 countries with price, rating, units sold and seller

### Support

For issues, feature requests, or technical questions:

1. Check the run log for error details (linked in the Actor console).
2. Verify your input against the schema (invalid fields are rejected).
3. Test with a small `maxAds` value to confirm connectivity.
4. Open an issue on the [Apify Platform](https://apify.com) or contact support@apify.com.

***

**Last updated**: 2026-09-28 | **Version**: 0.0 | **Status**: Production-ready

# Actor input Schema

## `advertisers` (type: `string`):

Enter advertiser domains (e.g., nike.com), advertiser IDs (e.g., AR123456789), or advertiser names (e.g., Nike), separated by semicolons. Example: "nike.com; shopify.com"

## `domain` (type: `string`):

Alias for 'advertisers'. Enter a single domain (e.g., nike.com). Use 'advertisers' for multiple values.

## `advertiser` (type: `string`):

Alias for 'advertisers'. Enter a single advertiser domain, ID, or name.

## `region` (type: `string`):

Enter a region code (e.g., US, GB, DE) to filter ads by region. Leave empty to include all regions.

## `dateFrom` (type: `string`):

Optional start date for ad range (ISO 8601 format, e.g., 2024-01-01). Leave empty for no filter.

## `dateTo` (type: `string`):

Optional end date for ad range (ISO 8601 format, e.g., 2024-12-31). Leave empty for no filter.

## `format` (type: `string`):

Filter by ad format: all, text, image, or video.

## `maxAds` (type: `integer`):

Maximum number of ads to retrieve per advertiser (default 40, max 100). API limit is 100 results per query.

## Actor input object example

```json
{
  "advertisers": "nike.com",
  "region": "US",
  "format": "all",
  "maxAds": 40
}
```

# Actor output Schema

## `results` (type: `string`):

All ads from this run.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "advertisers": "nike.com",
    "region": "US",
    "format": "all",
    "maxAds": 40
};

// Run the Actor and wait for it to finish
const run = await client.actor("webdatatools/google-ads-transparency-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "advertisers": "nike.com",
    "region": "US",
    "format": "all",
    "maxAds": 40,
}

# Run the Actor and wait for it to finish
run = client.actor("webdatatools/google-ads-transparency-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "advertisers": "nike.com",
  "region": "US",
  "format": "all",
  "maxAds": 40
}' |
apify call webdatatools/google-ads-transparency-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,webdatatools/google-ads-transparency-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/YsN83avk4MH8cT94a/builds/ovJuxiQ0Zb2zp9T5H/openapi.json