# Google Advertiser Ads Scraper (`burbn/google-advertiser-ads-scraper`) Actor
Extract every single ad from any Google Ads advertiser! Scrape Google Ads Transparency Center by Advertiser ID. Extract images, videos, text, and dates. Perfect for deep competitor analysis, ad intelligence, and tracking full brand campaigns automatically.
- **URL**: https://apify.com/burbn/google-advertiser-ads-scraper.md
- **Developed by:** [Kevin](https://apify.com/burbn) (community)
- **Categories:** Developer tools, Automation, Lead generation
- **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 Advertiser Ads Scraper - Search Ads by Advertiser ID | Google Ads Library API
Scrape Google Ads Transparency Center by advertiser ID. Extract all ads from a specific Google Ads advertiser including 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 advertiser scraper for competitor ad analysis, Google Ads monitoring, ad intelligence, and marketing research.
### ❓ What is Google Advertiser Ads Scraper?
**Google Advertiser Ads Scraper** is a powerful Apify actor that lets you search and extract all ads from a specific advertiser on the **Google Ads Transparency Center** (Google Ads Library) using their advertiser ID. Whether you want to monitor a competitor's full ad portfolio, analyze brand advertising strategies, or collect ad creative data for research — this Google Ads advertiser scraper does it all automatically.
With this Google Ads advertiser tool, you can:
- 🔍 **Search Google Ads by advertiser ID** — Enter any advertiser ID to find all their 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
- 📅 **Filter by date range** — Set start and end period to get ads from a specific time frame
- 📊 **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
### 🆔 How to Get an Advertiser ID?
You can get the advertiser ID by running our **[Google Ads Search](https://apify.com/burbn/google-ads-search)** actor first. Search any domain and each result will include an `advertiserId` field (e.g., `AR14188379519798214657`). Use that ID as input for this actor to get all ads from that specific advertiser.
### 🎯 What Data Can You Extract from Google Ads?
This Google Ads advertiser 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 Advertiser Ads Scraper
#### Step 1: Get the Advertiser ID
Run the **[Google Ads Search](https://apify.com/burbn/google-ads-search)** actor with any domain to get advertiser IDs. Each result includes an `advertiserId` field — copy that value.
#### Step 2: Configure Your Search
Enter the advertiser ID and set optional filters like country, ad format, and date range.
| Input | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| `advertiser_id` | String | ✅ Yes | — | Google Ads advertiser ID (e.g., `AR14188379519798214657`) |
| `country_code` | String | ❌ No | `US` | Country code — US, GB, IN, DE, FR, CA, AU, etc. |
| `format` | String | ❌ No | `ALL` | Ad format filter — ALL, IMAGE, TEXT, VIDEO |
| `start_period` | String | ❌ No | — | Start date filter (YYYY-MM-DD) |
| `end_period` | String | ❌ No | — | End date filter (YYYY-MM-DD) |
| `maxResults` | Integer | ❌ No | `40` | Maximum number of Google Ads to scrape (1–100) |
#### Step 3: Run and Download Results
Click **Start** to run the Google Ads advertiser scraper. Results are available in JSON, CSV, Excel, XML, and RSS formats.
### 📋 Example Input
```json
{
"advertiser_id": "AR12508163402792697857",
"country_code": "US",
"format": "ALL",
"maxResults": 40
}
````
### 📋 Example Output
```json
{
"advertiserId": "AR12508163402792697857",
"advertiserName": "Google LLC",
"creativeId": "CR14844389921191362561",
"originalUrl": "https://adstransparency.google.com/advertiser/AR12508163402792697857/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 advertiser 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 Advertiser Ads Scraper
- **Full Advertiser Portfolio Analysis** — Get every single ad from a specific advertiser to understand their complete advertising strategy
- **Competitor Google Ads Monitoring** — Track all ads from competitor advertisers over time
- **Brand Monitoring** — Monitor all Google Ads associated with a specific advertiser ID
- **Ad Intelligence & Marketing Research** — Understand Google Ads trends, advertising strategies, and creative patterns by advertiser
- **Compliance & Transparency Monitoring** — Monitor ad transparency data and advertiser activity on Google Ads
- **Ad Creative Inspiration** — Browse all ad creatives from top advertisers for design and copywriting inspiration
- **Digital Marketing Audits** — Analyze the full Google Ads presence of any advertiser for client reports
### 🔧 Tips for Best Results
1. **Get the advertiser ID first** — Run the [Google Ads Search](https://apify.com/burbn/google-ads-search) actor with any domain to find advertiser IDs
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. **Use date filters** — Set start and end period to narrow down ads to a specific time frame
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 advertiser` `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` `advertiser ads` `advertiser id` `ad campaign analysis` `marketing intelligence` `brand monitoring` `ad tracking` `google ads by advertiser`
### 🎁 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 advertiser scraper, please contact us through Apify or open an issue.
***
**Happy scraping Google Ads! 📊✨**
# Actor input Schema
## `advertiser_id` (type: `string`):
Google Ads advertiser identifier (e.g., AR14188379519798214657). You can get this by running the Google Ads Search actor with any domain.
## `country_code` (type: `string`):
Two-letter ISO country code to filter ads by region (e.g., US, GB, IN, DE, FR). Leave empty for all regions.
## `format` (type: `string`):
Filter ads by format type.
## `start_period` (type: `string`):
Filter ads starting from this date. Use YYYY-MM-DD format (e.g., 2025-01-01). Leave empty to include all dates.
## `end_period` (type: `string`):
Filter ads up to this date. Use YYYY-MM-DD format (e.g., 2026-03-31). Leave empty to include all dates.
## `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
{
"advertiser_id": "AR12508163402792697857",
"country_code": "US",
"format": "ALL",
"maxResults": 40
}
```
# Actor output Schema
## `overview` (type: `string`):
View all ads for the advertiser.
# 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 = {
"advertiser_id": "AR12508163402792697857",
"country_code": "US",
"format": "ALL",
"maxResults": 40
};
// Run the Actor and wait for it to finish
const run = await client.actor("burbn/google-advertiser-ads-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"advertiser_id": "AR12508163402792697857",
"country_code": "US",
"format": "ALL",
"maxResults": 40,
}
# Run the Actor and wait for it to finish
run = client.actor("burbn/google-advertiser-ads-scraper").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 '{
"advertiser_id": "AR12508163402792697857",
"country_code": "US",
"format": "ALL",
"maxResults": 40
}' |
apify call burbn/google-advertiser-ads-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=burbn/google-advertiser-ads-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Google Advertiser Ads Scraper",
"description": "Extract every single ad from any Google Ads advertiser! Scrape Google Ads Transparency Center by Advertiser ID. Extract images, videos, text, and dates. Perfect for deep competitor analysis, ad intelligence, and tracking full brand campaigns automatically.",
"version": "1.0",
"x-build-id": "7ESmE2f7qG1zApBnQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/burbn~google-advertiser-ads-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-burbn-google-advertiser-ads-scraper",
"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-advertiser-ads-scraper/runs": {
"post": {
"operationId": "runs-sync-burbn-google-advertiser-ads-scraper",
"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-advertiser-ads-scraper/run-sync": {
"post": {
"operationId": "run-sync-burbn-google-advertiser-ads-scraper",
"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": [
"advertiser_id"
],
"properties": {
"advertiser_id": {
"title": "🆔 Advertiser ID",
"type": "string",
"description": "Google Ads advertiser identifier (e.g., AR14188379519798214657). You can get this by running the Google Ads Search actor with any domain.",
"default": "AR12508163402792697857"
},
"country_code": {
"title": "🌍 Country Code",
"type": "string",
"description": "Two-letter ISO country code to filter ads by region (e.g., US, GB, IN, DE, FR). Leave empty for all regions."
},
"format": {
"title": "🎨 Ad Format",
"enum": [
"ALL",
"IMAGE",
"TEXT",
"VIDEO"
],
"type": "string",
"description": "Filter ads by format type.",
"default": "ALL"
},
"start_period": {
"title": "📅 Start Period",
"type": "string",
"description": "Filter ads starting from this date. Use YYYY-MM-DD format (e.g., 2025-01-01). Leave empty to include all dates."
},
"end_period": {
"title": "📅 End Period",
"type": "string",
"description": "Filter ads up to this date. Use YYYY-MM-DD format (e.g., 2026-03-31). Leave empty to include all dates."
},
"maxResults": {
"title": "🎯 Maximum Results",
"minimum": 1,
"maximum": 100,
"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
}
}
}
}
}
}
}
}
}
}
```