{ "openapi": "3.0.1", "info": { "title": "Singapore Grocery Prices - FairPrice, Cold Storage, Sheng Siong", "description": "No login, no API key: supermarket product prices from FairPrice, Cold Storage and Sheng Siong in one run: price, promo price, promo text and end date, unit price per kg or litre, stock, brand, size and category. Track price changes between runs. $1 per 1,000 products.", "version": "0.1", "x-build-id": "mEoXKfZC6s7l2eWjL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/locaihost~sg-supermarket-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-locaihost-sg-supermarket-prices", "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/locaihost~sg-supermarket-prices/runs": { "post": { "operationId": "runs-sync-locaihost-sg-supermarket-prices", "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/locaihost~sg-supermarket-prices/run-sync": { "post": { "operationId": "run-sync-locaihost-sg-supermarket-prices", "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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Words to search for in each store you pick below, e.g. \"milk\", \"jasmine rice 5kg\", \"Milo\". Each term is searched in every store.", "items": { "type": "string" } }, "stores": { "title": "Stores", "type": "array", "description": "Which supermarkets to search. Leave empty for all three. (Links below always go to the store they belong to.)", "items": { "type": "string", "enum": [ "fairprice", "coldstorage", "shengsiong" ], "enumTitles": [ "FairPrice", "Cold Storage", "Sheng Siong" ] }, "default": [ "fairprice", "coldstorage", "shengsiong" ] }, "categoryUrls": { "title": "Category links", "type": "array", "description": "Category or brand pages copied from the store's website, e.g. https://www.fairprice.com.sg/category/fresh-milk, https://coldstorage.com.sg/category/200300-beverages or https://shengsiong.com.sg/dairy-chilled-eggs. Every product listed there is read, up to the limit below.", "items": { "type": "string" } }, "productUrls": { "title": "Product links", "type": "array", "description": "Individual product pages to check, e.g. a list of the items you track. Works with fairprice.com.sg/product/..., coldstorage.com.sg/product/... and shengsiong.com.sg/product/... links. A product no longer on sale is listed in the run's status message and costs nothing.", "items": { "type": "string" } }, "maxItemsPerQuery": { "title": "Products per search or category", "minimum": 0, "type": "integer", "description": "How many products to read from each search term or category, per store, in the store's own order. 0 = everything the store lists (FairPrice shows up to 1,000 per listing, Cold Storage up to 250 per search).", "default": 100 }, "maxResults": { "title": "Max products per run", "minimum": 0, "type": "integer", "description": "Stop after this many products in total. 0 = no limit.", "default": 0 }, "trackPrices": { "title": "Track price changes", "type": "boolean", "description": "Remember each product's price from run to run, so every row also says the previous price, the change and when it was last seen. Remembered per saved task (or per set of search terms and links).", "default": false }, "onlyChanges": { "title": "Only price changes", "type": "boolean", "description": "Return (and pay for) only products whose price or promotion changed since the last run, plus products seen for the first time. Switches on price tracking. Ideal for a daily schedule.", "default": false }, "onlyNew": { "title": "Only new products", "type": "boolean", "description": "Return only products this setup has never returned before, e.g. to spot new launches in a category.", "default": false } } }, "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 } } } } } } } } } }