{ "openapi": "3.0.1", "info": { "title": "Product Price Tracker & Comparison by Country", "description": "Track a product's price, currency and stock in every country you pick and compare them side by side in one currency. Fetched through real home (residential) internet connections in each country, with proof of location. Works on Shopify, WooCommerce and most stores. Pay only for prices found.", "version": "0.1", "x-build-id": "veFAygCqvNXSbi575" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zaiq~product-prices-by-country/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zaiq-product-prices-by-country", "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/zaiq~product-prices-by-country/runs": { "post": { "operationId": "runs-sync-zaiq-product-prices-by-country", "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/zaiq~product-prices-by-country/run-sync": { "post": { "operationId": "run-sync-zaiq-product-prices-by-country", "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": [ "products", "countries" ], "properties": { "products": { "title": "Product pages", "type": "array", "description": "Product page URLs. Each one is checked from every country below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "countries": { "title": "Countries", "minItems": 1, "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Pick countries, or type any two-letter country code.", "items": { "type": "string", "enumSuggestedValues": [ "us", "gb", "de", "fr", "ca", "au", "in", "br", "mx", "es", "it", "nl", "se", "pl", "ch", "at", "be", "ie", "pt", "dk", "no", "fi", "cz", "ro", "gr", "hu", "tr", "ua", "il", "ae", "sa", "eg", "za", "ng", "ke", "jp", "kr", "tw", "hk", "sg", "my", "id", "ph", "th", "vn", "pk", "ar", "cl", "co", "nz" ], "enumTitles": [ "United States (US)", "United Kingdom (GB)", "Germany (DE)", "France (FR)", "Canada (CA)", "Australia (AU)", "India (IN)", "Brazil (BR)", "Mexico (MX)", "Spain (ES)", "Italy (IT)", "Netherlands (NL)", "Sweden (SE)", "Poland (PL)", "Switzerland (CH)", "Austria (AT)", "Belgium (BE)", "Ireland (IE)", "Portugal (PT)", "Denmark (DK)", "Norway (NO)", "Finland (FI)", "Czechia (CZ)", "Romania (RO)", "Greece (GR)", "Hungary (HU)", "Turkey (TR)", "Ukraine (UA)", "Israel (IL)", "United Arab Emirates (AE)", "Saudi Arabia (SA)", "Egypt (EG)", "South Africa (ZA)", "Nigeria (NG)", "Kenya (KE)", "Japan (JP)", "South Korea (KR)", "Taiwan (TW)", "Hong Kong (HK)", "Singapore (SG)", "Malaysia (MY)", "Indonesia (ID)", "Philippines (PH)", "Thailand (TH)", "Vietnam (VN)", "Pakistan (PK)", "Argentina (AR)", "Chile (CL)", "Colombia (CO)", "New Zealand (NZ)" ] } }, "convertTo": { "title": "Compare in currency", "type": "string", "description": "Every price is also converted to this currency (ISO code, for example USD, EUR, GBP, ZAR) with the day's reference rate, so countries can be compared.", "default": "USD" }, "render": { "title": "Browser", "enum": [ "auto", "never", "always" ], "type": "string", "description": "Most shops put the price in the page itself. Some only show it after JavaScript runs; for those a real browser is used, at the browser price.", "default": "auto" }, "screenshot": { "title": "Screenshot as evidence", "type": "boolean", "description": "Save a screenshot of each product page from each country (always uses the browser). The row links to it.", "default": false }, "maxTriesPerPage": { "title": "Addresses to try per page", "minimum": 1, "maximum": 8, "type": "integer", "description": "If an address lands outside the country, fails or meets a bot wall, a new address is tried, up to this many. Failed tries are free.", "default": 4 }, "maxConcurrency": { "title": "Pages at once", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many pages are checked at the same time.", "default": 10 }, "acceptLanguage": { "title": "Accept-Language header", "type": "string", "description": "Leave empty to send each country's usual browser language. Set it to force one language everywhere." } } }, "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 } } } } } } } } } }