Vivino Wine Scraper

Extract comprehensive wine data from Vivino - the world's largest wine marketplace with over 50 million users and 12 million wines. Get ratings, reviews, prices, and vintage data for any wine region, producer, or grape variety.

Why Use This Scraper?

Whether you're a wine merchant, sommelier, data analyst, or wine enthusiast, this scraper gives you access to the most comprehensive wine database in the world:

• Market Research: Analyze wine trends, pricing, and consumer preferences
• Inventory Management: Track ratings and popularity for your wine selection
• Investment Analysis: Monitor vintage ratings for fine wine investments
• Competitive Analysis: Compare producers and regions
• Personal Collection: Build a database of highly-rated wines to explore

---

Key Features

Easy-to-Use Interface

No coding required! Simply select your filters from dropdown menus and click Start.

Comprehensive Filters

Filter	Description
Region	299 wine regions across 32 countries — France, Italy, Spain, Portugal, Germany, USA, Argentina, Australia...
Sub-regions	Drill down to specific appellations: Meursault, Pauillac, Barolo, Napa Valley, Rioja Alta, etc.
Wine Type	Red, White, Sparkling, Rosé, Dessert, Fortified
Grape Variety	20+ varietals: Pinot Noir, Chardonnay, Cabernet Sauvignon, Syrah...
Producer	Search by winery name (partial match supported)
Rating	Filter by minimum/maximum Vivino rating (1-5 stars)
Price	Set price range in your preferred currency

Vintage Analysis (Exclusive Feature!)

Enable "Include All Vintages" to get ratings for every vintage year of each wine. Perfect for:

• Tracking vintage quality variations
• Finding the best years for a specific wine
• Investment-grade wine analysis

Includes Wines WITHOUT Prices

Unlike other scrapers that only return wines with marketplace listings, this scraper uses Vivino's winery API to include ALL wines - even those not currently for sale.

---

Input Parameters

Basic Filters

Parameter	Type	Default	Description
minRating	Number	3.5	Minimum Vivino rating (1-5)
maxRating	Number	-	Maximum Vivino rating (1-5)
region	Select	All	Wine region or appellation
wineType	Select	All	Red, White, Sparkling, etc.
grape	Select	All	Grape variety
wineryName	Text	-	Producer/winery name filter
priceRangeMin	Number	-	Minimum price
priceRangeMax	Number	-	Maximum price

Advanced Options

Parameter	Type	Default	Description
countryCode	Select	France	Country for prices/availability
currencyCode	Select	EUR	Currency for prices
orderBy	Select	Rating	Sort by rating, reviews, price, or discount
maxWines	Number	100	Maximum wines to scrape (up to 10,000)
includeAllVintages	Checkbox	No	Fetch all vintage years for each wine

---

Output Data

Each wine record includes:

{
  "wineName": "Meursault Blanc",
  "wineryName": "Domaine Coche-Dury",
  "fullName": "Domaine Coche-Dury Meursault Blanc 2019",
  "year": 2019,
  "rating": 4.6,
  "ratingsCount": 245,
  "wineType": "White",
  "regionName": "Meursault",
  "countryName": "France",
  "price": 450,
  "currency": "EUR",
  "wineUrl": "https://www.vivino.com/meursault-blanc/w/85904",
  "wineId": 85904,
  "vintageId": 12345678,
  "wineryId": 11620,
  "acidity": 3.2,
  "sweetness": 1.8,
  "tannin": null,
  "intensity": 3.7,
  "isNatural": false,
  "scrapedAt": "2026-01-13T00:00:00.000Z"
}

Output Fields

Field	Description
wineName	Wine name (without producer)
wineryName	Producer/winery name
fullName	Complete wine name with vintage
year	Vintage year
rating	Vivino rating (1-5 scale)
ratingsCount	Number of user ratings
wineType	Red, White, Sparkling, etc.
regionName	Wine region/appellation
countryName	Country of origin
price	Price (if available)
currency	Price currency
wineUrl	Direct link to Vivino page
acidity / sweetness / tannin / intensity	Taste profile scores
isNatural	Natural wine indicator

---

Usage Examples

Example 1: Top Burgundy White Wines

Find the best-rated white Burgundy wines:

{
  "region": "bourgogne",
  "wineType": "white",
  "minRating": 4.2,
  "maxWines": 200
}

Example 2: Specific Producer with All Vintages

Get all wines and vintages from Domaine de la Romanée-Conti:

{
  "wineryName": "Romanee-Conti",
  "includeAllVintages": true,
  "maxWines": 50
}

Example 3: Affordable Châteauneuf-du-Pape

Find value wines under €50:

{
  "region": "chateauneuf-du-pape",
  "minRating": 4.0,
  "priceRangeMax": 50,
  "orderBy": "ratings_average",
  "maxWines": 100
}

