# Google Ads Transparency Scraper (`aboo.script/adstransparency-google-scraper`) Actor

\[💰$2 / 1K] ⚡ Fast Google Ads Transparency Center scraper. No login, no API key. Get ads by domain, advertiser name/ID or ad URL with region, platform, format and date filters: advertiser, country, format, image, first/last shown dates, YouTube link and per-country impressions.

- **URL**: https://apify.com/aboo.script/adstransparency-google-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 1,000 results

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

![Google Ads Transparency Scraper](https://i.ibb.co/cKGdJmkz/adstransparency-google-banner.png)

**Google Ads Transparency Scraper** extracts ads from the [Google Ads Transparency Center](https://adstransparency.google.com/) into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste a domain or advertiser page, or type a domain or advertiser name, and get the advertiser, verified country, ad format, ad image, first and last shown dates, and (optionally) every country the ad ran in with impressions and platforms. No account or login required.

### Introduction

The [Google Ads Transparency Center](https://adstransparency.google.com/) is Google's public library of ads shown on Google Search, YouTube, Google Play, Google Maps, Google Shopping, and partner websites. It lists every verified advertiser and the ads they run, so it is one of the best sources to see what competitors advertise, where, and for how long.

This actor collects the same public information you see in your browser and turns it into a ready-to-use dataset. You can run it once, schedule it to run daily, or connect it to your own tools.

### What data can you extract from Google Ads Transparency Center?

- 🔗 Direct link to every ad and its advertiser page
- 🏢 Advertiser name, ID, country, and verification status
- 🧩 Ad format (text, image, or video) and the domain the ad points to
- 📅 First shown date, last shown date, and number of days shown
- 🖼️ Ad image with width and height, or the ad preview link
- 🎬 YouTube link of video ads (with ad details)
- 🌍 Countries where the ad ran, with first and last shown dates per country (with ad details)
- 📊 Impression ranges per country and per platform for ads shown in the EU (with ad details)
- 🗂️ All variations of each ad (with ad details)

### Use Cases

- 🕵️ **Competitor monitoring**: see every ad a competitor runs, which formats they use, and how long each ad stays live.
- 📈 **Market research**: compare the advertising activity of brands across countries and platforms.
- 🎨 **Creative inspiration**: collect ad images and videos from top advertisers in your niche.
- 🤝 **Lead generation**: find businesses that actively advertise on Google, with their country and website.
- 🛡️ **Brand protection**: spot advertisers that point ads to your domain.
- 🤖 **AI and automation**: feed clean, structured ad data into spreadsheets, dashboards, or AI workflows.

### How to scrape Google Ads Transparency Center step by step

1. Paste one or more Google Ads Transparency Center URLs into **Start URLs**, or type domains or advertiser names into **Search queries**.
2. Optionally choose a **Region**, **Platform**, **Ad format**, or date range for your search queries, and turn on **Include ad details** for countries, impressions, and video links.
3. Set **Maximum number of results** to how many ads you want per URL or per query.
4. Click **Start**, wait for the run to finish, and download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: Google Ads Transparency Center URLs to scrape. Supported pages: domain searches (`https://adstransparency.google.com/?region=US&domain=nike.com`), advertiser pages (`https://adstransparency.google.com/advertiser/AR16735076323512287233`), and single ads (`https://adstransparency.google.com/advertiser/AR.../creative/CR...`). The region, platform, format, and date filters you set on the website are kept in the results.
- **Search queries**: domains (`nike.com`), advertiser IDs (`AR16735076323512287233`), or advertiser names (`Nike`), one per line. Each query is scraped separately. An advertiser name is matched to the advertiser with that name and the most ads.
- **Region**: only ads shown in this country. Applies to search queries.
- **Platform**: only ads shown on Google Search, YouTube, Google Play, Google Maps, or Google Shopping. Applies to search queries.
- **Ad format**: only text, image, or video ads. Applies to search queries.
- **Shown from** and **Shown until**: only ads shown within this date range. Applies to search queries.
- **Include ad details**: also open every ad to add all its variations, the countries it ran in, impressions and platforms for EU countries, and the YouTube link of video ads. Runs take longer with this option.
- **Maximum number of results**: how many ads to collect for each start URL or search query. Use 0 for no limit.
- **Proxy configuration**: Google limits how many requests one address can make, so a proxy is required. The default Apify datacenter proxy works well.

You can use start URLs, search queries, or both in the same run.

### Input Examples

Scrape all ads that point to a domain, as shown on the website:

```json
{
  "startUrls": [{ "url": "https://adstransparency.google.com/?region=US&domain=nike.com" }],
  "maxResults": 5,
  "proxyConfiguration": { "useApifyProxy": true }
}
```

Search by domain with the default filters:

```json
{
  "searchQueries": ["adidas.com"],
  "region": "anywhere",
  "platform": "ALL",
  "format": "ALL",
  "includeDetails": false,
  "maxResults": 5,
  "proxyConfiguration": { "useApifyProxy": true }
}
```

Get YouTube video ads of an advertiser in the United States, with countries and video links:

```json
{
  "searchQueries": ["Nike"],
  "region": "US",
  "platform": "YOUTUBE",
  "format": "VIDEO",
  "includeDetails": true,
  "maxResults": 5,
  "proxyConfiguration": { "useApifyProxy": true }
}
```

### Output

Each ad is saved as one item in the dataset. Here is an example of a single item with ad details (lists shortened):

```json
{
  "url": "https://adstransparency.google.com/advertiser/AR18378488041124659201/creative/CR12654325761260388353?region=DE",
  "creativeId": "CR12654325761260388353",
  "advertiserId": "AR18378488041124659201",
  "advertiserName": "Nike Retail BV",
  "advertiserUrl": "https://adstransparency.google.com/advertiser/AR18378488041124659201",
  "advertiserCountry": "NL",
  "advertiserVerified": true,
  "format": "Text",
  "domain": "nike.com",
  "firstShown": "2025-10-22T15:06:48.000Z",
  "lastShown": "2026-10-27T02:58:14.000Z",
  "daysShown": 366,
  "imageUrl": "https://tpc.googlesyndication.com/archive/simgad/16424033980626892649",
  "imageWidth": 381,
  "imageHeight": 168,
  "previewUrl": null,
  "videoUrl": null,
  "regions": [
    {
      "countryCode": "DE",
      "countryName": "Germany",
      "firstShown": "2025-10-22T00:00:00Z",
      "lastShown": "2026-10-26T00:00:00Z",
      "impressionsMin": 80000,
      "impressionsMax": 90000,
      "platforms": [
        { "platform": "Google Shopping", "impressionsMin": 0, "impressionsMax": 1000 },
        { "platform": "Google Search", "impressionsMin": 80000, "impressionsMax": 90000 }
      ]
    }
  ],
  "variations": [
    {
      "imageUrl": "https://tpc.googlesyndication.com/archive/simgad/16424033980626892649",
      "imageWidth": 381,
      "imageHeight": 168,
      "previewUrl": null
    }
  ]
}
```

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- A proxy is required: Google limits how many requests one address can make. Keep the default Apify proxy turned on.
- Only domain searches, advertiser pages, and single ad pages are supported. The home page and political ads pages are skipped.
- `regions`, `variations`, and `videoUrl` are filled only when **Include ad details** is on. Google publishes impressions and platforms per country only for ads shown in the EU.
- Google publishes most text ads as images, so a text ad is returned as an image (`imageUrl`) instead of text. Some ads only have an interactive preview, returned as `previewUrl`.
- `domain` is filled for domain searches. For advertiser pages, advertiser names, and single ads it is `null`.
- Google keeps a limited history for the date filter, so very old date ranges may return no ads.
- Large domains can have tens of thousands of ads. Use filters or a result limit to keep runs short.

### Why use the Google Ads Transparency Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🎯 **Keeps your filters**: paste any domain or advertiser URL from your browser and get exactly what you see there.
- 🌍 **Country-level detail**: optional per-country dates, impressions, and platforms for each ad.
- 🧹 **Clean data**: dates use one standard format, numbers are real numbers, and every ad has a direct link.
- 💸 **Pay for what you need**: set a result limit per URL or query and keep every run small and cheap.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going until it reaches your limit or runs out of ads.

#### Do I need a Google account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### Can I search by advertiser name?

Yes. Type the name in **Search queries**. The actor picks the advertiser with that name and the most ads. For an exact advertiser, paste its advertiser page URL or ID instead.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and track new ads from your competitors.

#### Can I request a new feature or filter?

Yes. Right now the actor supports domains, advertisers, single ads, and region, platform, format, and date filters. If you need other inputs, such as political ads, get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [Google Ads Transparency Center](https://adstransparency.google.com/)

# Actor input Schema

## `startUrls` (type: `array`):

Google Ads Transparency Center URLs: a domain search (https://adstransparency.google.com/?region=US\&domain=nike.com), an advertiser page (https://adstransparency.google.com/advertiser/AR...) or a single ad (https://adstransparency.google.com/advertiser/AR.../creative/CR...). Region, platform, format and date filters in the URL are applied.

## `searchQueries` (type: `array`):

Domains (nike.com), advertiser IDs (AR16735076323512287233) or advertiser names (Nike). An advertiser name is matched to the advertiser with the most ads. Each query is scraped separately.

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

Only ads shown in this country. Applies to search queries; start URLs use their own region parameter.

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

Only ads shown on this Google platform. Applies to search queries only.

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

Only ads of this format. Applies to search queries only.

## `startDate` (type: `string`):

Only ads shown on or after this date (YYYY-MM-DD). Applies to search queries only.

## `endDate` (type: `string`):

Only ads shown on or before this date (YYYY-MM-DD). Applies to search queries only.

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

Also open every ad to add all its variations, the countries it was shown in with first and last shown dates, impressions and platforms (EU countries), and the YouTube link of video ads. Slower: one extra request per ad.

## `maxResults` (type: `integer`):

Maximum number of ads to scrape per start URL or search query. Use 0 for no limit.

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

The site limits requests per IP address, so a proxy is required. Datacenter proxies work well.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://adstransparency.google.com/?region=US&domain=nike.com"
    }
  ],
  "searchQueries": [
    "adidas.com"
  ],
  "region": "anywhere",
  "platform": "ALL",
  "format": "ALL",
  "includeDetails": false,
  "maxResults": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (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 = {
    "startUrls": [
        {
            "url": "https://adstransparency.google.com/?region=US&domain=nike.com"
        }
    ],
    "searchQueries": [
        "adidas.com"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/adstransparency-google-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 = {
    "startUrls": [{ "url": "https://adstransparency.google.com/?region=US&domain=nike.com" }],
    "searchQueries": ["adidas.com"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/adstransparency-google-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 '{
  "startUrls": [
    {
      "url": "https://adstransparency.google.com/?region=US&domain=nike.com"
    }
  ],
  "searchQueries": [
    "adidas.com"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call aboo.script/adstransparency-google-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/adstransparency-google-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/b3RbJEIdnW2jAza7W/builds/4Cajrp5Xw27TPE1Ug/openapi.json