# Google Ads Search by Domain (`burbn/google-ads-search`) Actor

Search Google Ads Transparency Center by domain. Extract advertiser details, ad creatives, images, videos, format types, start dates, and transparency URLs. Perfect for competitive analysis, ad research, and marketing intelligence.

- **URL**: https://apify.com/burbn/google-ads-search.md
- **Developed by:** [Kevin](https://apify.com/burbn) (community)
- **Categories:** Developer tools, Automation, Other
- **Features:** Limited permissions
- **Stats:** 140 total users, 11 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 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 Scraper - Search Ads by Domain | Google Ads Library API

Scrape Google Ads Transparency Center by domain name. Extract Google Ads data including advertiser details, ad creatives, display ads, text ads, video ads, image ads, ad format types, ad start dates, last seen dates, and Google Ads transparency URLs. The best Google Ads scraper for competitor ad analysis, Google Ads monitoring, ad intelligence, and marketing research.

### ❓ What is Google Ads Scraper?

**Google Ads Scraper** is a powerful Apify actor that lets you search and extract ads from the **Google Ads Transparency Center** (Google Ads Library) by domain. Whether you want to spy on competitor Google Ads campaigns, monitor brand advertisements, or collect ad creative data for research — this Google Ads scraper does it all automatically.

With this Google Ads search tool, you can:

- 🔍 **Search Google Ads by domain** — Enter any website domain to find all its Google Ads
- 🌍 **Filter Google Ads by country** — Target ads by specific country/region (US, UK, India, Germany, etc.)
- 🎨 **Filter ads by format** — Search for Image ads, Text ads, Video ads, or all ad formats
- 📊 **Extract comprehensive ad data** — Get advertiser name, creative ID, ad images, format type, dates, and more
- 📄 **Automatic pagination** — Scrape thousands of Google Ads automatically with pagination support

### 🎯 What Data Can You Extract from Google Ads?

This Google Ads scraper extracts the following data for each advertisement:

| Field | Description |
|-------|-------------|
| `advertiserId` | Unique Google Ads advertiser identifier |
| `advertiserName` | Name of the Google Ads advertiser |
| `creativeId` | Unique ad creative identifier |
| `originalUrl` | Direct link to Google Ads Transparency Center page |
| `variantContent` | Ad creative content (HTML or URL) |
| `imageUrl` | Direct image URL of the ad creative |
| `variantFormat` | Ad variant format — Image, Text/Other, Video |
| `variants` | Array of all ad creative variants |
| `variantCount` | Total number of ad variants |
| `startDate` | Date when the Google Ad started running |
| `lastSeen` | Date when the Google Ad was last seen active |
| `formatType` | Overall ad format type — Image, Text/Other, Video |

### 🚀 How to Use Google Ads Scraper

#### Step 1: Configure Your Search

Enter the domain name you want to search Google Ads for. For example: `google.com`, `amazon.com`, `nike.com`, `shopify.com`.

#### Step 2: Set Filters (Optional)

| Input | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| `domain` | String | ✅ Yes | `google.com` | Domain name to search for Google Ads |
| `countryCode` | String | ❌ No | `US` | Country code — US, GB, IN, DE, FR, CA, AU, etc. |
| `format` | String | ❌ No | `ALL` | Ad format filter — ALL, IMAGE, TEXT, VIDEO |
| `maxResults` | Integer | ❌ No | `100` | Maximum number of Google Ads to scrape (1–5000) |

#### Step 3: Run and Download Results

Click **Start** to run the Google Ads scraper. Results are available in JSON, CSV, Excel, XML, and RSS formats.

### 📋 Example Input

```json
{
  "domain": "google.com",
  "countryCode": "US",
  "format": "ALL",
  "maxResults": 100
}
```

### 📋 Example Output

```json
{
  "advertiserId": "AR14188379519798214657",
  "advertiserName": "Google LLC",
  "creativeId": "CR14844389921191362561",
  "originalUrl": "https://adstransparency.google.com/advertiser/AR14188379519798214657/creative/CR14844389921191362561?region=US",
  "variantContent": "<img src=\"https://tpc.googlesyndication.com/archive/simgad/2084202696746803113\" height=\"444\" width=\"348\">",
  "imageUrl": "https://tpc.googlesyndication.com/archive/simgad/2084202696746803113",
  "variantFormat": "Image",
  "variants": [
    {
      "content": "<img src=\"https://tpc.googlesyndication.com/archive/simgad/2084202696746803113\" height=\"444\" width=\"348\">",
      "image": "https://tpc.googlesyndication.com/archive/simgad/2084202696746803113",
      "format": "Image"
    }
  ],
  "variantCount": 1,
  "startDate": "2025-12-17",
  "lastSeen": "2026-03-31",
  "formatType": "Image"
}
```

### 🎨 Dataset Views

The Google Ads scraper provides 3 organized dataset views for easy analysis:

| View | Description |
|------|-------------|
| 📊 **Ads Overview** | Advertiser name, creative ID, format type, dates, transparency URL |
| 🎨 **Ad Creatives** | Ad images, format details, variant content, creative information |
| 👤 **Advertisers** | Advertiser IDs, names, ad formats, and activity dates |

### 💡 Use Cases for Google Ads Scraper

- **Competitor Google Ads Analysis** — Monitor competitor ad campaigns, discover their ad creatives, and understand their advertising strategy
- **Google Ads Research** — Study ad creatives, ad formats, and ad copy across industries and domains
- **Brand Monitoring** — Track all Google Ads associated with your brand's domain or competitor domains
- **Ad Intelligence & Marketing Research** — Understand Google Ads trends, advertising strategies, and creative patterns
- **Compliance & Transparency Monitoring** — Monitor ad transparency data and advertiser activity on Google Ads
- **Ad Creative Inspiration** — Browse thousands of Google Ads creatives for design and copywriting inspiration
- **Digital Marketing Audits** — Analyze Google Ads presence of any domain for client reports and marketing audits

### 🔧 Tips for Best Results

1. **Start with a specific domain** — Enter the exact domain (e.g., `nike.com`) for targeted Google Ads results
2. **Use country filter** — Filter by country code to get region-specific Google Ads data
3. **Filter by ad format** — Use IMAGE, TEXT, or VIDEO filter to get specific ad types
4. **Set reasonable limits** — Start with 100 results and increase maxResults as needed
5. **Export in your preferred format** — Download Google Ads data in JSON, CSV, or Excel

### 🏷️ Tags

`google ads` `google ads scraper` `google ads transparency` `google ads library` `google ads search` `google ads api` `google ads crawler` `google ads extractor` `ad scraper` `ad spy tool` `competitor ads` `ad intelligence` `ad research` `google ads monitor` `ad creative scraper` `display ads scraper` `text ads scraper` `video ads scraper` `google ads data` `ad transparency center` `google advertising` `ppc research` `sem research` `digital advertising` `ad campaign analysis` `marketing intelligence` `brand monitoring` `ad tracking` `google ads by domain`

### 🎁 Get $5 Free Apify Credits

New to Apify? [Sign up using this link](https://apify.com?fpr=free-credits) and get **$5 free credits** to start scraping Google Ads right away! No credit card required.

### 📞 Support

For questions, feedback, or issues with this Google Ads scraper, please contact us through Apify or open an issue.

***

**Happy scraping Google Ads! 📊✨**

# Actor input Schema

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

Enter the domain name to search for ads (e.g., google.com, amazon.com, nike.com).

## `countryCode` (type: `string`):

Two-letter country code to filter ads by region (e.g., US, GB, IN, DE). Leave empty for all regions.

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

Filter ads by format type.

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

Maximum total number of ad results to scrape. Higher limits will take longer but provide more comprehensive results.

## Actor input object example

```json
{
  "domain": "google.com",
  "countryCode": "US",
  "format": "ALL",
  "maxResults": 40
}
```

# Actor output Schema

## `overview` (type: `string`):

View all ads with advertiser name, creative ID, format type, dates, and transparency URL.

## `creatives` (type: `string`):

View ad creatives with images, format details, and variant information.

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

View advertiser details with IDs, format types, and dates.

# 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 = {
    "domain": "google.com",
    "countryCode": "US",
    "format": "ALL",
    "maxResults": 40
};

// Run the Actor and wait for it to finish
const run = await client.actor("burbn/google-ads-search").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 = {
    "domain": "google.com",
    "countryCode": "US",
    "format": "ALL",
    "maxResults": 40,
}

# Run the Actor and wait for it to finish
run = client.actor("burbn/google-ads-search").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 '{
  "domain": "google.com",
  "countryCode": "US",
  "format": "ALL",
  "maxResults": 40
}' |
apify call burbn/google-ads-search --silent --output-dataset

```

## MCP server setup

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

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/RZh1p4UJH7x02V2pC/builds/UE9cTAGe9tVh7b8oQ/openapi.json