{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper - New Competitor Ads Monitor", "description": "For marketers and agencies watching competitors: only the Google Ads Transparency Center ads that are new since your last run, by domain or advertiser ID, with image URL, first/last shown, countries and who paid. On nike.com a rerun returned 0 of 57 older ads as new (2026-09-24).", "version": "0.1", "x-build-id": "2s2xDaMVDVUAJ3ZXU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-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/neverempty~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-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/neverempty~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-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": { "targets": { "title": "Domains or advertiser IDs", "type": "array", "description": "Advertisers to watch, one per line (up to 50): a website domain (nike.com), an advertiser ID from the Ads Transparency Center (AR18378488041124659201), or an Ads Transparency Center link (https://adstransparency.google.com/advertiser/AR…). The first run for a target returns its newest ads; every later run returns only ads first shown after the watch started that it has not returned before. Empty = nike.com.", "items": { "type": "string" } }, "region": { "title": "Region (country code)", "type": "string", "description": "Only ads shown in this country: a two-letter code such as US, GB, DE or JP. Empty or \"anywhere\" = every region. Google applies this filter itself (for example Nike Retail BV: about 80,000 ads anywhere, 19 in Japan). A different region is a separate watch." }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only ads of this format, filtered by Google. Empty = all formats. A different format is a separate watch." }, "maxAdsFirstRun": { "title": "Ads to return on the first check", "minimum": 0, "maximum": 1000, "type": "integer", "description": "The first time a target is checked, return this many of its ads, newest first shown first, and only remember the rest. 0 = return none and start watching from now. Empty = 20. Later runs return every new ad found." }, "maxAdsScanned": { "title": "Ads to read per target per run", "minimum": 40, "maximum": 1000, "type": "integer", "description": "How many ads of Google's list to read for each target in each run (40 per request). Google does not list ads newest first, so a watch finds every new ad only when the whole list fits; a free row says when Google has more. Later runs read only ads shown since shortly before the previous check. Empty = 400." }, "includeAdDetails": { "title": "Add ad details", "type": "boolean", "description": "On (or empty) = for each returned ad, also read its detail page: every country it was shown in with first and last shown dates, the name of who paid for it, its topic, and the image of every variation. One extra request per returned ad; not charged separately. Off = list data only.", "default": true }, "watchName": { "title": "Watch name", "type": "string", "description": "Optional. Runs with the same watch name share what has already been returned. Give different names to two schedules that watch the same target for different purposes, so each gets every new ad. Letters, digits, dot, dash and underscore." }, "resetMonitoringState": { "title": "Reset monitoring state", "type": "boolean", "description": "Forget what this watch remembered for these targets at the start of this run, so this run is a first check again. Turn it off again for scheduled runs, or every run starts over and returns the same ads again." } } }, "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 } } } } } } } } } }