{ "openapi": "3.0.1", "info": { "title": "Woolworths Australia price scraper — specials, unit price", "description": "Woolworths Australia price scraper for shelf price, was-price, specials, and unit price (per kg or litre) by search term. Public catalog, no login. Category browsing is not included. $1 per 1,000 products.", "version": "0.1", "x-build-id": "H36RstGPgTXR7HFb3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dropin-apis~woolworths-au-products/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dropin-apis-woolworths-au-products", "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/dropin-apis~woolworths-au-products/runs": { "post": { "operationId": "runs-sync-dropin-apis-woolworths-au-products", "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/dropin-apis~woolworths-au-products/run-sync": { "post": { "operationId": "run-sync-dropin-apis-woolworths-au-products", "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": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Search terms to look up, e.g. \"milk\", \"bread\". Each term is paginated independently up to maxItemsPerSearch.", "default": [ "milk" ], "items": { "type": "string" } }, "categoryUrls": { "title": "Category URLs (not yet implemented)", "type": "array", "description": "Reserved for future category-browsing support. A permitted /apis/ui/Browse/Category endpoint exists but its request contract (CategoryId/Url/FormatObject) was not reverse-engineered in this version — providing values here is accepted but has no effect yet. Use searchTerms instead.", "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Max items per search term", "minimum": 1, "type": "integer", "description": "Stop paginating a search term once this many items have been collected (pages of up to 36 items each — Woolworths' own limit).", "default": 100 }, "sortBy": { "title": "Sort output by", "enum": [ "relevance", "priceAsc", "priceDesc", "unitPriceAsc", "name" ], "type": "string", "description": "Applied client-side after collection (the live endpoint's own sort parameter was found to have no effect over this interface — see README).", "default": "relevance" }, "includeUnavailable": { "title": "Include unavailable/out-of-stock items", "type": "boolean", "description": "By default, items that are not available or not in stock are dropped.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Defaults to Apify Residential proxy in Australia. Confirmed live on Apify's own infrastructure: Woolworths returns HTTP 403 to Apify's datacenter IP ranges (and to direct, no-proxy requests) there, even though this Actor's own local verification worked without a proxy from a residential home connection — see README \"Why Residential proxy\". If you turn this off, the Actor still automatically switches to Residential AU the first time it sees an HTTP 403 with no proxy in effect, and fails with a clear error only if that isn't available to your account.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } } } }, "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 } } } } } } } } } }