{ "openapi": "3.0.1", "info": { "title": "๐Ÿš€ Coles Scraper ยท 5,000 Free Products/Month", "description": "Coles Scraper gets you Coles data โšก fast, ๐ŸŽฏ 100% accurate and ๐Ÿ” ridiculously detailed โ€” products, prices, specials & stock from any search, category or brand. ๐Ÿ’ฐ $1 per 1,000 products, no start fee. Scrape your first 5,000 products free every month ๐Ÿš€", "version": "0.0", "x-build-id": "7PEsdZcdVEluQV6Z3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/omkar-cloud~coles-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-omkar-cloud-coles-scraper", "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/omkar-cloud~coles-scraper/runs": { "post": { "operationId": "runs-sync-omkar-cloud-coles-scraper", "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/omkar-cloud~coles-scraper/run-sync": { "post": { "operationId": "run-sync-omkar-cloud-coles-scraper", "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": { "searchQueries": { "title": "Search Keywords", "type": "array", "description": "Keywords to search on Coles โ€” each is searched separately. Rows carry a `query` field so you can tell keywords apart. Leave empty to scrape only categories, brands, specials or URLs.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Categories or subcategories to scrape. Each entry is a slug path (dairy-eggs-fridge/milk), a category ID (8881800) or a coles.com.au browse URL (https://www.coles.com.au/browse/dairy-eggs-fridge/milk). Rows carry a `category_input` field.", "items": { "type": "string" } }, "brands": { "title": "Brands", "type": "array", "description": "Brands to scrape in full โ€” every product of the brand. Each entry is a brand name (Cadbury), a brand ID (2146288555) or a coles.com.au brand URL (https://www.coles.com.au/brands/cadbury-2146288555). Rows carry a `brand_input` field.", "items": { "type": "string" } }, "specials": { "title": "Specials Feed", "enum": [ "none", "all", "half_price", "multi_buy", "online_only" ], "type": "string", "description": "Also scrape the Coles specials listing of this type โ€” every product currently on special. Rows carry a `specials_input` field.", "default": "none" }, "startUrls": { "title": "Coles URLs", "type": "array", "description": "Product, browse, on-special, search and/or brand page URLs โ€” you can mix them. Rows carry an `input_url` field. Product pages are always scraped with full details (billed at the detailed-product rate).", "items": { "type": "string" } }, "specialType": { "title": "Special Type", "enum": [ "", "all", "half_price", "multi_buy", "online_only" ], "type": "string", "description": "Only include products on this kind of special. Leave on Any product to include products that are not on special.", "default": "" }, "filterBrands": { "title": "Filter by Brands", "maxItems": 10, "type": "array", "description": "Only include products of these brands โ€” brand names (case-insensitive) or brand IDs, up to 10. Example: Cadbury, Lindt. Not applied to the Brands input above, which already lists a single brand.", "items": { "type": "string" } }, "dietary": { "title": "Dietary", "maxItems": 10, "type": "array", "description": "Only include products with these dietary labels, by name or ID, up to 10. Example: Vegan, Organic.", "items": { "type": "string" } }, "allergens": { "title": "Allergens", "maxItems": 10, "type": "array", "description": "Only include products with these allergen labels, by name or ID, up to 10. Example: Gluten Free, Nut Free.", "items": { "type": "string" } }, "sortBy": { "title": "Sort By", "enum": [ "", "relevance", "best_seller", "recommended", "price_low_to_high", "price_high_to_low", "unit_price_low_to_high", "brand_a_to_z", "brand_z_to_a" ], "type": "string", "description": "Order of results. Default keeps each listing's own order: relevance for searches, best seller for categories and brands, recommended for specials.", "default": "" }, "store": { "title": "Coles Store", "type": "string", "description": "Coles supermarket whose prices, stock and aisle locations you want: a store ID (4166) or a coles.com.au store URL (https://www.coles.com.au/find-stores/coles/nsw/marrickville-4166). Default: 584 (Coles Burwood East, VIC).", "default": "584" }, "maxResultsPerInput": { "title": "Max Products per Input", "minimum": 1, "maximum": 4992, "type": "integer", "description": "Maximum number of products to scrape per keyword, category, brand, specials feed or listing URL. Use this to control your cost (1,000 products โ‰ˆ $1). Coles serves at most 4,992 products per listing (104 pages of 48). Ignored for product page URLs.", "default": 100 }, "includeDetails": { "title": "Scrape Full Product Details", "type": "boolean", "description": "When enabled, every product is also scraped in full โ€” barcode (GTIN), long description, image gallery, ingredients, allergens, nutrition panel, dietary claims, country of origin, storage and usage instructions, and other varieties and sizes. Still one dataset row per product, billed at the detailed-product rate (1,000 detailed products โ‰ˆ $3 vs $1 standard). Runs take longer because each product page is fetched individually.", "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 } } } } } } } } } }