{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper | Bulk Ads", "description": "Compare public Google ad creatives across advertisers and countries. Export deduplicated creative records, preview links, and available timing and impression ranges. Build competitor research datasets from domains or advertiser IDs, with optional creative details.", "version": "0.2", "x-build-id": "L5qxjFYGAQVsZ8Bpl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtech~google-ad-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtech-google-ad-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/xtech~google-ad-transparency-scraper/runs": { "post": { "operationId": "runs-sync-xtech-google-ad-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/xtech~google-ad-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-xtech-google-ad-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": { "targets": { "title": "Advertiser IDs, domains, or Transparency Center URLs", "minItems": 1, "maxItems": 100, "type": "array", "description": "Required. Add up to 100 targets. Use an advertiser ID starting with AR, a domain such as example.com, or a public Google Ads Transparency Center advertiser or search URL.", "items": { "type": "string", "minLength": 1 } }, "regions": { "title": "Countries", "minItems": 1, "maxItems": 15, "type": "array", "description": "Choose one or more markets using ISO country codes. The default is US.", "items": { "type": "string", "enum": [ "AU", "BR", "CA", "DE", "ES", "FR", "GB", "IN", "IT", "JP", "MX", "NL", "PL", "SE", "US" ], "enumTitles": [ "Australia", "Brazil", "Canada", "Germany", "Spain", "France", "United Kingdom", "India", "Italy", "Japan", "Mexico", "Netherlands", "Poland", "Sweden", "United States" ] }, "default": [ "US" ] }, "surfaces": { "title": "Google surfaces", "minItems": 1, "maxItems": 3, "type": "array", "description": "Use ALL for broad coverage, or limit results to Google Search or YouTube.", "items": { "type": "string", "enum": [ "ALL", "SEARCH", "YOUTUBE" ], "enumTitles": [ "All Google surfaces", "Google Search", "YouTube" ] }, "default": [ "ALL" ] }, "maxCreativesPerTarget": { "title": "Maximum creatives per target", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum distinct creatives to collect for each target. The form starts with five for a quick sample; increase it when you need broader coverage.", "default": 100 }, "includeCreativeDetails": { "title": "Include available creative details", "type": "boolean", "description": "Include public preview links, impression ranges, dates, and high-level targeting indicators when Google makes them available.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Choose a proxy configuration for consistent access to public records. Leave empty to connect directly." }, "searchInputs": { "title": "Legacy search inputs", "type": "array", "description": "Compatibility field for existing integrations. Use targets for new runs.", "items": { "type": "string" } }, "maxPages": { "title": "Legacy maximum pages", "minimum": 1, "type": "integer", "description": "Compatibility field for existing integrations. Use maxCreativesPerTarget for new runs." } } }, "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 } } } } } } } } } }