Example 4: Pinot Noir Comparison

Compare Pinot Noir across regions:

{
  "grape": "pinot-noir",
  "minRating": 4.0,
  "maxWines": 500,
  "orderBy": "ratings_count"
}

---

Supported Regions (299 regions, 32 countries)

France (101 regions)

Main Regions	Sub-Regions
Bourgogne	Chablis, Côte de Beaune, Côte de Nuits, Meursault, Puligny-Montrachet, Chassagne-Montrachet, Gevrey-Chambertin, Chambolle-Musigny, Nuits-Saint-Georges, Marsannay, Pommard, Volnay, Vosne-Romanée, Mâconnais, Pouilly-Fuissé, Saint-Véran
Bordeaux	Médoc, Haut-Médoc, Margaux, Pauillac, Saint-Julien, Saint-Estèphe, Saint-Émilion, Pomerol, Pessac-Léognan, Sauternes, Graves, Fronsac, Moulis-en-Médoc, Lalande-de-Pomerol, Castillon Côtes de Bordeaux
Rhône	Côtes-du-Rhône, Châteauneuf-du-Pape, Côte-Rôtie, Hermitage, Crozes-Hermitage, Gigondas, Condrieu, Cornas, Saint-Joseph, Vacqueyras, Cairanne, Rasteau, Lirac, Tavel, Ventoux
Loire	Sancerre, Pouilly-Fumé, Muscadet, Vouvray, Chinon, Bourgueil, Anjou, Saumur, Saumur-Champigny, Savennières, Touraine, Coteaux du Layon, Menetou-Salon
Champagne	Côte des Blancs, Grand Cru, Premier Cru
Beaujolais	Brouilly, Côte de Brouilly, Fleurie, Morgon, Moulin-à-Vent, Saint-Amour
Alsace	Crémant d'Alsace, Grand Cru
Other	Provence (Bandol, Côtes de Provence), Languedoc-Roussillon, Jura, Corse, Sud-Ouest (Cahors, Madiran, Jurançon), Savoie

Italy (64 regions)

Main Regions	Sub-Regions
Piemonte	Barolo, Barbaresco, Barbera d'Alba, Barbera d'Asti, Gattinara, Gavi, Langhe, Moscato d'Asti, Roero
Toscana	Brunello di Montalcino, Chianti, Chianti Classico, Bolgheri, Vino Nobile di Montepulciano, Carmignano, Maremma Toscana, Vernaccia di San Gimignano, Morellino di Scansano
Veneto	Amarone della Valpolicella, Valpolicella, Valpolicella Ripasso, Prosecco, Soave, Bardolino, Conegliano-Valdobbiadene
Other	Sicilia (Etna, Marsala), Lombardia (Franciacorta, Lugana, Valtellina), Campania (Taurasi, Fiano di Avellino), Puglia, Umbria, Friuli, Abruzzo, Sardegna, Trentino-Alto Adige

Spain (35 regions)

Main Regions	Sub-Regions
Rioja	Rioja Alta, Rioja Alavesa
Other	Ribera del Duero, Priorat, Cava, Navarra, Rueda, Toro, Bierzo, Rías Baixas, Jerez/Sherry, Montsant, Penedès, Jumilla, Somontano, La Mancha

Other Countries (99 regions across 29 countries)

Country	Regions
Portugal	Douro, Porto, Alentejo, Dão, Vinho Verde, Madeira, Bairrada, Lisboa, Setúbal
Germany	Mosel, Rheingau, Pfalz, Rheinhessen, Nahe, Franken, Baden, Ahr, Württemberg
Austria	Wachau, Kamptal, Kremstal, Burgenland, Südsteiermark, Weinviertel, Wagram
USA	Napa Valley, Sonoma County, Willamette Valley, Paso Robles, Central Coast, Russian River Valley, Stags Leap District, Columbia Valley
Argentina	Mendoza, Uco Valley, Luján de Cuyo, Salta, Cafayate Valley, Patagonia
Chile	Maipo Valley, Colchagua Valley, Casablanca Valley, Rapel Valley, Leyda Valley, Maule Valley, Limarí Valley, Aconcagua Valley
Australia	Barossa Valley, McLaren Vale, Margaret River, Yarra Valley, Hunter Valley, Clare Valley, Adelaide Hills, Coonawarra, Eden Valley, Tasmania
New Zealand	Marlborough, Central Otago, Hawke's Bay, Martinborough, Waipara
South Africa	Stellenbosch, Swartland, Franschhoek, Hemel-en-Aarde Valley, Walker Bay, Paarl, Constantia, Elgin
Greece	Santorini, Naoussa, Nemea, Peloponnesos, Crete
+ 19 more	Hungary, Georgia, Lebanon, Croatia, Israel, Slovenia, Canada, Brazil, Uruguay, Mexico, UK, Romania, Bulgaria, Moldova, Turkey, Japan, Morocco, India

