# Google Ads Transparency Scraper & Competitor Ad Monitor (`stumadethat/google-ads-transparency-monitor`) Actor

Scrape the Google Ads Transparency Center for every ad of any competitor (Search, YouTube, Shopping, Maps, Play): ad text, images, YouTube videos, first/last shown, days running, impressions per country. No login. Monitoring mode returns only new ads. HTML report included.

- **URL**: https://apify.com/stumadethat/google-ads-transparency-monitor.md
- **Developed by:** [louis stuart](https://apify.com/stumadethat) (community)
- **Categories:** Marketing, SEO tools, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 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.

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 & Competitor Ad Monitor

See **every Google ad your competitors run**: on Search, YouTube, Shopping, Maps and Play, in any country. The data comes from the official [Google Ads Transparency Center](https://adstransparency.google.com). Get the data as JSON, CSV or Excel, or as a ready-to-share **HTML report**.

**Monitoring mode** returns only the ads launched since your last run. Schedule it daily or weekly to be told when a competitor starts a new campaign.

### What you get for each ad

| Field | Example |
|---|---|
| Advertiser name, ID and website | Decathlon France SASU · `AR1566…` · decathlon.fr |
| Format | TEXT / IMAGE / VIDEO |
| First shown, last shown, **days running** | 2023-08-24 → 2026-11-17 · 1,181 days |
| Still active? | `true` |
| Ad image | `https://tpc.googlesyndication.com/…` |
| Link to the ad on Google | `https://adstransparency.google.com/advertiser/…/creative/…` |
| **With details:** ad copy (headlines, descriptions) | "Tout pour le sport à prix accessible !" |
| **With details:** YouTube video | `https://www.youtube.com/watch?v=…` |
| **With details:** impressions range, overall and **per country and per platform** | FR: 150k–175k · Search 125k–150k · Maps 1k–2k |
| **With details:** first/last shown per country, every creative variation | |

Each advertiser also gets a **summary**: ads collected, active ads, new ads in the last 7 and 30 days, formats, longest-running ad and top countries. The summary is saved as `SUMMARY` (JSON) and as a `REPORT` (HTML) page you can send to a client.

### Use cases

- **Competitor research:** what ads do your competitors run, in which countries, and since when?
- **Find the winning ads:** ads that run for months are the ones that convert. Sort by `daysRunning`.
- **Get alerts on new campaigns:** schedule monitoring mode and receive only new creatives by email, Slack, Make, Zapier or n8n.
- **Agency pitches and client reporting:** one HTML report per brand, ready to send.
- **Creative inspiration:** collect the text and video ads of a whole category.
- **Market research:** which brands advertise in a country, and on which Google platforms.

### How to use it

1. Enter one or more **competitor websites** (e.g. `nike.com`) and/or **advertiser names** (e.g. `Nike`). You can also paste advertiser IDs or Transparency Center URLs.
2. Optional filters: country, platform (Search, YouTube…), format, *shown in the last N days*, *launched in the last N days*.
3. Turn on **Include details** to get the ad copy, impressions, countries and YouTube links.
4. Run it. Ads appear in the dataset, and `SUMMARY` and `REPORT` appear in the key-value store.

#### Example input

```json
{
  "domains": ["nike.com", "adidas.com"],
  "region": "FR",
  "platform": "YOUTUBE",
  "lastSeenWithinDays": 30,
  "maxAdsPerTarget": 200,
  "includeDetails": true
}
```

#### Monitoring: get only new ads

```json
{
  "domains": ["competitor.com"],
  "region": "US",
  "onlyNewAds": true
}
```

Create a **Schedule** (Apify Console → Schedules) to run it every morning:

- The first run stores a baseline.
- Each later run returns only creatives it has never seen.
- Connect an integration (email, Slack, Google Sheets, webhook) to receive them.

### Pricing (pay per result)

| Event | Price |
|---|---|
| Ad (basic fields) | **$1.20 per 1,000 ads** |
| Ad details (copy, impressions, countries, platforms, video) | +$2.50 per 1,000 ads |
| Advertiser summary + HTML report | $0.01 per advertiser |

You only pay for what you get. Example: the latest 100 ads of 5 competitors, without details, cost **$0.65** (summaries included). With details, they cost **$1.90**. Set a maximum cost per run in the Console, and the Actor stops cleanly when it reaches it.

### Tips

- **Domain or name?** Searching by **domain** is the most complete: it finds every advertiser account that sends ads to the site. Searching by **name** with *Contains* matches the brand's accounts in every country.
- Big brands have tens of thousands of ads. Use `maxAdsPerTarget`, `lastSeenWithinDays` or a country to keep it focused. Results come newest first.
- **Impressions** are ranges published by Google (e.g. 10,000–15,000). Google publishes them only for some regions (notably the EU), so they can be empty for ads shown only outside those regions.
- **Proxies:** Google rate-limits heavy traffic. The default Apify Proxy rotates IPs automatically. If a run reports rate limits, switch the proxy group to **Residential**.

### Integrations and API

Use the Apify API, the Python and JavaScript clients, Make, Zapier, n8n or Google Sheets, or call the Actor from **AI agents through the Apify MCP server**. All fields are flat JSON, which makes them easy to put into a spreadsheet or a database.

Ready-to-run code examples (Python, Node.js, cURL, and a daily cross-platform competitor monitor that writes one CSV): [github.com/louisstuart06-cmd/ad-library-scrapers](https://github.com/louisstuart06-cmd/ad-library-scrapers).

### Ad Monitor suite: same author, same output format

| Actor | What it monitors |
|---|---|
| [Google Ads Transparency Scraper & Competitor Ad Monitor](https://apify.com/stumadethat/google-ads-transparency-monitor) | Google Search, YouTube, Shopping, Maps and Play ads of any advertiser, in any country |
| [TikTok Ads Library Scraper & Competitor Ad Monitor](https://apify.com/stumadethat/tiktok-ads-library-monitor) | TikTok ads shown in Europe, with targeting, payer and landing pages |
| [Facebook Ads Library Scraper — Meta & Instagram Ad Monitor](https://apify.com/stumadethat/meta-ads-library-monitor) | Facebook and Instagram ads of any brand, in any country |

The Actors share the same features (monitoring mode, advertiser summary, HTML report, `daysRunning`), so you can follow a competitor across Google, TikTok, Facebook and Instagram in one workflow.

### FAQ

**Is it legal?** The Actor only reads ads that Google publishes in its public Ads Transparency Center, without logging in. It collects no personal data. You are responsible for how you use the data. Check Google's terms and your local laws.

**Why are some ads missing their text?** Image ads carry their copy inside the image (see `imageUrl`). For text and video ads, the copy is read from Google's preview on a best-effort basis.

**How fresh is the data?** It is live. Every run queries Google at that moment.

**Is there an official Google Ads Transparency API?** Google offers no simple official API to search the Ads Transparency Center by advertiser or domain. This Actor reads the public site, with no account or API key.

**How do I follow one exact advertiser?** Enter the advertiser's website domain (for example `decathlon.fr`) or its advertiser ID (`AR…`, visible in the Transparency Center URL).

**How much does daily monitoring cost?** With monitoring mode you pay only for new ads plus $0.01 per advertiser, usually well under $1 per month per competitor. Proxy and compute costs are included in the price.

**I need another field or source.** Open an issue on the Actor's page. Fixes and requests are answered quickly.

# Actor input Schema

## `domains` (type: `array`):

Websites whose ads you want, e.g. nike.com, decathlon.fr. Google matches every advertiser account that points ads to this domain.

## `advertisers` (type: `array`):

Advertiser names (e.g. 'Nike'), advertiser IDs (AR…) or advertiser URLs copied from adstransparency.google.com.

## `advertiserNameMatch` (type: `string`):

'contains': every advertiser account whose name contains your text (all countries). 'exact': only exact name matches. 'top': only Google's first suggestion.

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

ISO country code (FR, US, GB, DE, ES…) or 'anywhere'.

## `platform` (type: `string`):

Only ads shown on this Google surface.

## `adFormat` (type: `string`):

Only ads of this format.

## `maxAdsPerTarget` (type: `integer`):

Newest ads come first. Big brands can have 30,000+ ads.

## `lastSeenWithinDays` (type: `integer`):

0 = no limit. Example: 7 = ads still running this week.

## `firstSeenWithinDays` (type: `integer`):

0 = no limit. Example: 30 = creatives the competitor started this month.

## `includeDetails` (type: `boolean`):

Adds impression ranges per country and platform, first/last shown per country, ad copy text, YouTube video link and all creative variations. Charged as an extra event per ad.

## `extractAdText` (type: `boolean`):

Reads headlines and descriptions from Google's ad preview. Only used when details are on.

## `onlyNewAds` (type: `boolean`):

Schedule this Actor (daily/weekly) with this option on to get only the competitor's NEW ads. The first run stores a baseline.

## `monitorStoreName` (type: `string`):

Name of the key-value store that remembers ads already seen. Change it to reset the history.

## `includeAdvertiserSummary` (type: `boolean`):

Per advertiser: ads collected, active ads, new ads in 7/30 days, formats, longest-running ad, top countries. Saved as SUMMARY (JSON) and REPORT (HTML) in the key-value store.

## `maxConcurrency` (type: `integer`):

Parallel requests for details. Lower it if you see rate limits.

## `proxyConfiguration` (type: `object`):

Apify Proxy is recommended.

## Actor input object example

```json
{
  "domains": [
    "decathlon.fr"
  ],
  "advertiserNameMatch": "contains",
  "region": "anywhere",
  "platform": "ALL",
  "adFormat": "ALL",
  "maxAdsPerTarget": 100,
  "lastSeenWithinDays": 0,
  "firstSeenWithinDays": 0,
  "includeDetails": false,
  "extractAdText": true,
  "onlyNewAds": false,
  "monitorStoreName": "google-ads-monitor",
  "includeAdvertiserSummary": true,
  "maxConcurrency": 8,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `ads` (type: `string`):

No description

## `adsWithDetails` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `report` (type: `string`):

No description

# 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 = {
    "domains": [
        "decathlon.fr"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("stumadethat/google-ads-transparency-monitor").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 = {
    "domains": ["decathlon.fr"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("stumadethat/google-ads-transparency-monitor").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 '{
  "domains": [
    "decathlon.fr"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call stumadethat/google-ads-transparency-monitor --silent --output-dataset

```

## MCP server setup

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

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/g0zLLCUDOPcvSq2J0/builds/WYMDZMIetFudii8Xn/openapi.json
