{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper – Monitor New Competitor Ads", "description": "Google Ads Transparency scraper that monitors competitor ads by domain or advertiser ID: returns new creatives with format, first/last shown dates, ad URL and preview. Export JSON, CSV, Excel. From $0.40 per 1,000 results.", "version": "0.1", "x-build-id": "rc2npkM3N9SDZwxv1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/leadsbrary~google-ads-transparency-advertiser-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-leadsbrary-google-ads-transparency-advertiser-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/leadsbrary~google-ads-transparency-advertiser-monitor/runs": { "post": { "operationId": "runs-sync-leadsbrary-google-ads-transparency-advertiser-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/leadsbrary~google-ads-transparency-advertiser-monitor/run-sync": { "post": { "operationId": "run-sync-leadsbrary-google-ads-transparency-advertiser-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", "properties": { "domains": { "title": "Advertiser domains", "type": "array", "description": "Competitor website domains (e.g. nike.com). Protocol, www and path are stripped. Provide domains and/or advertiser IDs.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs or URLs", "type": "array", "description": "Google advertiser IDs (AR…) or full Transparency Center advertiser page URLs.", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "\"anywhere\" or an ISO 3166-1 alpha-2 country code (US, GB, DE, FR, ES, IT, NL, CA, AU, BR, IN, JP, MX, PL, SE, TR, ZA, AR, BE, CH, AT, IE, PT, DK, NO, FI, NZ, SG, KR, CZ, RO, GR, CO, CL, ID, PH, TH, AE, SA, IL, NG, EG, UA, HU).", "default": "anywhere" }, "formats": { "title": "Ad formats", "type": "array", "description": "Only these ad formats. Empty = all formats.", "items": { "type": "string", "enum": [ "TEXT", "IMAGE", "VIDEO" ] } }, "dateFrom": { "title": "Shown on or after", "type": "string", "description": "YYYY-MM-DD or relative like \"30 days\". Empty = no lower bound." }, "dateTo": { "title": "Shown on or before", "type": "string", "description": "YYYY-MM-DD or relative like \"7 days\". Empty = no upper bound." }, "onlyNewAds": { "title": "Only new ads (monitor mode)", "type": "boolean", "description": "Return (and bill) only creatives not seen in previous runs with the same monitor name. The first run returns everything it finds. Disable for a plain snapshot export.", "default": true }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Name of the remembered state (key-value store gatm-). Lowercase letters, digits, dashes. Use different names for different competitor lists.", "default": "default" }, "resetMonitor": { "title": "Reset monitor", "type": "boolean", "description": "Forget previously seen ads before this run (re-baseline).", "default": false }, "includeCreativeDetails": { "title": "Include creative details", "type": "boolean", "description": "One extra request per ad to add the countries where it was shown and the creative asset URL. Slower.", "default": false }, "maxResultsPerAdvertiser": { "title": "Max ads scanned per advertiser", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cap on creatives scanned per domain / advertiser, newest first.", "default": 100 }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many delivered ads (also caps your spending).", "default": 200 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter proxy is enough and recommended.", "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 } } } } } } } } } }