# Google Ads Transparency Scraper + Landing Pages (`lirafrt/google-ads-transparency-intelligence`) Actor Export public Google ad creatives, decoded responsive copy, media, dates, advertiser data, and optional deterministic landing-page conversion signals. - **URL**: https://apify.com/lirafrt/google-ads-transparency-intelligence.md - **Developed by:** [Murilo Lira](https://apify.com/lirafrt) (community) - **Categories:** Marketing, Business, SEO tools - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 google ads This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 + Landing Pages Turn public Google Ads Transparency Center creatives into a clean competitor-ad dataset. Search by advertiser domain, public advertiser name, or Google advertiser ID, then export normalized dates, media, copy, destination signals, and source links. Unlike a basic creative-ID scraper, this Actor inspects current public preview payloads to recover observable headline and description text from supported responsive/text creatives. An optional landing-page audit adds deterministic conversion and technology signals without an LLM or paid proxy. ### What you get - one deduplicated dataset item per public creative; - advertiser and creative IDs, advertiser name, first/last shown timestamps, and source URL; - inferred format plus public image, video, and preview URLs; - decoded headline, description, call to action, display URL, and destination when observable; - optional landing-page status, title, meta description, H1/form/contact/privacy/terms signals, CTAs, tracking vendors, and technology hints; - a `RUN_SUMMARY` record that distinguishes a legitimate empty result from blocking, transient errors, and source-contract changes. Unknown source values stay `null`. The Actor does not invent spend, impressions, targeting, verification, or platform data. ### Quick start The most precise query is a domain: ```json { "query": "hubspot.com", "region": "US", "maxAds": 100, "includeCreativeDetails": true, "includeLandingPageAudit": false } ```` You can also use a public advertiser ID: ```json { "query": "AR10072600183532683265", "queryType": "advertiserId", "region": "anywhere", "maxAds": 50 } ``` For advertiser-name searches, the Actor ranks public suggestions and inspects up to `maxAdvertisers` matches. A name is not an arbitrary ad-copy keyword. ### Inputs | Input | Default | Purpose | |---|---:|---| | `query` | required | Domain, advertiser name, or `AR…` advertiser ID. | | `queryType` | `auto` | `auto`, `domain`, `advertiserId`, or `name`. | | `region` | `US` | Two-letter region or `anywhere`. Current region IDs are discovered from the public source. | | `maxAds` | `100` | Hard output cap, from 1 to 1,000. | | `maxAdvertisers` | `3` | Best-matching profiles inspected for name searches. | | `dateFrom`, `dateTo` | none | Inclusive UTC overlap filter. | | `includeCreativeDetails` | `true` | Inspect public creative variations and decode observable content. | | `maxVariationsPerAd` | `3` | Bound preview work per creative. | | `includeLandingPageAudit` | `false` | Audit normalized public destination pages. | | `maxLandingPages` | `10` | Hard cap on distinct audited URLs. | | `respectRobotsTxt` | `true` | Skip landing pages disallowed to this Actor. | | `maxRequestsPerMinute` | `120` | Global Transparency Center pacing limit. | | `requestTimeoutSecs` | `20` | Per-request timeout. | | `maxRetries` | `2` | Bounded retry count for transient source failures. | | `maxConcurrency` | `4` | Detail/audit concurrency; global pacing still applies. | | `includeRaw` | `false` | Include the provider search item for debugging. | ### Example record ```json { "recordType": "ad", "query": "AR10072600183532683265", "queryType": "advertiserId", "region": "US", "advertiserId": "AR10072600183532683265", "advertiserName": "Hubspot, Inc.", "advertiserVerified": null, "adId": "CR05033475523703996417", "format": "responsive", "headline": "HubSpot Smart CRM Tools - Work Better Together", "body": "Use AI-powered tools to streamline your work, align your teams and grow your business.", "displayUrl": "www.hubspot.com/pricing/smart-crm", "landingPageUrl": "https://www.hubspot.com/pricing/smart-crm", "landingPageDomain": "www.hubspot.com", "sourceUrl": "https://adstransparency.google.com/advertiser/AR10072600183532683265/creative/CR05033475523703996417?region=US" } ``` The actual record includes the complete stable schema and explicit `null` values. ### Cost controls Normal collection uses no LLM and no paid proxy. Runtime is bounded by `maxAds`, creative variations, request pacing, retries, landing-page cap, timeout, and concurrency. Keep landing-page auditing disabled for the lowest-cost export. Store pricing is pay per event: - `ad` β€” **$0.001**: one normalized record successfully written to the default dataset; - `landing_page` β€” **$0.003**: one distinct completed audit attached to a written record. The Actor also uses Apify's one-time `apify-actor-start` event (**$0.00005**). The implementation writes the dataset item before charging. Failed, malformed, filtered, and duplicate source items are not charged. Apify shows the maximum charge before each paid run. ### Reliability and responsible use This is an independent Actor and not an official Google product or API. It reads public Ads Transparency Center data through an undocumented source contract, which can change. Contract mismatches fail loudly instead of returning a deceptive empty dataset. Only public information is collected. The Actor does not log credentials or full queries, bypass authentication/CAPTCHA/access controls, or claim unsupported ad-performance metrics. Landing-page checks reject non-public IP destinations, revalidate redirects, bound response sizes, and respect `robots.txt` by default. Users remain responsible for lawful use, retention, and compliance with applicable platform terms and local law. ### Support For a reproducible issue, include the run ID, region, query type, and whether creative details or landing audits were enabled. Do not post API tokens, private credentials, or customer data in support messages. # Actor input Schema ## `query` (type: `string`): A website domain (recommended), advertiser name, or advertiser ID beginning with AR. ## `queryType` (type: `string`): Auto detects domains and AR advertiser IDs. Select a type only when detection is ambiguous. ## `region` (type: `string`): Two-letter country code, or 'anywhere' for global results. ## `maxAds` (type: `integer`): Maximum unique ad records to write. Lower values finish faster and cost less. ## `maxAdvertisers` (type: `integer`): For name searches, inspect this many best-matching advertiser profiles. ## `dateFrom` (type: `string`): Optional inclusive start date in UTC. ## `dateTo` (type: `string`): Optional inclusive end date in UTC. ## `includeCreativeDetails` (type: `boolean`): Fetch creative variations and decode observable headline, description, display URL, and media URLs. ## `maxVariationsPerAd` (type: `integer`): Maximum creative variations inspected for each ad. ## `includeLandingPageAudit` (type: `boolean`): Optionally inspect public landing pages for deterministic conversion and technical signals. No LLM is used. ## `maxLandingPages` (type: `integer`): Maximum distinct landing pages audited in one run. ## `respectRobotsTxt` (type: `boolean`): Skip a landing page when its public robots.txt disallows this Actor. ## `maxRequestsPerMinute` (type: `integer`): Global pacing limit for requests to the Transparency Center. ## `requestTimeoutSecs` (type: `integer`): Per-request timeout in seconds. ## `maxRetries` (type: `integer`): Retries for rate limits and transient source errors. ## `maxConcurrency` (type: `integer`): Concurrent detail and landing-page work. Pacing still applies globally. ## `includeRaw` (type: `boolean`): Attach the raw provider item for debugging and forward compatibility. Increases dataset size. ## Actor input object example ```json { "query": "hubspot.com", "queryType": "auto", "region": "US", "maxAds": 100, "maxAdvertisers": 3, "includeCreativeDetails": true, "maxVariationsPerAd": 3, "includeLandingPageAudit": false, "maxLandingPages": 10, "respectRobotsTxt": true, "maxRequestsPerMinute": 120, "requestTimeoutSecs": 20, "maxRetries": 2, "maxConcurrency": 4, "includeRaw": false } ``` # Actor output Schema ## `ads` (type: `string`): Normalized public ad creatives and optional landing-page signals. ## `runSummary` (type: `string`): Counts, provider outcome, and charging totals for the run. # 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 = { "query": "hubspot.com" }; // Run the Actor and wait for it to finish const run = await client.actor("lirafrt/google-ads-transparency-intelligence").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 = { "query": "hubspot.com" } # Run the Actor and wait for it to finish run = client.actor("lirafrt/google-ads-transparency-intelligence").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 '{ "query": "hubspot.com" }' | apify call lirafrt/google-ads-transparency-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=lirafrt/google-ads-transparency-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper + Landing Pages", "description": "Export public Google ad creatives, decoded responsive copy, media, dates, advertiser data, and optional deterministic landing-page conversion signals.", "version": "0.1", "x-build-id": "yRFEYcRn3KZuW85TM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lirafrt~google-ads-transparency-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lirafrt-google-ads-transparency-intelligence", "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/lirafrt~google-ads-transparency-intelligence/runs": { "post": { "operationId": "runs-sync-lirafrt-google-ads-transparency-intelligence", "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/lirafrt~google-ads-transparency-intelligence/run-sync": { "post": { "operationId": "run-sync-lirafrt-google-ads-transparency-intelligence", "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": [ "query" ], "properties": { "query": { "title": "Advertiser, domain, or ID", "minLength": 2, "maxLength": 253, "type": "string", "description": "A website domain (recommended), advertiser name, or advertiser ID beginning with AR." }, "queryType": { "title": "Query type", "enum": [ "auto", "domain", "advertiserId", "name" ], "type": "string", "description": "Auto detects domains and AR advertiser IDs. Select a type only when detection is ambiguous.", "default": "auto" }, "region": { "title": "Ad region", "pattern": "^(anywhere|[A-Z]{2})$", "type": "string", "description": "Two-letter country code, or 'anywhere' for global results.", "default": "US" }, "maxAds": { "title": "Maximum ads", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum unique ad records to write. Lower values finish faster and cost less.", "default": 100 }, "maxAdvertisers": { "title": "Maximum advertisers", "minimum": 1, "maximum": 10, "type": "integer", "description": "For name searches, inspect this many best-matching advertiser profiles.", "default": 3 }, "dateFrom": { "title": "Shown on or after", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Optional inclusive start date in UTC." }, "dateTo": { "title": "Shown on or before", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Optional inclusive end date in UTC." }, "includeCreativeDetails": { "title": "Decode creative details", "type": "boolean", "description": "Fetch creative variations and decode observable headline, description, display URL, and media URLs.", "default": true }, "maxVariationsPerAd": { "title": "Variations per ad", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum creative variations inspected for each ad.", "default": 3 }, "includeLandingPageAudit": { "title": "Audit landing pages", "type": "boolean", "description": "Optionally inspect public landing pages for deterministic conversion and technical signals. No LLM is used.", "default": false }, "maxLandingPages": { "title": "Maximum landing pages", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum distinct landing pages audited in one run.", "default": 10 }, "respectRobotsTxt": { "title": "Respect robots.txt", "type": "boolean", "description": "Skip a landing page when its public robots.txt disallows this Actor.", "default": true }, "maxRequestsPerMinute": { "title": "Maximum requests per minute", "minimum": 10, "maximum": 400, "type": "integer", "description": "Global pacing limit for requests to the Transparency Center.", "default": 120 }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 5, "maximum": 60, "type": "integer", "description": "Per-request timeout in seconds.", "default": 20 }, "maxRetries": { "title": "Maximum retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries for rate limits and transient source errors.", "default": 2 }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Concurrent detail and landing-page work. Pacing still applies globally.", "default": 4 }, "includeRaw": { "title": "Include provider payload", "type": "boolean", "description": "Attach the raw provider item for debugging and forward compatibility. Increases dataset size.", "default": false } } }, "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 } } } } } } } } } } ```