---

Performance & Costs

Speed

• Standard mode: ~2-3 wines/second
• With vintages: ~1 wine/minute (checks years from 2005 onward, with early stop)

Estimated Costs (Apify Platform)

Wines	Without Vintages	With Vintages
100	~$0.05	~$0.50
500	~$0.20	~$2.50
1000	~$0.40	~$5.00

Costs may vary based on Apify pricing and network conditions.

---

Export Formats

Download your data in multiple formats:

• JSON - For developers and APIs
• CSV - For Excel and spreadsheets
• Excel - Direct .xlsx export
• XML - For legacy systems

---

Tips for Best Results

1. Use region filters when searching for specific producers - it speeds up the search significantly

2. Start with smaller maxWines values to test your filters before running large scrapes

3. Enable includeAllVintages only when you need year-by-year data - it's much slower but provides unique insights

4. Combine filters for precise results: region + grape + rating range

5. Use debug mode to see detailed logs if results are unexpected

---

Limitations

• Vivino's API may rate-limit requests during high-traffic periods
• Some wines without user reviews may not have rating data
• Vintage data is limited to years with actual user reviews on Vivino
• Price data is only available for wines currently listed for sale

---

Legal Disclaimer

This scraper is intended for personal use, research, and legitimate business purposes. Please respect Vivino's terms of service and rate limits. The data scraped belongs to Vivino and its users.

---

Support & Feedback

• Issues: Report bugs or request features on GitHub
• Questions: Contact us through Apify support

---

Changelog

v1.0.80 (2026-03-25)

• 299 wine regions across 32 countries — dropdown extended from ~50 to 299 regions
• Country separators in dropdown for easy navigation (France, Italy, Spain, Portugal, Germany, USA, Argentina, Chile, Australia, New Zealand, South Africa, Greece, Hungary, and 19 more)
• Sub-regions for France (101), Italy (64), and Spain (35) with parent—child labels
• Regions sorted alphabetically within each country
• Moved mapping constants to dedicated src/regions.js file
• Fixed region IDs: Piemonte (392→389), Rioja (404→492)

v1.0.76 (2026-03-25)

• Output tab now displays wine data table directly in the Apify console
• Added output_schema.json and dataset_schema.json with 11-column table view

v1.0.68 (2026-03-24)

• Reorganized dataset columns: key data (name, rating, price) on the left, secondary fields (alcohol, flavors) on the right

v1.0.67 (2026-03-24)

• Improved rate-limiting handling for vintage fetching: smarter 429 detection, exponential backoff, consecutive 429 tracking with automatic pause

v1.0.66 (2026-03-24)

• Added alcohol field (when available from Vivino API)
• Fixed price filter bug: removed default values on priceRangeMin/priceRangeMax that sent 0 to the API

v1.0.61 (2026-03-24)

• Fixed falsy value checks in API URL builder (maxRating, priceRangeMin, priceRangeMax with value 0 were silently ignored)

v1.0.60 (2026-03-23)

• Region hierarchy: selecting "Bourgogne" now automatically includes all sub-regions (Meursault, Pommard, Chablis, etc.)
• Hybrid collection: Step 1 now collects wines AND wineries from Explore API (was wineries-only)
• Stagnation detection: stops pagination after 20 pages without new data (was running up to 1000 pages)
• Optimized vintages: starts at 2005 (configurable via vintageStartYear), early stop after 5 empty years
• New input parameter: vintageStartYear (default: 2005, min: 1970)

v1.0.59 (2026-03-23)

• Code refactoring: extracted helpers (fetchJson, buildWineUrl, getWineTypeName, passesWineFilters)
• Removed dead code (fetchVintagesViaExplore)
• Batched Actor.pushData() calls for better performance
• ~17% code reduction (1057→872 lines)

v1.0.58 (2026-03-23)

• Fixed "Under Maintenance" flag caused by missing prefill values in input schema
• Added prefill values for automated Apify testing

v1.0.18 (2026-01-13)

• Hosted input interface screenshot locally on Apify

v1.0.17 (2026-01-13)

• Added comprehensive README documentation
• Added input interface screenshot

v1.0.15

• Fixed vintage year matching issue (fullName year now matches year column)
• Improved filtering of invalid vintage data

v1.0.14

• Added "Include All Vintages" feature
• Smart filtering of default/aggregate statistics
• Filters out fake vintages with default wine stats

v1.0.11

• Added strict region filtering for winery searches
• Fixed rating filter for wines without ratings

v1.0.0

• Initial release
• Region, grape, wine type, and producer filters
• Support for wines without prices (uses winery API)

---

Made with by wine lovers, for wine lovers.