# Google Ads Transparency Competitor Ad Intelligence (`nexgendata/google-ads-transparency-intelligence`) Actor Scrape Google's public Ads Transparency Center for any advertiser, brand or domain. Extract every ad creative across Search, Display and YouTube: format, first/last shown dates, regions, impression ranges, preview and destination URLs. No login. Lean residential-proxy browser. - **URL**: https://apify.com/nexgendata/google-ads-transparency-intelligence.md - **Developed by:** [NexGenData](https://apify.com/nexgendata) (community) - **Categories:** Marketing, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $40.00 / 1,000 advertiser 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 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 Competitor Ad Intelligence A focused utility for developers and agents. ### ๐Ÿ“Š What you get Clean JSON output (6 fields): - `status` โ€” Status - `message` โ€” Message - `page_url` โ€” Page url - `page_title` โ€” Page title - `has_acx` โ€” Has acx - `region_queried` โ€” Region queried **Pricing:** Pay-Per-Event; see the Pricing tab. ### ๐Ÿค– Use with AI agents Point Claude, the OpenAI Agents SDK, an n8n flow or any MCP-aware client at it. **Sample agent prompt:** ```` Run Google Ads Transparency Competitor Ad Intelligence on my input and return the structured results. ```` **Agentic payments (x402):** Supports agentic payment via x402 โ€” call this actor with USDC, no API key required. ### ๐Ÿ”— Related tools โ€” Ad & traffic intelligence [Facebook Ads Library](https://apify.com/nexgendata/facebook-ads-library-scraper) ยท [Meta Ad Intelligence](https://apify.com/nexgendata/meta-ad-library-intelligence) ยท [Competitor Ad Monitor](https://apify.com/nexgendata/competitor-ad-change-monitor) ยท [Similarweb Traffic](https://apify.com/nexgendata/similarweb-traffic-intelligence) *This actor is currently private โ€” treated and ready for review.* --- *A NexGenData utility actor.* # Actor input Schema ## `advertiserNames` (type: `array`): Brand or advertiser names to look up (e.g. "Nike", "Adidas"). Each is resolved to its verified advertiser ID via the Transparency Center, then all of that advertiser's ads are scraped. ## `domains` (type: `array`): Advertiser web domains to search by (e.g. "nike.com"). Returns ads whose verified destination domain matches. ## `advertiserIds` (type: `array`): Exact Transparency Center advertiser IDs (start with "AR..."). Use when you already know the ID and want to skip name resolution. ## `region` (type: `string`): Two-letter region/country code to scope ad disclosure (e.g. US, GB, CA, DE, FR, AU). Use "anywhere" for all regions. ## `maxAds` (type: `integer`): Maximum number of ad creatives to return across all advertisers/domains. Server-clamped to a hard ceiling of 1000 to keep compute bounded. ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxy is REQUIRED โ€” the Transparency Center serves a CAPTCHA to datacenter IPs. ## `notionConnector` (type: `string`): Optional Apify MCP Notion connector ID. If set, a summary page of the captured ads is created in your Notion workspace. ## `notionParentId` (type: `string`): Optional Notion parent page ID under which to create the summary page. ## `supabaseConnector` (type: `string`): Optional. Connect your own Supabase project and the results are also inserted into a table in the same run โ€” the Actor never sees your Supabase credentials. Authorize a write-scoped, project-scoped Supabase MCP connector in Apify Console (Settings -> Integrations), then select it here. ## `supabaseTable` (type: `string`): Target table in the public schema (created if missing, with id, a jsonb data column, and a scraped_at timestamp). Default: nexgendata_leads. ## `supabaseProjectId` (type: `string`): Your Supabase project reference (e.g. abcdefghijklmnop). Required unless your connector URL is already project-scoped. Find it in your project URL: supabase.com/dashboard/project/THIS_PART. ## `deliveryDedup` (type: `boolean`): When on (default), records already delivered in a previous run are not delivered again to the same destination โ€” so scheduled runs only push new items. Turn off to deliver every record on every run. ## Actor input object example ```json { "advertiserNames": [ "Nike", "Adidas" ], "domains": [ "nike.com" ], "advertiserIds": [ "AR16735076323512287233" ], "region": "US", "maxAds": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "supabaseTable": "nexgendata_leads", "deliveryDedup": true } ```` # 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 = { "advertiserNames": [ "Nike" ], "region": "US", "maxAds": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("nexgendata/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 = { "advertiserNames": ["Nike"], "region": "US", "maxAds": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("nexgendata/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 '{ "advertiserNames": [ "Nike" ], "region": "US", "maxAds": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call nexgendata/google-ads-transparency-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nexgendata/google-ads-transparency-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Competitor Ad Intelligence", "description": "Scrape Google's public Ads Transparency Center for any advertiser, brand or domain. Extract every ad creative across Search, Display and YouTube: format, first/last shown dates, regions, impression ranges, preview and destination URLs. No login. Lean residential-proxy browser.", "version": "0.0", "x-build-id": "CvkPUi1RL3oaeJeY5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~google-ads-transparency-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-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/nexgendata~google-ads-transparency-intelligence/runs": { "post": { "operationId": "runs-sync-nexgendata-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/nexgendata~google-ads-transparency-intelligence/run-sync": { "post": { "operationId": "run-sync-nexgendata-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", "properties": { "advertiserNames": { "title": "Advertiser / brand names", "type": "array", "description": "Brand or advertiser names to look up (e.g. \"Nike\", \"Adidas\"). Each is resolved to its verified advertiser ID via the Transparency Center, then all of that advertiser's ads are scraped.", "items": { "type": "string" } }, "domains": { "title": "Advertiser domains", "type": "array", "description": "Advertiser web domains to search by (e.g. \"nike.com\"). Returns ads whose verified destination domain matches.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Exact Transparency Center advertiser IDs (start with \"AR...\"). Use when you already know the ID and want to skip name resolution.", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Two-letter region/country code to scope ad disclosure (e.g. US, GB, CA, DE, FR, AU). Use \"anywhere\" for all regions.", "default": "US" }, "maxAds": { "title": "Max ads (hard cap)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of ad creatives to return across all advertisers/domains. Server-clamped to a hard ceiling of 1000 to keep compute bounded.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Residential proxy is REQUIRED โ€” the Transparency Center serves a CAPTCHA to datacenter IPs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "notionConnector": { "title": "Notion connector ID (optional)", "type": "string", "description": "Optional Apify MCP Notion connector ID. If set, a summary page of the captured ads is created in your Notion workspace." }, "notionParentId": { "title": "Notion parent page ID (optional)", "type": "string", "description": "Optional Notion parent page ID under which to create the summary page." }, "supabaseConnector": { "title": "Deliver to Supabase (optional)", "type": "string", "description": "Optional. Connect your own Supabase project and the results are also inserted into a table in the same run โ€” the Actor never sees your Supabase credentials. Authorize a write-scoped, project-scoped Supabase MCP connector in Apify Console (Settings -> Integrations), then select it here." }, "supabaseTable": { "title": "Supabase table name (optional)", "type": "string", "description": "Target table in the public schema (created if missing, with id, a jsonb data column, and a scraped_at timestamp). Default: nexgendata_leads.", "default": "nexgendata_leads" }, "supabaseProjectId": { "title": "Supabase project ID (optional)", "type": "string", "description": "Your Supabase project reference (e.g. abcdefghijklmnop). Required unless your connector URL is already project-scoped. Find it in your project URL: supabase.com/dashboard/project/THIS_PART." }, "deliveryDedup": { "title": "Deduplicate deliveries across runs", "type": "boolean", "description": "When on (default), records already delivered in a previous run are not delivered again to the same destination โ€” so scheduled runs only push new items. Turn off to deliver every record on every run.", "default": true } } }, "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 } } } } } } } } } } ```