{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper 🔍 (competitor ad spy)", "description": "Every ad a competitor runs on Google, YouTube, Shopping, Maps and Play: creative, format, first and last seen, days shown, and the verified legal entity paying. Search by brand, advertiser ID or landing domain. The ad-history slice a SpyFu or Adbeat seat sells, priced per ad.", "version": "0.1", "x-build-id": "bkFyp32u6SMGtAI5H" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tagadanar~ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tagadanar-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/tagadanar~ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-tagadanar-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/tagadanar~ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-tagadanar-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": { "advertisers": { "title": "Advertisers", "type": "array", "description": "Brand names (\"Nike\"), Transparency Center advertiser IDs (\"AR16735076323512287233\") or advertiser page URLs. A brand name is resolved to the verified advertiser behind it before its ads are pulled.", "items": { "type": "string" } }, "domains": { "title": "Landing domains", "type": "array", "description": "Find every ad pointing at a website, across every advertiser buying it (the brand itself, its agencies, its resellers). One domain per line, e.g. nike.com.", "items": { "type": "string" } }, "region": { "title": "Country the ads ran in", "enum": [ "ANY", "DZ", "AO", "AR", "AU", "AT", "BH", "BD", "BE", "BO", "BW", "BR", "BG", "KH", "CM", "CA", "CL", "CO", "CR", "HR", "CY", "CZ", "DK", "DO", "EC", "EG", "EE", "FI", "FR", "DE", "GH", "GR", "GT", "HK", "HU", "IS", "IN", "ID", "IQ", "IE", "IL", "IT", "CI", "JP", "JO", "KZ", "KE", "KW", "LV", "LB", "LT", "LU", "MY", "MT", "MU", "MX", "MN", "MA", "MZ", "MM", "NA", "NP", "NL", "NZ", "NG", "NO", "OM", "PK", "PA", "PY", "PE", "PH", "PL", "PT", "PR", "QA", "RO", "SA", "SN", "RS", "SG", "SK", "SI", "ZA", "KR", "ES", "LK", "SE", "CH", "TW", "TZ", "TH", "TN", "TR", "UG", "UA", "AE", "GB", "US", "UY", "VE", "VN", "ZM", "ZW" ], "type": "string", "description": "Only ads shown in this country. Leave on \"Any country\" to see an advertiser’s worldwide activity.", "default": "US" }, "adFormat": { "title": "Ad format", "enum": [ "any", "text", "image", "video" ], "type": "string", "description": "Text ads are the search ads, image ads are display and Demand Gen, video ads are the YouTube ones.", "default": "any" }, "platform": { "title": "Where the ad ran", "enum": [ "any", "google_search", "youtube", "google_shopping", "google_maps", "google_play" ], "type": "string", "description": "Restrict to one Google surface.", "default": "any" }, "shownAfter": { "title": "Shown on or after", "type": "string", "description": "YYYY-MM-DD. Only ads that ran on or after this date." }, "shownBefore": { "title": "Shown on or before", "type": "string", "description": "YYYY-MM-DD. Only ads that ran on or before this date." }, "maxResults": { "title": "Maximum ads", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many ad creatives. Big advertisers run thousands of them, so this is what keeps a run predictable.", "default": 500 }, "fetchCreativeDetails": { "title": "Add every country and every variation", "type": "boolean", "description": "Off by default. When on, each ad gets one extra lookup returning the full list of countries it ran in with a last-seen date per country, plus every creative variation. Billed only for ads that actually come back with details.", "default": false }, "allMatchingAdvertisers": { "title": "Every advertiser matching the name", "type": "boolean", "description": "By default a brand name resolves to the single biggest advertiser using it. Turn this on to pull all of them, which is what you want for brands that advertise through regional entities or agencies.", "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 } } }, "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 } } } } } } } } } }