{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper – Bulk Advertiser & Ads Check", "description": "Check a list of companies against the Google Ads Transparency Center: is each one advertising, about how many ads, who runs them, when last shown, which formats and countries. Or export every ad of a competitor — with a monitoring mode that returns only new ads. No login, no proxy.", "version": "0.1", "x-build-id": "wNgtsZr4EZixgHiUj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/perceptr0n~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-perceptr0n-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/perceptr0n~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-perceptr0n-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/perceptr0n~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-perceptr0n-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", "properties": { "mode": { "title": "What to do", "enum": [ "companies", "ads" ], "type": "string", "description": "**Check companies**: one row per company — is it advertising on Google, roughly how many ads, who runs them, when last shown, which formats. **Export ads**: one row per ad with format, first and last shown date, preview image and link.", "default": "companies" }, "domains": { "title": "Company websites (domains)", "type": "array", "description": "Domains or website addresses, e.g. `check24.de`, `https://www.otto.de`. The Transparency Center is searched for ads that point to this domain — including ads by resellers or agencies that link to it.", "items": { "type": "string" } }, "company_names": { "title": "Company names", "type": "array", "description": "Verified advertiser names, e.g. `Zalando`, `HORNBACH`. Every word must appear in the advertiser's legal name as Google lists it. For small businesses the domain is usually more reliable.", "items": { "type": "string" } }, "advertiser_ids": { "title": "Advertiser IDs (export ads)", "type": "array", "description": "Google advertiser IDs such as `AR15589870916631265281` — from a previous run or from the Transparency Center URL.", "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "anywhere", "DE", "AT", "CH", "FR", "NL", "BE", "LU", "IT", "ES", "PT", "PL", "CZ", "SK", "HU", "RO", "BG", "HR", "SI", "GR", "IE", "DK", "SE", "FI", "NO", "EE", "LV", "LT", "GB", "US", "CA", "AU", "TR", "IN", "BR", "MX", "JP" ], "type": "string", "description": "Only count and export ads shown in this country. 'Anywhere' covers all regions.", "default": "anywhere" }, "region_breakdown": { "title": "Ad counts per country (check companies)", "type": "array", "description": "Optional: two-letter country codes, e.g. `DE`, `AT`, `CH`. Each advertising company gets its ad count per country — one extra lookup per country, up to 10.", "items": { "type": "string" } }, "max_ads": { "title": "Maximum ads per company (export ads)", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many ads per domain, name or advertiser ID. Large advertisers run hundreds of thousands of ads; the newest come first.", "default": 40 }, "include_details": { "title": "Countries per ad (export ads)", "type": "boolean", "description": "Adds, for every ad, the countries it ran in with first and last day shown there. One extra lookup per ad, charged as 'ad details'.", "default": false }, "only_new_ads": { "title": "Only new ads — monitoring (export ads)", "type": "boolean", "description": "Remembers which ads were already delivered for the same domain, name or advertiser ID and returns only ads you have not seen before. Schedule the run daily or weekly to get a feed of new competitor ads. The memory is kept in a key-value store named `google-ads-transparency-monitor` in your account.", "default": false }, "proxy": { "title": "Proxy", "type": "object", "description": "Not needed — the Transparency Center answers Apify's data centres directly (measured). Switch on Apify Proxy only if you see repeated errors.", "default": { "useApifyProxy": 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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }