# Google Ads Transparency Scraper (`solid-scraper/google-ads-transparency-scraper`) Actor 📣 Google Ads Transparency Scraper helps you extract ad transparency data fast—track advertisers, placements, and trends with precision. Ideal for marketers, agencies, and researchers. 🚀 Efficient, reliable, and easy to use. - **URL**: https://apify.com/solid-scraper/google-ads-transparency-scraper.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Developer tools, Lead generation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Transparency Scraper 🔍 **Google Ads Transparency Scraper** is an Apify actor that helps you scrape Google Ads Transparency by advertiser URL, so you can quickly collect ad transparency details for analysis, monitoring, and reporting. Whether you’re using a **Google Ads transparency scraper**, **Google Ads Transparency Center scraper**, or a **Google Ads transparency report scraper**, this tool is built to reduce the manual effort of gathering structured ad data at scale—saving you hours of manual work. --- ### 🚀 Why choose Google Ads Transparency Scraper? | Feature | Benefit | |---|---| | ✅ **URL-based input** | Start from a list of Google Ads Transparency advertiser URLs and scrape ads directly per advertiser | | ✅ **Reliability with resilience** | Includes fallback behavior and stops cleanly when no more ads are available or limits are reached | | ✅ **Configurable max ads per advertiser** | Control the workload with `maxAds` (minimum 1) to match your research needs | | ✅ **Structured, consistent output** | Produces well-labeled JSON fields like advertiser ID, ad dates, and transparency URLs | | ✅ **Designed for automation** | Run the same process repeatedly for monitoring and ongoing dataset refreshes | | ✅ **Scales across multiple advertisers** | Process multiple `startUrls` in one run and push each ad result into the output dataset | --- ### 🧩 Key features - 📌 **Google Ads Transparency URL support**: Accepts a list of Google Ads Transparency advertiser URLs via `startUrls` - 🏷️ **Advertiser context included**: Outputs `advertiserId` and `advertiserName` alongside each creative’s details - 🧾 **Complete ad visibility timing**: Captures `firstShown` and `lastShown` when available - 🔗 **Transparency links included**: Provides both the `sourceUrl` (your input advertiser URL) and an `adLibraryUrl` for each creative - 🛡️ **Resilient pagination**: Retrieves multiple pages of creatives until the end is reached or `maxAds` is reached - 💾 **Structured dataset output**: Pushes each ad as a separate JSON object (with an explicit `charged_event_name="result"`) - ⚙️ **Limit controls**: Uses `maxAds` to cap how many ads are scraped per advertiser request --- ### 📝 Input Provide input via an `input.json` file. Example structure: ```json { "startUrls": [ { "url": "https://adstransparency.google.com/advertiser/AR08888592736429539329?authuser=0®ion=ES&preset-date=Last+30+days" } ], "maxAds": 100 } ```` #### Input Fields | Field | Required | Description | |---|---|---| | `startUrls` | ✅ | List of Google Ads Transparency advertiser URLs. The actor reads the advertiser ID from each URL and uses it to fetch creatives. | | `maxAds` | ❌ | Maximum number of ads to scrape per advertiser. Default is `100`. Minimum is `1`. | *** ### 📦 Output The actor saves each ad’s data in JSON format (one object per ad) in the Apify dataset. Example output record: ```json { "advertiserId": "AR08888592736429539329", "advertiserName": "Unknown", "creativeId": "1234567890", "format": "DISPLAY", "firstShown": 1765457654, "lastShown": 1765460754, "previewUrl": "https://example.com/preview.png", "sourceUrl": "https://adstransparency.google.com/advertiser/AR08888592736429539329?authuser=0®ion=ES&preset-date=Last+30+days", "adLibraryUrl": "https://adstransparency.google.com/advertiser/AR08888592736429539329/creative/1234567890?authuser=0" } ``` #### Output Fields | Field | Type | Description | |---|---|---| | `advertiserId` | string | The advertiser ID extracted for the transparency page being scraped | | `advertiserName` | string | Advertiser name fetched by ID; falls back to `Unknown` if advertiser info can’t be retrieved | | `creativeId` | string | Creative (ad) ID for the transparency record | | `format` | string | Ad format value returned by the transparency data | | `firstShown` | number | First shown timestamp (as provided by the source) | | `lastShown` | number | Last shown timestamp (as provided by the source) | | `previewUrl` | string | Preview URL for the creative when available | | `sourceUrl` | string | The advertiser URL you provided in `startUrls` | | `adLibraryUrl` | string | A transparency link for the specific creative record | > Note: This actor pushes ad-level records via `Actor.push_data(...)` with `charged_event_name="result"`—so each row in the dataset corresponds to one creative/ad record. *** ### 🧰 How to use Google Ads Transparency Scraper (via Apify Console) 1. **Open Apify Console**: Go to [console.apify.com](https://console.apify.com) and sign in. 2. **Find the actor**: Search for **Google Ads Transparency Scraper** in the Actors marketplace. 3. **Open the INPUT panel**: Paste your JSON into the input editor (or fill it in the UI if available). 4. **Add your advertiser URLs**: In `startUrls`, provide one or more Google Ads Transparency advertiser URLs. 5. **Set `maxAds`**: Choose how many ads you want per advertiser (default is `100`; minimum is `1`). 6. **Run the actor**: Click **Run** to start the scraping job. 7. **Monitor progress**: Watch the logs for which URL is being processed, how many ads are found per page, and when scraping finishes. 8. **Access results**: Open the Apify **dataset** from the run and export to JSON/CSV as needed. No coding required—get Google Ads transparency data in minutes with this Google Ads transparency report scraper style workflow. *** ### ✨ Advanced features & SEO optimization - 🔄 **Pagination until completion**: The actor keeps fetching additional creatives until it reaches the end or hits your `maxAds` cap, making it suitable for a “Google Ads transparency monitoring tool” workflow. - 🧠 **Built for keyword-plus-filter style research**: This tool uses your `startUrls` as the entry point and focuses on structured extraction for each advertiser—ideal when you need a **Google Ads transparency API alternative** approach without building custom scrapers. - 💾 **Dataset-ready fields**: Each result includes `firstShown`, `lastShown`, and a per-creative `adLibraryUrl`, which is helpful for **Google Ads transparency data download** style deliverables. - 🛡️ **Resilience through fallback logic**: Includes built-in handling when advertiser info or creatives cannot be fetched cleanly, so runs don’t fail silently. *** ### 🎯 Best use cases - 📈 **Marketing analysts building ad visibility timelines**: Quickly assemble structured ad transparency records to understand when creatives were shown - 🧾 **Compliance and research teams validating advertiser activity**: Cross-check advertiser creatives using per-creative transparency URLs - 🧑‍💼 **Brand strategists performing competitive monitoring**: Refresh datasets for multiple advertisers using `startUrls` in one run - 🔎 **Investigators consolidating public transparency evidence**: Export structured fields like `creativeId`, `firstShown`, and `lastShown` - 🧠 **Data scientists creating modeling datasets**: Turn ad transparency extraction results into a clean table for analysis - 🛠️ **Developers automating reporting pipelines**: Schedule repeated runs to maintain an up-to-date **Google Ads transparency dataset scraper** output - 🗞️ **Political ad transparency researchers**: Use the same workflow to support **political ad transparency scraper** research where transparency pages are publicly accessible *** ### 🔧 Technical specifications - **Supported Input Formats** - ✅ `startUrls` as an array of objects containing `url` strings (Google Ads Transparency advertiser URLs) - **Proxy Support** - ✅ Proxy support is exposed via an input field named `proxyConfiguration` (supports using Apify proxy) - **Retry Mechanism** - ✅ Includes resilience and safe stopping behavior when creatives are unavailable or limits are reached - **Dataset Structure** - ✅ JSON objects pushed for each creative/ad with fields like `advertiserId`, `creativeId`, `firstShown`, `lastShown`, `previewUrl`, `sourceUrl`, and `adLibraryUrl` - **Rate Limits & Performance** - ✅ Designed for batch scraping across multiple `startUrls`, with pagination and a configurable cap via `maxAds` - **Limitations** - ❌ If advertiser IDs can’t be extracted from a provided `startUrls` URL, that entry is skipped - ❌ If advertiser info lookup fails, `advertiserName` falls back to `Unknown` *** ### ❓ FAQ #### What does the Google Ads Transparency Scraper output? ✅ It outputs one JSON object per creative/ad, including `advertiserId`, `advertiserName`, `creativeId`, `firstShown`, `lastShown`, `previewUrl`, `sourceUrl`, and an `adLibraryUrl` link for each creative. #### Do I need to pass special query parameters to scrape data? ❌ No. You provide the transparency page entry points via `startUrls` (advertiser URLs). The actor extracts the advertiser ID from the URL and uses it to retrieve creative records. #### How do I limit how many ads get scraped? ✅ Use `maxAds`. This caps the total number of ads to fetch per advertiser. #### Can I scrape multiple advertisers in a single run? ✅ Yes. Provide multiple items in `startUrls`, and the actor will process each one and push results into the dataset. #### Can I use this as a Google Ads transparency API alternative? ✅ Yes in the sense that it automates extraction into a structured dataset, without requiring you to build your own scraping pipeline. It’s especially useful when you want **Google Ads transparency report scraper**-style outputs in a ready-to-export format. #### Is the data only from publicly accessible sources? ✅ Yes. The actor is intended to scrape publicly available transparency pages and extract structured fields from them. #### Do you support exporting to CSV? ✅ Apify datasets can be exported to JSON and CSV from the dataset UI after the run finishes (the actor itself pushes JSON records to the dataset). #### Can I scrape political ads specifically? ✅ If the political ad transparency content is present on the publicly accessible transparency pages you provide in `startUrls`, you can scrape it using this workflow as a **political ad transparency scraper**. *** ### 🤝 Support & feature requests Have feedback on **Google Ads Transparency Scraper** or want to request enhancements? We’d love to hear from you. - 💡 **Feature Requests**: Examples include adding CSV-friendly field formatting, additional dataset enrichment fields, or alternative output structures for easier **Google Ads transparency data download** workflows. - 📧 **Contact**: Email us at Your feedback helps shape the roadmap for future improvements to this Google Ads transparency scraper. *** ### 🏁 Final thoughts on Google Ads Transparency Scraper *If you’re looking for a clean, structured way to automate Google Ads transparency extraction, this is a fast path to results.*\ **Google Ads Transparency Scraper** is an SEO-optimized, dataset-first tool designed to help you scale your transparency work efficiently. *** ### Disclaimer **This tool only accesses publicly accessible sources.** It does not access private profiles, authenticated-only content, or password-protected pages. You are responsible for ensuring your use complies with applicable laws and regulations (including GDPR/CCPA where relevant), spam regulations, and the target platform’s terms of service. Always use the actor responsibly and ethically. For data removal requests, contact . # Actor input Schema ## `startUrls` (type: `array`): List of Google Ads Transparency advertiser URLs. ## `maxAds` (type: `integer`): Maximum number of ads to scrape per advertiser. ## Actor input object example ```json { "startUrls": [ { "url": "https://adstransparency.google.com/advertiser/AR08888592736429539329?authuser=0®ion=ES&preset-date=Last+30+days" } ], "maxAds": 100 } ``` # 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 = { "startUrls": [ { "url": "https://adstransparency.google.com/advertiser/AR08888592736429539329?authuser=0®ion=ES&preset-date=Last+30+days" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("solid-scraper/google-ads-transparency-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 = { "startUrls": [{ "url": "https://adstransparency.google.com/advertiser/AR08888592736429539329?authuser=0®ion=ES&preset-date=Last+30+days" }] } # Run the Actor and wait for it to finish run = client.actor("solid-scraper/google-ads-transparency-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 '{ "startUrls": [ { "url": "https://adstransparency.google.com/advertiser/AR08888592736429539329?authuser=0®ion=ES&preset-date=Last+30+days" } ] }' | apify call solid-scraper/google-ads-transparency-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/google-ads-transparency-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper", "description": "📣 Google Ads Transparency Scraper helps you extract ad transparency data fast—track advertisers, placements, and trends with precision. Ideal for marketers, agencies, and researchers. 🚀 Efficient, reliable, and easy to use.", "version": "0.1", "x-build-id": "c5mdMh2V49YYcgHYo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-google-ads-transparency-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/solid-scraper~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-solid-scraper-google-ads-transparency-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/solid-scraper~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-solid-scraper-google-ads-transparency-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Google Ads Transparency URLs", "type": "array", "description": "List of Google Ads Transparency advertiser URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxAds": { "title": "Max Ads per Advertiser", "minimum": 1, "type": "integer", "description": "Maximum number of ads to scrape per advertiser.", "default": 100 } } }, "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 } } } } } } } } } } ```