# Google Ads Transparency Scraper (`scrapeflux/google-ads-transparency-scraper`) Actor 🔍 Google Ads Transparency Scraper extracts key ad transparency data (funding, targeting, ads, domains) from Google Ads. đź“Š Streamline compliance, competitor research & audits with fast, reliable scraping. 🚀 Perfect for agencies & marketers. - **URL**: https://apify.com/scrapeflux/google-ads-transparency-scraper.md - **Developed by:** [ScrapeFlux](https://apify.com/scrapeflux) (community) - **Categories:** Automation, Developer tools, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.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 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 Transparency Scraper 🚀 Fetching Google Ads transparency data by hand is slow and inconsistent—especially when you need the same fields across multiple advertisers. **Google Ads Transparency Scraper** streamlines the process by scraping transparency creatives from advertiser URLs in bulk. It’s also a solid **Google Ads transparency center scraper** for teams automating **Google Ads transparency report automation**. This actor is built for marketers, analysts, and researchers who want transparency data fast without repeating manual steps. In one run, you can pull up to **`maxAds` per advertiser** and start exporting immediately. --- ### See the Data: Sample Output Here's a real record from a single run: ```json { "advertiserId": "AR123456789012345678", "advertiserName": "Example Advertiser", "creativeId": "9876543210", "format": "DISPLAY", "firstShown": 1765450000, "lastShown": 1765459000, "previewUrl": "https://example.com/preview", "sourceUrl": "https://adstransparency.google.com/advertiser/AR123456789012345678?authuser=0®ion=ES&preset-date=Last+30+days", "adLibraryUrl": "https://adstransparency.google.com/advertiser/AR123456789012345678/creative/9876543210?authuser=0" } ```` | Field | Type | What It Tells You | |---|---|---| | `advertiserId` | string | The advertiser identifier you can use to group and join results in your dataset. | | `advertiserName` | string | Human-friendly advertiser name to make reporting and QA much easier. | | `creativeId` | string | A unique creative identifier for tracking specific ads over time. | | `format` | string | Creative format label so you can segment results by ad type. | | `firstShown` | number | Timestamp (as returned by the actor) for when the creative first appeared. | | `lastShown` | number | Timestamp (as returned by the actor) for when the creative was last shown. | | `previewUrl` | string | Direct preview link for quick review without leaving your workflow. | | `sourceUrl` | string | The advertiser URL you provided—useful for traceability in audits. | | `adLibraryUrl` | string | Direct link to the transparency creative page for deeper inspection. | | `status` / `error_message` | not produced by this actor | This actor does not push a `status` or `error_message` field in output records; it logs errors instead. | Export your full dataset as JSON, CSV, or Excel from the Apify dashboard. *** ### Setting It Up Drop this into your `input.json` and you're ready to go: ```json { "startUrls": [ { "url": "https://adstransparency.google.com/advertiser/AR08888592736429539329?authuser=0®ion=ES&preset-date=Last+30+days" } ], "maxAds": 100 } ``` | Parameter | Required | What It Does | |---|---|---| | `startUrls` | âś… | List of Google Ads Transparency advertiser URLs you want to scrape. | | `↳ startUrls[].url` | âś… | The full advertiser URL to target (the actor uses it to find the advertiser identifier). | | `maxAds` | ⬜ | Maximum number of ads to scrape per advertiser (default: `100`, minimum: `1`). | *** ### What It Does Google Ads Transparency Scraper collects transparency creative details for each advertiser URL you provide and writes each creative as a structured JSON record. #### Scrapes Google Ads Transparency creatives by advertiser URL You provide one or more advertiser URLs via `startUrls`. For each advertiser, the actor pulls creative records until it reaches your `maxAds` cap. #### Uses your `maxAds` cap to control how much data you collect If you set `maxAds` higher, you’ll retrieve more creatives per advertiser; if you set it lower, you’ll get a smaller, faster sample. This is helpful when you’re doing early validation for a Google Ads transparency report scraper workflow. #### Clean, integration-ready JSON output Each output record includes fields like `advertiserId`, `advertiserName`, `creativeId`, `format`, and timing fields (`firstShown`, `lastShown`), along with URLs (`previewUrl`, `adLibraryUrl`). That makes it straightforward to feed a **Google Ads transparency API scraper**-style pipeline (even if you start from the UI). #### Handles missing info and continues when possible If advertiser info can’t be fetched, the actor still continues with `advertiserName` set to `"Unknown"` rather than stopping your whole job. It also processes creatives page by page and stops when it reaches the end condition or your `maxAds` limit. #### Supports built-in proxy configuration for more reliable runs The actor accepts `proxyConfiguration` in its runtime input and can use Apify Proxy-style settings for improved reliability on repeated requests. This is useful when you scale up to scrape Google Ads transparency data across many advertisers. Overall, **Google Ads Transparency Scraper** gives you a practical way to automate extraction of Google Ads transparency creatives—ready for analysis, reporting, and monitoring. *** ### Why Google Ads Transparency Scraper? There are plenty of ways to pull data from ad transparency pages—here’s why Google Ads Transparency Scraper stands out. #### Designed for automation-ready datasets The actor outputs consistent JSON objects with the creative-level fields you typically need for analysis and reporting (IDs, formats, first/last shown, and links). That directly supports workflows like ads transparency dataset scraper projects and Google Ads disclaimer transparency scraper reviews. #### You control volume with `maxAds` per advertiser When you need quick validation, you can cap results tightly. When you need a full export, you can raise `maxAds`—making it easier to run test batches and production runs without code changes. #### Less friction than manual exports Instead of copying and curating creatives by hand, this tool turns a list of advertiser URLs into a structured dataset in one run. It’s built for the reality that teams need transparency data repeatedly, not just once. *** ### Real-World Use Cases Here’s how different teams put Google Ads Transparency Scraper to work: **Marketing Ops & Competitive Intelligence** A marketing analyst maintains a shortlist of advertisers and needs their latest transparency creatives for ongoing competitive monitoring. They run Google Ads transparency report automation each week, export the dataset, and refresh dashboards without manual copying. **Compliance & Policy Review** A compliance reviewer needs to audit creative activity across known advertiser entities. They scrape creatives from a curated list of advertiser URLs, use the `sourceUrl` for traceability, and open `adLibraryUrl` for deeper review when something looks unexpected. **Political Research Teams** Researchers track political ad patterns and want a repeatable way to compile transparency data over time. By automating extraction across multiple advertisers, they build an ads transparency dataset scraper feed they can analyze longitudinally. **Agencies Running Multiple Client Watchlists** An agency manages watchlists for several clients and wants consistent output across different advertiser sources. Google Ads transparency center scraper runs let them generate exports per client quickly, then share cleaned results for analysis and reporting. **Automation & Data Engineering** A developer triggers runs from Apify, then ingests the creative records into a data pipeline for downstream processing. With structured fields like `creativeId`, `format`, and `firstShown`/`lastShown`, they can automate refreshes of a Google Ads transparency monitoring tool dataset. *** ### How to Run It No code required. Here's how to get your first results in under 5 minutes: 1. **Open the actor on Apify**\ Go to the actor page on Apify at [console.apify.com](https://console.apify.com). 2. **Enter your inputs**\ Paste your advertiser URL(s) into `startUrls` (each item must include `url`). Set `maxAds` to control how many ads to fetch per advertiser. 3. **Configure proxy settings (optional)**\ If you’re running larger batches, enable the actor’s proxy configuration for improved reliability. 4. **Start the run and watch the live log**\ Monitor progress in the Apify console logs—this actor logs per-page progress and completion per target URL. 5. **Open the Dataset tab to see live results**\ As creatives are found, records are pushed to the dataset as JSON objects. 6. **Export in your preferred format**\ Download from the Apify dataset tab as JSON, CSV, or Excel, or connect via your usual data workflow. The whole setup takes under 5 minutes — results start appearing within seconds of launch. *** ### Export & Integration Options Once your data is collected, Google Ads Transparency Scraper fits directly into your existing workflow. You can export your dataset (from the Apify dataset tab) as JSON, CSV, or Excel for quick sharing and analysis. This is ideal when you want to build a Google Ads transparency export tool for recurring reporting. For automation, you can pull results programmatically via the Apify API, trigger downstream tasks with webhooks when a run completes, or use Zapier / Make to push outputs into other tools. You can also run scheduled jobs for ongoing Google Ads transparency monitoring tool workflows. *** ### Pricing Google Ads Transparency Scraper runs on Apify, which includes a **free tier** — no credit card needed to start. On Apify, you typically get free platform credits on sign-up, and you can then scale using pay-as-you-go billing based on Actor compute units (CUs). For heavier workloads across many advertisers, you can use Apify’s paid plans. Start free at [apify.com](https://apify.com) — scale up when you need to. *** ### Reliability & Limitations | What We Handle | How | |---|---| | Rate limits & stability | Built with reliability in mind and supports proxy configuration for more dependable runs. | | Pagination / volume | Collects creatives in pages until it reaches the end condition or your `maxAds` limit. | | Missing advertiser name | Falls back to `advertiserName: "Unknown"` if advertiser info can’t be fetched. | | Error logging | Errors are logged during processing so you can diagnose issues from the Apify run logs. | | Controlled dataset size | `maxAds` caps how many ads are collected per advertiser. | **Limitations:** This actor is intended for publicly accessible transparency pages. If advertiser information or creative data isn’t available for a given URL, results may be limited (for example, `advertiserName` can remain `"Unknown"`). For workloads or requirements beyond the actor’s input/output scope, you may need custom adjustments. For enterprise-scale needs or custom configurations, reach out and we'll help. *** ### Frequently Asked Questions #### Is there a free plan? Yes, Apify offers a free tier on many actors, allowing you to run small tests and validate output before scaling. #### Do I need to log in or create an account on Google Ads Transparency? No. You run the actor by providing `startUrls`, and it scrapes the transparency data from those advertiser pages without requiring an interactive login flow from you. #### How accurate is the extracted data? The actor outputs fields directly based on what’s available in the transparency creatives it retrieves. Accuracy depends on what the transparency pages provide for each advertiser and creative. #### How many results can I get per run? You control volume with `maxAds`, which limits the maximum number of creatives scraped per advertiser URL in `startUrls`. #### How fresh is the data? Your results freshness depends on the time window reflected in the advertiser transparency URLs you supply in `startUrls` (for example, preset date ranges included in the URL). #### Is this legal? Does it comply with GDPR / CCPA? This actor is intended for collecting **publicly available data**. You are responsible for how you use, store, and process the exported dataset, including compliance with GDPR, CCPA, and applicable platform terms. #### Can I export to Google Sheets or Excel? Yes. You can export the dataset from the Apify dashboard as JSON, CSV, or Excel, then import into Google Sheets or any spreadsheet tool that supports those formats. #### Can I schedule this to run automatically? Yes. You can schedule Apify actor runs on a cron schedule so your Google Ads transparency export tool stays up to date without manual intervention. #### Can I access results via the API? Yes. You can retrieve results programmatically via the Apify API after the run completes. #### What happens when the actor encounters an error? When errors occur, the actor writes details to the Apify logs and continues processing where possible (for example, it can fall back to `advertiserName: "Unknown"` and keep going). It stops fetching for a target when it reaches the end condition or your `maxAds` limit. *** ### Get Help & Use Responsibly Got a question about Google Ads Transparency Scraper or a feature you’d like added? Reach out at . We’re happy to help with run setup and ideas like custom export shaping or additional fields in future versions. **This actor collects publicly available data** from the pages you provide and does not access private accounts, login-gated pages, or password-protected content. You’re responsible for ensuring your use complies with GDPR, CCPA, and platform Terms of Service. For data removal requests, contact . Use responsibly, ethically, and only for lawful purposes. # 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("scrapeflux/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("scrapeflux/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 scrapeflux/google-ads-transparency-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeflux/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 extracts key ad transparency data (funding, targeting, ads, domains) from Google Ads. đź“Š Streamline compliance, competitor research & audits with fast, reliable scraping. 🚀 Perfect for agencies & marketers.", "version": "0.1", "x-build-id": "c0Te5oN3cX01zZYxJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeflux~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeflux-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/scrapeflux~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-scrapeflux-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/scrapeflux~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeflux-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 } } } } } } } } } } ```