{ "openapi": "3.0.1", "info": { "title": "Laithwaites Wine Scraper", "description": "Scrape Laithwaites Wine (laithwaites.co.uk), a leading UK wine retailer. Browse by category (colour, style, grape, region, offer) with full pagination, or fetch specific products by URL. Get price, vintage, origin, ABV, rating, review count, and stock.", "version": "1.0", "x-build-id": "PSsD4KqlPwGQcF5hQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~laithwaites-wine-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-laithwaites-wine-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/crawlerbros~laithwaites-wine-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-laithwaites-wine-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/crawlerbros~laithwaites-wine-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-laithwaites-wine-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "byCategory", "byProductUrls" ], "type": "string", "description": "byCategory: browse a category (colour/style/grape/region/offer) with full pagination. byProductUrls: fetch specific products directly by URL or bare item code.", "default": "byCategory" }, "category": { "title": "Category (mode=byCategory)", "enum": [ "red-wine", "white-wine", "rose-wine", "sparkling-wine", "no-and-low-alcohol", "dessert-wine", "fortified-wine", "fine-wine", "fine-red-wine", "fine-white-wine", "fine-champagne-wine", "champagne-or-similar", "wine-boxes", "miniature-wine", "half-bottle-wine", "3-bottles-wine-trio", "6-bottles-wine", "12-bottles-wine", "mixed-wine-cases", "mixed-red-wine-cases", "mixed-white-wine-cases", "mixed-rose-wine-cases", "mixed-sparkling-wine-cases", "french-wine", "italian-wine", "spanish-wine", "portuguese-wine", "australian-wine", "new-zealand-wine", "napa-wine", "bordeaux-wine", "burgundy-wine", "cava-wine", "chateauneuf-du-pape-wine", "margaux-wine", "rioja-wine", "beaujolais-wine", "chablis-wine", "sancerre-wine", "cabernet-sauvignon-wine", "chardonnay-wine", "malbec-wine", "merlot-wine", "pinot-grigio-wine", "pinot-noir-wine", "sauvignon-blanc-wine", "light-juicy-reds", "ripe-smooth-reds", "firm-structured-reds", "crisp-fresh-whites", "rich-round-whites", "pale-dry-rose", "bright-fruity-rose", "fresh-fruity-fizz", "5-star-rating", "award-winning-wine", "bin-ends", "sale", "on-offer-wine", "on-offer-red-wine", "on-offer-white-wine", "on-offer-rose-wine", "on-offer-sparkling-wine", "on-offer-fine-wine", "on-offer-mixed-wine-cases" ], "type": "string", "description": "Category to browse. Required for mode=byCategory.", "default": "red-wine" }, "productUrls": { "title": "Product URLs / item codes (mode=byProductUrls)", "type": "array", "description": "Full laithwaites.co.uk/product/... URLs, or bare item codes. Required for mode=byProductUrls.", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "Sort by (mode=byCategory)", "enum": [ "relevance", "ratingDesc", "priceAsc", "priceDesc", "nameAsc", "nameDesc" ], "type": "string", "description": "Order results the same way laithwaites.co.uk's own sort control does. There is no server-side sort endpoint, so this actor collects a larger candidate pool from the category's real pages and sorts it locally before applying `maxItems`.", "default": "relevance" }, "priceMin": { "title": "Minimum price per bottle (GBP)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only include wines priced at or above this amount (GBP per bottle). Records missing a price always pass.", "default": 0 }, "priceMax": { "title": "Maximum price per bottle (GBP)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only include wines priced at or below this amount (GBP per bottle). Records missing a price always pass.", "default": 0 }, "minRating": { "title": "Minimum rating (0-5)", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only include wines with an average customer rating at or above this value. Records missing a rating always pass.", "default": 0 }, "inStockOnly": { "title": "In-stock only", "type": "boolean", "description": "Only include wines currently in stock.", "default": false }, "wineType": { "title": "Wine type", "enum": [ "", "Red", "White", "Rose", "Sparkling", "Dessert", "Fortified" ], "type": "string", "description": "Only include wines of this type. Records missing a type always pass.", "default": "" }, "country": { "title": "Country of origin", "type": "string", "description": "Only include wines whose country of origin contains this text (case-insensitive, e.g. \"France\", \"Australia\"). Records missing a country always pass.", "default": "" }, "keyword": { "title": "Keyword filter", "type": "string", "description": "Only include wines whose title, headline, grape, region, or appellation contain this text (case-insensitive).", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 300, "type": "integer", "description": "Maximum number of wine records to return.", "default": 24 } } }, "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 } } }, "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 } } } } } } } } } }