{ "openapi": "3.0.1", "info": { "title": "Google Ad Transparency Scraper", "description": "Scrape public ad creative records from Google's Ads Transparency Center and return advertiser details, format, first and last shown dates, and available media URLs. Search by advertiser ID, name, or domain, filter by region and format, and optionally request numeric region details for each creative.", "version": "0.1", "x-build-id": "nYvuzD9PEmYYUdIpT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiomworks~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiomworks-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/axiomworks~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-axiomworks-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/axiomworks~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-axiomworks-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": { "advertiserIds": { "title": "Advertiser IDs or page URLs", "type": "array", "description": "Google advertiser IDs starting with AR, or advertiser page URLs from adstransparency.google.com, e.g. [\"AR16735076323512287233\"]. Most precise target. Provide at least one of advertiserIds, searchTerms or domains; they can be combined.", "items": { "type": "string" } }, "searchTerms": { "title": "Advertiser names", "type": "array", "description": "Advertiser names to look up, e.g. [\"Nike\"]. Each name resolves to the closest advertiser via Google suggestions (exact name match preferred), so check advertiserName in results; use advertiserIds when precision matters.", "items": { "type": "string" } }, "domains": { "title": "Advertiser domains", "type": "array", "description": "Website domains to find ads for, e.g. [\"nike.com\"]. Bare domain without https:// or paths. Returns ads whose creatives match that domain.", "items": { "type": "string" } }, "region": { "title": "Region (country code)", "type": "string", "description": "Two-letter ISO country code the ads were shown in, e.g. \"US\", \"GB\", \"DE\", \"FR\", \"JP\", \"BR\", or \"anywhere\" for no country filter. Default \"US\". Unsupported codes fail the run immediately.", "default": "US" }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only return this ad format: \"all\" (default), \"text\", \"image\" or \"video\". Filtered after fetching, so a rare format scans more pages.", "default": "all" }, "shownFrom": { "title": "Shown from (date)", "type": "string", "description": "Only ads still running on or after this date, format YYYY-MM-DD, e.g. \"2025-01-01\". Filtered after fetching, so narrow ranges scan more pages. Leave empty for no limit." }, "shownTo": { "title": "Shown until (date)", "type": "string", "description": "Only ads first shown on or before this date, format YYYY-MM-DD, e.g. \"2025-06-30\". Leave empty for no limit." }, "maxItems": { "title": "Maximum items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of unique ads to return across all targets, integer 1-10000, e.g. 20. Default 50.", "default": 50 }, "includeDetails": { "title": "Include details", "type": "boolean", "description": "true to make one extra request per ad and fill regions (numeric codes) and regionCodes (ISO countries where it ran), e.g. [\"US\",\"CA\"]. Slower. Default false.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings, e.g. {\"useApifyProxy\": true}. Keep enabled: Google rate limits direct requests. Default datacenter proxy.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }