{ "openapi": "3.0.1", "info": { "title": "Wine Searcher Regions Scraper — Rankings, Prices & Scores", "description": "Extract wine average prices, critics scores, grape varieties, and popularity data from Wine-Searcher region pages. Recursive sub-region crawling from countries to appellations. Automatic pagination and anti-bot handling. Export JSON, CSV, or Excel.", "version": "0.3", "x-build-id": "fFnV9bhWF1TYKKXRS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mrbridge~wine-searcher-region-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mrbridge-wine-searcher-region-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/mrbridge~wine-searcher-region-scraper/runs": { "post": { "operationId": "runs-sync-mrbridge-wine-searcher-region-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/mrbridge~wine-searcher-region-scraper/run-sync": { "post": { "operationId": "run-sync-mrbridge-wine-searcher-region-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": { "region": { "title": "Wine Region", "enum": [ "https://www.wine-searcher.com/regions-argentina", "https://www.wine-searcher.com/regions-buenos+aires", "https://www.wine-searcher.com/regions-catamarca", "https://www.wine-searcher.com/regions-jujuy", "https://www.wine-searcher.com/regions-mendoza", "https://www.wine-searcher.com/regions-neuquen", "https://www.wine-searcher.com/regions-rio+negro", "https://www.wine-searcher.com/regions-salta", "https://www.wine-searcher.com/regions-australia", "https://www.wine-searcher.com/regions-barossa+valley", "https://www.wine-searcher.com/regions-coonawarra", "https://www.wine-searcher.com/regions-eden+valley", "https://www.wine-searcher.com/regions-margaret+river", "https://www.wine-searcher.com/regions-new+south+wales", "https://www.wine-searcher.com/regions-south+australia", "https://www.wine-searcher.com/regions-victoria", "https://www.wine-searcher.com/regions-austria", "https://www.wine-searcher.com/regions-burgenland", "https://www.wine-searcher.com/regions-carnuntum", "https://www.wine-searcher.com/regions-kamptal", "https://www.wine-searcher.com/regions-kremstal", "https://www.wine-searcher.com/regions-neusiedlersee", "https://www.wine-searcher.com/regions-thermenregion", "https://www.wine-searcher.com/regions-wachau", "https://www.wine-searcher.com/regions-canada", "https://www.wine-searcher.com/regions-british+columbia", "https://www.wine-searcher.com/regions-niagara+peninsula", "https://www.wine-searcher.com/regions-nova+scotia", "https://www.wine-searcher.com/regions-okanagan+valley", "https://www.wine-searcher.com/regions-ontario", "https://www.wine-searcher.com/regions-pelee+island", "https://www.wine-searcher.com/regions-quebec", "https://www.wine-searcher.com/regions-chile", "https://www.wine-searcher.com/regions-bio+bio+valley", "https://www.wine-searcher.com/regions-casablanca+valley", "https://www.wine-searcher.com/regions-colchagua+valley", "https://www.wine-searcher.com/regions-elqui+valley", "https://www.wine-searcher.com/regions-limari+valley", "https://www.wine-searcher.com/regions-maipo+valley", "https://www.wine-searcher.com/regions-maule+valley", "https://www.wine-searcher.com/regions-france", "https://www.wine-searcher.com/regions-alsace", "https://www.wine-searcher.com/regions-beaujolais", "https://www.wine-searcher.com/regions-bordeaux", "https://www.wine-searcher.com/regions-burgundy", "https://www.wine-searcher.com/regions-chablis", "https://www.wine-searcher.com/regions-champagne", "https://www.wine-searcher.com/regions-igp+alpes-maritimes", "https://www.wine-searcher.com/regions-jura", "https://www.wine-searcher.com/regions-languedoc-roussillon", "https://www.wine-searcher.com/regions-maconnais", "https://www.wine-searcher.com/regions-medoc", "https://www.wine-searcher.com/regions-provence", "https://www.wine-searcher.com/regions-savoie", "https://www.wine-searcher.com/regions-south+west+france", "https://www.wine-searcher.com/regions-germany", "https://www.wine-searcher.com/regions-ahr", "https://www.wine-searcher.com/regions-baden", "https://www.wine-searcher.com/regions-franken", "https://www.wine-searcher.com/regions-hessische+bergstrasse", "https://www.wine-searcher.com/regions-mosel", "https://www.wine-searcher.com/regions-pfalz", "https://www.wine-searcher.com/regions-rheingau", "https://www.wine-searcher.com/regions-greece", "https://www.wine-searcher.com/regions-attika", "https://www.wine-searcher.com/regions-chios", "https://www.wine-searcher.com/regions-limnos", "https://www.wine-searcher.com/regions-naoussa", "https://www.wine-searcher.com/regions-rhodes", "https://www.wine-searcher.com/regions-samos", "https://www.wine-searcher.com/regions-santorini", "https://www.wine-searcher.com/regions-hungary", "https://www.wine-searcher.com/regions-eger", "https://www.wine-searcher.com/regions-neszmely", "https://www.wine-searcher.com/regions-somlo", "https://www.wine-searcher.com/regions-sopron", "https://www.wine-searcher.com/regions-szekszard", "https://www.wine-searcher.com/regions-tokaj", "https://www.wine-searcher.com/regions-villany", "https://www.wine-searcher.com/regions-italy", "https://www.wine-searcher.com/regions-amarone+della+valpolicella", "https://www.wine-searcher.com/regions-aosta+valley", "https://www.wine-searcher.com/regions-barolo", "https://www.wine-searcher.com/regions-chianti", "https://www.wine-searcher.com/regions-collio+goriziano", "https://www.wine-searcher.com/regions-etna", "https://www.wine-searcher.com/regions-friuli-venezia+giulia", "https://www.wine-searcher.com/regions-orvieto", "https://www.wine-searcher.com/regions-prosecco", "https://www.wine-searcher.com/regions-soave", "https://www.wine-searcher.com/regions-trentino", "https://www.wine-searcher.com/regions-tuscany", "https://www.wine-searcher.com/regions-valpolicella", "https://www.wine-searcher.com/regions-veneto", "https://www.wine-searcher.com/regions-new+zealand", "https://www.wine-searcher.com/regions-central+otago", "https://www.wine-searcher.com/regions-gisborne", "https://www.wine-searcher.com/regions-hawke's+bay", "https://www.wine-searcher.com/regions-marlborough", "https://www.wine-searcher.com/regions-martinborough", "https://www.wine-searcher.com/regions-nelson", "https://www.wine-searcher.com/regions-north+canterbury", "https://www.wine-searcher.com/regions-portugal", "https://www.wine-searcher.com/regions-algarve+region", "https://www.wine-searcher.com/regions-beiras", "https://www.wine-searcher.com/regions-douro", "https://www.wine-searcher.com/regions-ig+minho", "https://www.wine-searcher.com/regions-madeira", "https://www.wine-searcher.com/regions-tras-os-montes+region", "https://www.wine-searcher.com/regions-vinho+verde", "https://www.wine-searcher.com/regions-south+africa", "https://www.wine-searcher.com/regions-constantia", "https://www.wine-searcher.com/regions-orange+river", "https://www.wine-searcher.com/regions-stellenbosch", "https://www.wine-searcher.com/regions-swartland", "https://www.wine-searcher.com/regions-western+cape", "https://www.wine-searcher.com/regions-spain", "https://www.wine-searcher.com/regions-andalucia", "https://www.wine-searcher.com/regions-bierzo", "https://www.wine-searcher.com/regions-castilla+y+leon", "https://www.wine-searcher.com/regions-castilla+la+mancha", "https://www.wine-searcher.com/regions-cava", "https://www.wine-searcher.com/regions-galicia", "https://www.wine-searcher.com/regions-priorat", "https://www.wine-searcher.com/regions-rias+baixas", "https://www.wine-searcher.com/regions-ribera+del+duero", "https://www.wine-searcher.com/regions-rioja", "https://www.wine-searcher.com/regions-rueda", "https://www.wine-searcher.com/regions-jerez+-+xeres+-+sherry", "https://www.wine-searcher.com/regions-toro", "https://www.wine-searcher.com/regions-getariako+txakolina", "https://www.wine-searcher.com/regions-usa", "https://www.wine-searcher.com/regions-arizona", "https://www.wine-searcher.com/regions-california", "https://www.wine-searcher.com/regions-champlain+valley", "https://www.wine-searcher.com/regions-colorado", "https://www.wine-searcher.com/regions-connecticut", "https://www.wine-searcher.com/regions-edna+valley", "https://www.wine-searcher.com/regions-fair+play", "https://www.wine-searcher.com/regions-napa+valley", "https://www.wine-searcher.com/regions-new+york", "https://www.wine-searcher.com/regions-oregon", "https://www.wine-searcher.com/regions-sonoma+county", "https://www.wine-searcher.com/regions-texas", "https://www.wine-searcher.com/regions-virginia", "https://www.wine-searcher.com/regions-washington" ], "type": "string", "description": "Choose a wine region from the list. Burgundy by default. For a sub-sub-appellation not listed here (e.g. a specific commune or cru), use the 'Custom Region URL' field below to override this selection.", "default": "https://www.wine-searcher.com/regions-burgundy" }, "customUrl": { "title": "Custom Region URL (if your region is not listed above, enter the URL here)", "pattern": "^https://www\\.wine-searcher\\.com/regions-[a-zA-Z0-9%+\\-]+", "type": "string", "description": "Optional — override the region selected above by pasting a Wine-Searcher URL directly. Useful for specific sub-appellations not in the dropdown (e.g. https://www.wine-searcher.com/regions-pauillac, regions-vosne+romanee, regions-barbaresco)." }, "scrapeSubRegions": { "title": "Scrape Sub-Regions", "type": "boolean", "description": "If enabled, the scraper will recursively discover and scrape all sub-regions within the selected region. For example, starting from Italy will also scrape Tuscany, Piedmont, Barolo, etc.", "default": false }, "maxDepth": { "title": "Maximum Depth", "minimum": 0, "maximum": 20, "type": "integer", "description": "How deep to go into sub-regions. 0 = only the start region, 1 = start + direct sub-regions, 2 = two levels deep, etc. Countries like Italy or France can have 5+ levels.", "default": 0 }, "maxPagesPerRegion": { "title": "Max Pages per Region", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of pagination pages to scrape per region. Each page contains ~25 wines. Set to 1 for a quick overview, or 20 for up to 500 wines per region.", "default": 5 }, "tabFilter": { "title": "Wine Sorting", "enum": [ "mostpopular", "best", "bestvalue", "mostexpensive", "cheapest" ], "type": "string", "description": "Choose how wines are sorted on each region page.", "default": "mostpopular" }, "targetCurrency": { "title": "Convert prices to (optional)", "enum": [ "", "USD", "EUR", "GBP", "CHF", "JPY", "AUD", "CAD", "NZD", "SEK", "NOK", "DKK", "ISK", "PLN", "CZK", "HUF", "RON", "TRY", "ILS", "ZAR", "BRL", "MXN", "CNY", "HKD", "SGD", "INR", "KRW", "PHP", "THB", "IDR", "MYR" ], "type": "string", "description": "If set, avg_price is converted to this currency using current ECB exchange rates. The original price and currency are kept alongside. Leave empty to skip conversion.", "default": "" } } }, "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 } } } } } } } } } }