{ "openapi": "3.0.1", "info": { "title": "Woolworths Price Tracker & Scraper - Specials & Unit Prices", "description": "Woolworths price tracker and scraper: get every product's price, was-price, savings, special tag, unit price, stock and Stockcode from any woolworths.com.au category URL. Monitor mode returns only price drops, new specials and new products since the last run. No API key or proxy needed.", "version": "0.1", "x-build-id": "A92SsfOHLUWgBnGwT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~woolworths-price-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-woolworths-price-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/neverempty~woolworths-price-tracker/runs": { "post": { "operationId": "runs-sync-neverempty-woolworths-price-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/neverempty~woolworths-price-tracker/run-sync": { "post": { "operationId": "run-sync-neverempty-woolworths-price-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", "properties": { "categoryUrls": { "title": "Woolworths category URLs", "type": "array", "description": "Woolworths Australia category pages, one per line (up to 100 per run), copied from the address bar, like https://www.woolworths.com.au/shop/browse/dairy-eggs-fridge/milk. Sub-categories and specials pages (for example /shop/browse/specials/half-price) work too. If you leave this empty, one example category (Full Cream Milk) is read.", "items": { "type": "string" } }, "maxProductsPerCategory": { "title": "Max products per category", "minimum": 1, "maximum": 20000, "type": "integer", "description": "How many products to read from each category, in A to Z order (1 to 20,000). Empty means 1,000. In monitor mode only this many products of each category are compared, so set it above the category size to watch the whole category." }, "onlySpecials": { "title": "Only products on special", "type": "boolean", "description": "Return only products that Woolworths marks as on special (a sale price, Half Price and similar). Off means every product with a price.", "default": false }, "onlyChanges": { "title": "Monitor mode: return only price drops, new specials and new products", "type": "boolean", "description": "Remembers the price and special status of every product in each category. The first run records the starting point (free, no product rows). Later runs with the same categories return only products whose price dropped, that went on special, or that are newly listed, with the previous price. A category with nothing to report costs one small category-checked event.", "default": false }, "includePriceIncreases": { "title": "Monitor mode: also return price increases", "type": "boolean", "description": "Monitor mode only: also return products whose price went up (for example when a special ends). Off means price increases are remembered quietly and not returned.", "default": false }, "watchName": { "title": "Watch name (optional)", "type": "string", "description": "Keeps a separate memory per name, so two schedules with different category lists do not mix. Letters, digits, dot, dash and underscore, up to 40 characters. Empty means the watch called default." }, "resetMonitoringState": { "title": "Forget what this watch remembers", "type": "boolean", "description": "Monitor mode only: forget the remembered prices of this watch name first, so this run records a new starting point.", "default": false }, "requestTimeoutSecs": { "title": "Seconds to wait for one page", "minimum": 5, "maximum": 60, "type": "integer", "description": "How long to wait for one page of 36 products before asking again (5 to 60).", "default": 30 } } }, "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 } } } } } } } } } }