# 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
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN 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/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# 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": "![](\"https://tpc.googlesyndication.com/archive/simgad/2084202696746803113\")
",
"imageUrl": "https://tpc.googlesyndication.com/archive/simgad/2084202696746803113",
"variantFormat": "Image",
"variants": [
{
"content": "",
"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 '' with your token
const client = new ApifyClient({
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 '' with your token.
client = ApifyClient("")
# 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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=burbn/google-ads-search",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Google Ads Search by Domain",
"description": "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.",
"version": "1.0",
"x-build-id": "UE9cTAGe9tVh7b8oQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/burbn~google-ads-search/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-burbn-google-ads-search",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/burbn~google-ads-search/runs": {
"post": {
"operationId": "runs-sync-burbn-google-ads-search",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/burbn~google-ads-search/run-sync": {
"post": {
"operationId": "run-sync-burbn-google-ads-search",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"title": "🌐 Domain",
"type": "string",
"description": "Enter the domain name to search for ads (e.g., google.com, amazon.com, nike.com).",
"default": "google.com"
},
"countryCode": {
"title": "🌍 Country Code",
"type": "string",
"description": "Two-letter country code to filter ads by region (e.g., US, GB, IN, DE). Leave empty for all regions.",
"default": "US"
},
"format": {
"title": "🎨 Ad Format",
"enum": [
"ALL",
"IMAGE",
"TEXT",
"VIDEO"
],
"type": "string",
"description": "Filter ads by format type.",
"default": "ALL"
},
"maxResults": {
"title": "🎯 Maximum Results",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum total number of ad results to scrape. Higher limits will take longer but provide more comprehensive results.",
"default": 40
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```