{ "openapi": "3.0.1", "info": { "title": "Unit Price Checker for Grocery & Retail Listings", "description": "Check grocery and retail product data for unit price problems: parses sizes like 6 x 330 ml, 12 fl oz or 1.5 kg, recomputes the price per kg, litre or item, and flags missing or wrong unit prices, unit prices left on the old price, and Germany's per 1 kg / 1 l rule.", "version": "0.1", "x-build-id": "7Ph0VWqJrvDKZAKUz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ultimatemc~unit-price-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ultimatemc-unit-price-checker", "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/ultimatemc~unit-price-checker/runs": { "post": { "operationId": "runs-sync-ultimatemc-unit-price-checker", "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/ultimatemc~unit-price-checker/run-sync": { "post": { "operationId": "run-sync-ultimatemc-unit-price-checker", "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": { "products": { "title": "Products", "type": "array", "description": "Array of objects with \"title\" and \"price\", plus optional \"size\" (e.g. \"500 g\", \"6 x 330 ml\"), \"unitPrice\" as shown (e.g. \"£1.20/kg\", \"2,49 €/1 kg\", \"$0.18/fl oz\"), \"regularPrice\", \"market\" (e.g. DE, FR, UK, US), \"id\" and \"url\". The prefilled example shows common problems next to a correct listing; replace it with your own." }, "titles": { "title": "Titles only (simple mode)", "type": "array", "description": "One product title per entry (size parsing only; no price checks).", "items": { "type": "string" } }, "market": { "title": "Default market", "type": "string", "description": "Two-letter country code used when a row has no market field (e.g. DE, FR, UK, US). EU/UK markets get stricter severities; DE adds the per 1 kg / 1 l check." }, "tolerancePct": { "title": "Mismatch tolerance (%)", "minimum": 0, "maximum": 50, "type": "number", "description": "How far the shown unit price may differ from the computed one before it's flagged (rounding).", "default": 2 }, "datasetId": { "title": "Dataset ID (optional)", "type": "string", "description": "Apify dataset with products, for example the output of a Tesco, Coles, Woolworths, Aldi, Lidl, Rewe, Carrefour, Walmart or Kroger scraper. Common fields (price, wasPrice, unitPrice, CupString, packageSize) are detected automatically; override them with Field map." }, "fieldMap": { "title": "Field map (optional)", "type": "object", "description": "Override field names; dotted paths work for nested fields. Example: {\"unitPrice\": \"CupString\", \"size\": \"PackageSize\", \"title\": \"DisplayName\"}." }, "onlyFlagged": { "title": "Only save rows with findings", "type": "boolean", "description": "Skip products with no findings (you are only charged for saved rows).", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Maximum number of products to check in this run.", "default": 20000 } } }, "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 } } } } } } } } } }