{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper & Competitor Ad Monitor", "description": "Scrape any advertiser's Google ads by domain or advertiser ID: text-ad headlines, descriptions and sitelinks (OCR), format, first and last shown dates. Monitor mode flags ads that started or stopped running since the last run, with webhook alerts. Pay per ad.", "version": "0.1", "x-build-id": "5jilq7g0JzBAdo8Cr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yushi3~google-ads-transparency-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yushi3-google-ads-transparency-monitor", "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/yushi3~google-ads-transparency-monitor/runs": { "post": { "operationId": "runs-sync-yushi3-google-ads-transparency-monitor", "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/yushi3~google-ads-transparency-monitor/run-sync": { "post": { "operationId": "run-sync-yushi3-google-ads-transparency-monitor", "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": [ "advertisers" ], "properties": { "advertisers": { "title": "Advertisers", "type": "array", "description": "Competitors to track: a website domain (nike.com), a website URL, a Google advertiser ID (AR16735076323512287233) or an Ads Transparency Center link (https://adstransparency.google.com/advertiser/AR16735076323512287233?region=US). A domain returns every advertiser account that runs ads for it.", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Only ads shown in this country: a two-letter code such as US, GB or DE. Leave as \"anywhere\" for ads shown in any country. A region in an Ads Transparency Center link takes priority.", "default": "anywhere" }, "adFormat": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only return ads of this format.", "default": "all" }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many ads for each advertiser, most recently shown first.", "default": 50 }, "extractAdText": { "title": "Read ad content", "type": "boolean", "description": "Google shows search (text) ads only as images: when on, their headline, description, display URL and sitelinks are read with OCR in any of 50 languages. Shopping ads get the product title, merchant and image; video ads the YouTube link; image ads the creative's image URL. Each ad is read once and remembered for later runs. Included in the per-ad price.", "default": true }, "onlyChanges": { "title": "Only new and stopped ads", "type": "boolean", "description": "Return (and charge for) only ads that started running, or stopped running, since the previous run of this actor for the same advertiser. The first run returns everything and becomes the baseline. Turn on for scheduled competitor monitoring.", "default": false }, "alertWebhookUrl": { "title": "Alert webhook URL", "type": "string", "description": "Optional. Receives a POST for each ad that started or stopped running since the previous run (Slack, Zapier, Make or n8n webhooks work)." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. By default the Transparency Center is fetched directly and only falls back to Apify datacenter, then residential proxies when Google rate-limits the run. Set a proxy here to use it for every request instead." } } }, "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 } } } } } } } } } }