{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Ad Library & EU Reach", "description": "Google Ads Transparency Center scraper: get ads any advertiser runs on Google Search, YouTube, Shopping, Maps and Play. Search by domain, brand or advertiser ID. Format, first/last shown, days shown, previews, EU impressions, targeting and topic. $0.50 per 1,000 ads. Export CSV/JSON or use the API.", "version": "0.1", "x-build-id": "iqkB8C2W9dAufGLyh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jaaylee~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jaaylee-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/jaaylee~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-jaaylee-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/jaaylee~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-jaaylee-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": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Domains, advertiser names or IDs", "type": "array", "description": "What to look up in the Google Ads Transparency Center. Each line is a website domain (nike.com), an advertiser or brand name (Nike), an advertiser ID (AR16735076323512287233) or an Ads Transparency Center advertiser or domain URL. Names are matched to the advertiser with the most ads (see 'Advertisers per name').", "items": { "type": "string" } }, "region": { "title": "Region (country where ads were shown)", "pattern": "^([A-Za-z]{2}|[Aa]nywhere)$", "type": "string", "description": "2-letter country code such as US, GB, DE, FR, IN or AU, or 'anywhere' for all countries. EU countries (DE, FR, ES, IT, NL...) also give impressions and audience targeting when 'Include ad details' is on.", "default": "US" }, "platform": { "title": "Google platform", "enum": [ "all", "google-search", "youtube", "google-shopping", "google-maps", "google-play" ], "type": "string", "description": "Only ads shown on this Google platform.", "default": "all" }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only ads of this format (text, image or video).", "default": "all" }, "dateFrom": { "title": "Shown from (date)", "type": "string", "description": "Optional. Only ads shown on or after this date (YYYY-MM-DD). The Transparency Center supports date filtering for roughly the last 12 months." }, "dateTo": { "title": "Shown until (date)", "type": "string", "description": "Optional. Only ads shown on or before this date (YYYY-MM-DD)." }, "maxAdsPerSearch": { "title": "Max ads per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many ads for each line in 'searchTerms'. Large advertisers have tens of thousands of ads; the most recently shown ads come first.", "default": 200 }, "maxItems": { "title": "Max ads in total", "minimum": 1, "type": "integer", "description": "Optional. Stop after this many ads across all searches (useful to cap cost)." }, "includeDetails": { "title": "Include ad details (variations, regions, EU reach & targeting)", "type": "boolean", "description": "Makes one extra request per ad to add: all ad variations (A/B versions), countries where it ran with first and last dates, legal advertiser name, topic, and for EU countries the number of times shown (impressions range, also per platform) and audience selection (demographics, locations, contextual signals, customer lists, interests). Charged as 'ad with details'.", "default": false }, "maxAdvertisersPerName": { "title": "Advertisers per name", "minimum": 1, "maximum": 10, "type": "integer", "description": "When a line is a name (not a domain or ID), scrape this many matching advertisers, starting with the one that has the most ads. Only advertisers whose name contains every word you typed are used.", "default": 1 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many requests run in parallel. Pages of one search are fetched in order so positions are exact.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Primary proxy. The default Apify datacenter proxy works for the Transparency Center.", "default": { "useApifyProxy": true } }, "residentialFallback": { "title": "Retry blocked requests with residential proxy", "type": "boolean", "description": "If a request stays blocked after 3 attempts on the primary proxy, retry it up to 2 more times through US residential proxies. Blocked requests are never charged.", "default": true }, "failOnLowQuality": { "title": "Fail run on low data quality (monitoring)", "type": "boolean", "description": "For monitoring tasks: mark the run as failed when fewer than 80% of requests succeed or key fields are missing.", "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 }, "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 } } } } } } } } } }