{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper | Ad Text, Regions, New Ads", "description": "See every ad a company runs on Google Search, YouTube, Shopping, Maps and Play. Search the Google Ads Transparency Center by website, advertiser name or ID and get ad text, images, video links, dates, regions and EU impression ranges. Monitor competitors with 'Only new ads'.", "version": "0.1", "x-build-id": "trlBClgEeUOgx1nqk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/akatra~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-akatra-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/akatra~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-akatra-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/akatra~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-akatra-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": [ "queries" ], "properties": { "queries": { "title": "Advertisers", "type": "array", "description": "One per line: a website domain (nike.com), an advertiser name (Nike, Inc.), an advertiser ID (AR16735076323512287233) or a Google Ads Transparency Center URL. A domain returns the ads of every advertiser that promotes that website.", "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "", "US", "GB", "CA", "AU", "NZ", "IE", "IN", "SG", "ZA", "PH", "NG", "KE", "DE", "AT", "CH", "FR", "BE", "NL", "LU", "ES", "IT", "PT", "PL", "SE", "NO", "DK", "FI", "IS", "TR", "GR", "CZ", "SK", "HU", "RO", "BG", "HR", "SI", "LT", "LV", "EE", "CY", "MT", "UA", "IL", "AE", "SA", "QA", "KW", "EG", "MA", "PK", "BD", "JP", "KR", "TW", "HK", "ID", "TH", "VN", "MY", "BR", "MX", "AR", "CO", "CL", "PE" ], "type": "string", "description": "Only ads shown in this country. Leave on 'Anywhere' for all regions.", "default": "" }, "format": { "title": "Ad format", "enum": [ "", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "" }, "platform": { "title": "Platform", "enum": [ "", "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "type": "string", "description": "Only ads shown on this Google platform.", "default": "" }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Optional. Only ads shown on or after this date." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Optional. Only ads shown on or before this date." }, "maxItemsPerQuery": { "title": "Max ads per advertiser", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many ads for each line in 'Advertisers'. The most recently shown ads come first.", "default": 100 }, "includeDetails": { "title": "Include regions and variations", "type": "boolean", "description": "Open each ad to add the list of regions with first and last shown dates, impression ranges where Google publishes them (mainly the EU), the advertiser's legal name and all variations of the ad. Turn off for a faster run with the basic fields only.", "default": true }, "includeAdText": { "title": "Include ad text and video link", "type": "boolean", "description": "Read the ad's visible text (headline, description, displayed URL) and, for video ads, the YouTube link. Needs 'Include regions and variations'.", "default": true }, "onlyNew": { "title": "Only new ads", "type": "boolean", "description": "The first run is your baseline. Later runs with the same advertiser and filters return only ads that started running since your previous run. Ideal for a daily or weekly competitor watch.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is recommended. The scraper spreads requests over several IPs automatically.", "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 } } } } } } } } } }