{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper & New Ads Monitor", "description": "Scrape competitors' Google ads from the Ads Transparency Center, then pay only for new ones. Text, image and video ads with their copy and dates, on a schedule.", "version": "0.1", "x-build-id": "UVsxX1hp5Jl1goVkY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/babymum7~google-ads-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-babymum7-google-ads-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/babymum7~google-ads-monitor/runs": { "post": { "operationId": "runs-sync-babymum7-google-ads-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/babymum7~google-ads-monitor/run-sync": { "post": { "operationId": "run-sync-babymum7-google-ads-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": "Who to watch. Enter a competitor's website (nike.com), an advertiser ID from the Ads Transparency Center (AR16735076323512287233), or the advertiser's page URL. One per line, as many as you like.", "items": { "type": "string" } }, "region": { "title": "Country", "type": "string", "description": "Only ads shown in this country. Pick from the list or type a code or name (US, UK, Germany). Leave it on Anywhere to see ads from every country.", "default": "anywhere" }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Limit the results to text, image or video ads. Text ads come as an image of the ad, the way Google publishes them.", "default": "all" }, "onlyNewAds": { "title": "Only new ads", "type": "boolean", "description": "On: the first run saves each advertiser's current ads, and every run after that returns only ads that started running since the previous run. Turn it on for a daily or weekly schedule. Off: every run returns all ads, each still marked new or not, and an existing baseline is left as it is.", "default": true }, "readAdText": { "title": "Read the ad text", "type": "boolean", "description": "Adds the headline, description and display URL of each text ad, and the words on image ads. Google publishes most text ads as pictures, so this reads them, which takes about half a second per ad returned (a 100-ad first run takes under a minute; later runs read only the new ads). Turn it off if you only need links and dates.", "default": true }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many ads to check per advertiser and run. After the first run only ads shown since the previous run are checked, so 200 covers most advertisers; for the largest (thousands of ads running at once) the run checks a sample and says so in its status. Raise it to check them all, or to export an advertiser's full history.", "default": 200 }, "ownAdsOnly": { "title": "Only the advertiser's own ads", "type": "boolean", "description": "For a domain, drop ads from other companies that link to it, such as agencies, resellers or partners (Nike, Inc. and Nike Retail BV stay for nike.com; an agency's ads do not). Advertiser IDs are never filtered.", "default": false }, "includeDetails": { "title": "Regions, impressions and variations", "type": "boolean", "description": "Adds the countries each ad ran in with dates, Google's impression ranges where it publishes them (EU countries), and every variation of the ad. One extra request per ad, so runs take longer.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy spreads requests across IP addresses so big runs are not rate-limited. The default works for most runs.", "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 } } } } } } } } } }