{ "openapi": "3.0.1", "info": { "title": "Google Ads Competitor Tracker: Ads, Formats & Countries", "description": "See how many Google ads your competitors run, in which countries and formats, which ads they keep running, what they launched this month and who else advertises with their name. From Google's Ads Transparency Center; no login.", "version": "0.1", "x-build-id": "plB5UclJ5oxEwvtA1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/precious_bathmat~google-ads-competitor-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-precious_bathmat-google-ads-competitor-tracker", "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/precious_bathmat~google-ads-competitor-tracker/runs": { "post": { "operationId": "runs-sync-precious_bathmat-google-ads-competitor-tracker", "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/precious_bathmat~google-ads-competitor-tracker/run-sync": { "post": { "operationId": "run-sync-precious_bathmat-google-ads-competitor-tracker", "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": [ "competitors" ], "properties": { "competitors": { "title": "Competitors", "type": "array", "description": "Each competitor's website domain, one per line (hubspot.com). A company name or a Google advertiser ID (AR...) also works; domains are the most reliable.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "ANYWHERE", "US", "GB", "CA", "AU", "NZ", "IE", "DE", "FR", "ES", "IT", "NL", "BE", "CH", "AT", "SE", "DK", "NO", "FI", "PL", "PT", "TR", "IL", "AE", "SA", "EG", "ZA", "NG", "KE", "IN", "PK", "SG", "MY", "ID", "PH", "TH", "VN", "JP", "KR", "HK", "TW", "BR", "MX", "AR", "CL", "CO" ], "type": "string", "description": "Where to look at their ads. The ad count, format split and ad list are for this country.", "default": "US" }, "maxAdsPerCompetitor": { "title": "Ads to read per competitor", "minimum": 0, "maximum": 2000, "type": "integer", "description": "How many of each competitor's most recent ads to read for the ad list, advertisers and activity. Totals by country and format are counted by Google and do not depend on this. 0 gives counts only.", "default": 200 }, "compareCountries": { "title": "Compare ad counts across these countries", "type": "array", "description": "Adds how many ads each competitor runs in each of these countries. Free.", "items": { "type": "string", "enum": [ "US", "GB", "CA", "AU", "NZ", "IE", "DE", "FR", "ES", "IT", "NL", "BE", "CH", "AT", "SE", "DK", "NO", "FI", "PL", "PT", "TR", "IL", "AE", "SA", "EG", "ZA", "NG", "KE", "IN", "PK", "SG", "MY", "ID", "PH", "TH", "VN", "JP", "KR", "HK", "TW", "BR", "MX", "AR", "CL", "CO" ], "enumTitles": [ "United States", "United Kingdom", "Canada", "Australia", "New Zealand", "Ireland", "Germany", "France", "Spain", "Italy", "Netherlands", "Belgium", "Switzerland", "Austria", "Sweden", "Denmark", "Norway", "Finland", "Poland", "Portugal", "Turkey", "Israel", "United Arab Emirates", "Saudi Arabia", "Egypt", "South Africa", "Nigeria", "Kenya", "India", "Pakistan", "Singapore", "Malaysia", "Indonesia", "Philippines", "Thailand", "Vietnam", "Japan", "South Korea", "Hong Kong", "Taiwan", "Brazil", "Mexico", "Argentina", "Chile", "Colombia" ] }, "default": [ "US", "GB", "CA", "AU", "DE", "FR", "IN", "BR" ] }, "includeAds": { "title": "Also return every ad as a row", "type": "boolean", "description": "A second table with every ad read: advertiser, format, first and last shown, days shown, preview image and a link to the ad on Google. Charged per ad; turn it off to pay for the reports only.", "default": 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 } } } } } } } } } }