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	40+ wine regions including Bourgogne, Bordeaux, Champagne, Rhône, Loire, Tuscany, Rioja...
Sub-regions	Drill down to specific appellations: Meursault, Pauillac, Châteauneuf-du-Pape, 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

France

Main Regions	Sub-Regions
Bourgogne	Chablis, Côte de Beaune, Côte de Nuits, Meursault, Puligny-Montrachet, Chassagne-Montrachet, Gevrey-Chambertin, Nuits-Saint-Georges, Pommard, Volnay
Bordeaux	Médoc, Haut-Médoc, Margaux, Pauillac, Saint-Julien, Saint-Estèphe, Saint-Émilion, Pomerol, Pessac-Léognan, Sauternes, Graves
Rhône	Côtes-du-Rhône, Châteauneuf-du-Pape, Côte-Rôtie, Hermitage, Crozes-Hermitage, Gigondas, Condrieu
Loire	Sancerre, Pouilly-Fumé, Muscadet, Vouvray, Chinon
Other	Champagne, Alsace, Beaujolais, Provence, Languedoc

International

• Italy: Toscane, Piémont, Vénétie
• Spain: Rioja, Ribera del Duero, Priorat

---

Performance & Costs

Speed

• Standard mode: ~2-3 wines/second
• With vintages: ~1 wine/minute (checks 50+ years per wine)

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.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.