{ "openapi": "3.0.1", "info": { "title": "Product Price Checker - Cheapest Price Across Stores", "description": "Finds the cheapest offer for a product across any online stores. Reads real prices from product pages (JSON-LD, Shopify, meta tags), converts currencies and sorts offers from cheapest to most expensive.", "version": "0.1", "x-build-id": "iR5zalAoa5z9ChYQM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/martin10291~cheapest-price-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-martin10291-cheapest-price-finder", "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/martin10291~cheapest-price-finder/runs": { "post": { "operationId": "runs-sync-martin10291-cheapest-price-finder", "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/martin10291~cheapest-price-finder/run-sync": { "post": { "operationId": "run-sync-martin10291-cheapest-price-finder", "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": { "productUrls": { "title": "Product page URLs (any stores)", "type": "array", "description": "Product pages from any online stores. The actor reads the real price from each page and sorts all offers from cheapest to most expensive.", "items": { "type": "string" } }, "searchQuery": { "title": "Or search a product name (optional)", "type": "string", "description": "Product name or model, e.g. 'Sony WH-1000XM5'. Product pages are searched in the stores below." }, "stores": { "title": "Stores to search", "type": "array", "description": "Store domains for the search, e.g. bestbuy.com, newegg.com, ebay.com. Empty = amazon.com, walmart.com, bestbuy.com, target.com, ebay.com, newegg.com.", "items": { "type": "string" } }, "resultsPerStore": { "title": "Product pages per store", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many search results to check in each store.", "default": 3 }, "convertTo": { "title": "Compare in currency", "type": "string", "description": "All prices are also converted to this currency with official ECB rates (USD, EUR, GBP, ...).", "default": "USD" }, "onlyInStock": { "title": "Only in-stock offers", "type": "boolean", "description": "Skip offers marked out of stock.", "default": false }, "maxItems": { "title": "Max offers", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard limit on saved offers (and cost).", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Off by default: direct requests with an honest User-Agent work best (Apify proxy IPs are often rate-limited by Shopify stores, HTTP 429). Turn it on only for a store that blocks direct requests.", "default": { "useApifyProxy": false } }, "datasetId": { "title": "Dataset (integration input)", "type": "string", "description": "Optional. Pick a dataset (or paste its ID) to read the input from, for example the result of Google Maps Scraper. When this actor runs as an integration, the dataset of the triggering run is used automatically (payload.resource.defaultDatasetId), so you can leave this empty. If set, the values found in the dataset replace the main input list." }, "datasetField": { "title": "Dataset field", "type": "string", "description": "Optional. The item field that holds the value, for example website, url or videoUrl (dot paths like author.url work). Empty = detected automatically." }, "datasetMaxItems": { "title": "Max values from the dataset", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper limit of unique values taken from the dataset, to keep the cost under control.", "default": 1000 } } }, "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 } } } } } } } } } }