{ "description": "Search Vivino wines, explore by type, country, region or grape, look up wines by URL or ID, or pull a winery catalogue. Optional reviews.", "properties": { "country": { "default": "", "description": "Filter wines by country of origin (ISO 2-letter code). Leave empty for all countries.", "editor": "select", "enum": [ "", "fr", "it", "us", "de", "es", "au", "at", "pt", "cl", "ar", "ch", "za", "cz", "ca", "hu", "nz", "br", "ge", "gr", "jp", "ru", "ro", "sk", "hr", "si", "mx", "il", "bg", "md", "ua", "gb", "uy", "pl", "tr", "rs", "lu", "cn", "nl", "be", "am", "mk", "dk", "cy", "lb", "az", "pe", "in", "se", "ba", "bo", "al", "mt", "ma", "tn", "me", "xk", "th", "uz", "kz", "by", "lt", "vn", "lv", "jo", "tw", "li", "co", "kr", "sm", "fi", "eg", "ec", "mu", "dz", "id", "na", "et", "ee", "ps", "tz", "no", "mm", "ve", "mg", "pr", "ie", "hk", "kg", "ad", "cr", "cv", "af", "py", "zm", "kp", "np", "cu", "gt", "ph", "we", "zw", "do", "ke", "pf", "bs", "nf", "sy", "vi", "tj", "aw", "bt", "im", "re", "ir", "my", "pa", "cw", "mn", "sn", "an", "ao", "hn", "is", "kh", "rw", "tt", "ls", "ae", "bb", "gh", "iq", "lk", "sg", "sr", "tm", "ug", "bz", "fk", "ga", "jm", "la", "lr", "mw", "ng", "pg", "sz" ], "enumTitles": [ "Any country", "France", "Italy", "United States", "Germany", "Spain", "Australia", "Austria", "Portugal", "Chile", "Argentina", "Switzerland", "South Africa", "Czech Republic", "Canada", "Hungary", "New Zealand", "Brazil", "Georgia", "Greece", "Japan", "Russia", "Romania", "Slovakia", "Croatia", "Slovenia", "Mexico", "Israel", "Bulgaria", "Moldova", "Ukraine", "United Kingdom", "Uruguay", "Poland", "Turkey", "Serbia", "Luxembourg", "China", "Netherlands", "Belgium", "Armenia", "North Macedonia", "Denmark", "Cyprus", "Lebanon", "Azerbaijan", "Peru", "India", "Sweden", "Bosnia and Herzegovina", "Bolivia", "Albania", "Malta", "Morocco", "Tunisia", "Montenegro", "Kosovo", "Thailand", "Uzbekistan", "Kazakhstan", "Belarus", "Lithuania", "Viet Nam", "Latvia", "Jordan", "Taiwan", "Liechtenstein", "Colombia", "Korea (South)", "San Marino", "Finland", "Egypt", "Ecuador", "Mauritius", "Algeria", "Indonesia", "Namibia", "Ethiopia", "Estonia", "State of Palestine", "Tanzania", "Norway", "Myanmar", "Venezuela", "Madagascar", "Puerto Rico", "Ireland", "Hong Kong", "Kyrgyzstan", "Andorra", "Costa Rica", "Cape Verde", "Afghanistan", "Paraguay", "Zambia", "Korea (North)", "Nepal", "Cuba", "Guatemala", "Philippines", "Westeros", "Zimbabwe", "Dominican Republic", "Kenya", "French Polynesia", "Bahamas", "Norfolk Island", "Syria", "Virgin Islands (U.S.)", "Tajikistan", "Aruba", "Bhutan", "Isle of Man", "Réunion", "Iran", "Malaysia", "Panama", "Curaçao", "Mongolia", "Senegal", "Netherlands Antilles", "Angola", "Honduras", "Iceland", "Cambodia", "Rwanda", "Trinidad and Tobago", "Lesotho", "United Arab Emirates", "Barbados", "Ghana", "Iraq", "Sri Lanka", "Singapore", "Suriname", "Turkmenistan", "Uganda", "Belize", "Falkland Islands (Malvinas)", "Gabon", "Jamaica", "Laos", "Liberia", "Malawi", "Nigeria", "Papua New Guinea", "Swaziland" ], "prefill": "", "title": "Country of origin", "type": "string" }, "grape": { "description": "Optional grape filter, e.g. `Nebbiolo`, `pinot-noir`, or a Vivino grape URL.", "editor": "textfield", "title": "Grape variety", "type": "string" }, "includeReviews": { "default": false, "description": "Attach the latest wine-level Vivino reviews to each record. Reviews span all vintages; each review keeps its own year.", "prefill": false, "title": "Include reviews", "type": "boolean" }, "maxItems": { "default": 50, "description": "Maximum wine records to emit. Vivino exposes at most 2,500 rows per search/explore query; split broad queries into narrower filters for more.", "maximum": 2500, "minimum": 1, "prefill": 2, "title": "Max items", "type": "integer" }, "maxPrice": { "description": "Only wines with a current offer at or below this price. Leave empty for no cap.", "maximum": 100000, "minimum": 0, "title": "Maximum price (USD)", "type": "number" }, "maxRating": { "description": "Only wines whose displayed rating is at or below this value (0-5). Applied after fetching.", "maximum": 5, "minimum": 0, "title": "Maximum rating", "type": "number" }, "maxReviewsPerWine": { "default": 10, "description": "How many latest reviews to attach when Include reviews is on (1-50).", "maximum": 50, "minimum": 1, "prefill": 10, "title": "Max reviews per wine", "type": "integer" }, "minPrice": { "description": "Only wines with a current offer at or above this price.", "maximum": 100000, "minimum": 0, "title": "Minimum price (USD)", "type": "number" }, "minRating": { "description": "Only wines whose displayed rating is at or above this value (0-5).", "maximum": 5, "minimum": 0, "title": "Minimum rating", "type": "number" }, "mode": { "default": "search", "description": "What to fetch. `search` runs one or more free-text queries; `explore` browses with filters; `byWineId` resolves wine/vintage URLs or IDs; `winery` pages through a producer's catalogue.", "editor": "select", "enum": [ "search", "explore", "byWineId", "winery" ], "enumTitles": [ "Search wines (free-text queries)", "Explore wines (filter browse)", "Look up wines by URL or ID", "All wines from a winery" ], "prefill": "search", "title": "Mode", "type": "string" }, "order": { "default": "desc", "description": "Descending (highest first) or ascending (lowest first).", "editor": "select", "enum": [ "desc", "asc" ], "enumTitles": [ "Descending", "Ascending" ], "prefill": "desc", "title": "Sort order", "type": "string" }, "orderBy": { "default": "ratings_count", "description": "How Vivino orders search and explore results.", "editor": "select", "enum": [ "ratings_count", "ratings_average", "price", "relevance" ], "enumTitles": [ "Most reviewed", "Highest rated", "Price", "Most relevant" ], "prefill": "ratings_count", "title": "Sort by", "type": "string" }, "region": { "description": "Optional region filter, e.g. `Barolo`, `napa-valley`, or a Vivino region URL. Combine with Country when a name is ambiguous.", "editor": "textfield", "title": "Region or appellation", "type": "string" }, "searchQueries": { "default": [ "barolo" ], "description": "One or more free-text wine searches (mode=search). Searches match wine, winery, region and grape names. Example: `barolo`, `chateau petrus`, `napa valley cabernet`.", "editor": "stringList", "prefill": [ "barolo" ], "title": "Search queries", "type": "array" }, "wineIds": { "default": [ "171525306" ], "description": "Vivino wine/vintage IDs or URLs (mode=byWineId). Accepts 171525306, https://www.vivino.com/w/1167880?year=2022, /vintages/171525306 and /wines/171525306.", "editor": "stringList", "prefill": [ "171525306" ], "title": "Wine IDs or URLs", "type": "array" }, "wineType": { "default": "", "description": "Filter by wine type. Applies to search, explore and winery.", "editor": "select", "enum": [ "", "1", "2", "3", "4", "7", "24" ], "enumTitles": [ "Any type", "Red", "White", "Sparkling", "Rose", "Dessert", "Fortified" ], "prefill": "", "title": "Wine type", "type": "string" }, "winery": { "description": "Winery to scrape (mode=winery). Accepts 1945, michele-chiarlo, or a Vivino winery URL.", "editor": "textfield", "title": "Winery ID, slug or URL", "type": "string" } }, "required": [ "mode" ], "schemaVersion": 1, "title": "Vivino Scraper Input", "type": "object" }