🍷 Vivino Ratings Scraper with Vintages from Wine List

Search and extract wine ratings from Vivino by providing wine names with their vintages. The scraper searches Vivino, matches wines with specific years, and returns ratings and review counts.

What does this scraper do?

This Actor searches Vivino.com using wine names combined with vintage years. It finds the exact vintage of each wine and extracts its rating data. Perfect when you need year-specific ratings.

Key features:

• 🎯 Vintage-specific - Get ratings for exact wine years (2018, 2019, etc.)
• 🔍 Smart search - Automatically finds wines on Vivino from names
• 📊 Structured output - Clean JSON/CSV/Excel data
• 💰 Cost-optimized - Free methods first, proxies only when needed
• 🔄 Batch processing - Handle hundreds of wines at once

Why use vintage-specific ratings?

Wine quality varies significantly by year. A 2015 Bordeaux may rate 4.5 while the 2013 rates 3.8. This scraper ensures you get the exact vintage rating, not just an average.

Use cases:

• Wine investment - Track specific vintages in your cellar
• Auction research - Value wines before buying/selling
• Restaurant wine lists - Display accurate ratings per vintage
• Collection management - Monitor your portfolio by year

Cost to run

Method	Cost	When used
Direct fetch	Free	First attempt
SuperScraper	~$0.002/wine	If blocked

Typical cost: $0.001 - $0.005 per wine

Input

Parameter	Type	Required	Description
wines	array	✅	List of wine objects with name and vintage
delayBetweenRequests	integer	No	Delay in ms (default: 3000)
debug	boolean	No	Enable detailed logging

Example input

{
    "wines": [
        { "name": "Château Margaux", "vintage": 2015 },
        { "name": "Opus One", "vintage": 2018 },
        { "name": "Penfolds Grange", "vintage": 2017 }
    ],
    "delayBetweenRequests": 3000
}

Alternative flat format

{
    "wineList": [
        "Château Margaux 2015",
        "Opus One 2018",
        "Penfolds Grange 2017"
    ]
}

Output

{
    "wineName": "Château Margaux",
    "vintage": 2015,
    "rating": 4.6,
    "ratingsCount": 8234,
    "vivinoUrl": "https://www.vivino.com/en/chateau-margaux/w/14509?year=2015",
    "status": "success",
    "scrapedAt": "2026-01-05T10:30:00.000Z"
}

Output fields

Field	Type	Description
wineName	string	Wine name as found on Vivino
vintage	integer	Wine vintage year
rating	number	Average rating (0-5) for this vintage
ratingsCount	integer	Number of ratings for this vintage
vivinoUrl	string	Direct link to the wine on Vivino
searchQuery	string	Original search query used
status	string	success, not_found, or error
scrapedAt	string	ISO timestamp

Use cases

Wine collectors

Track ratings for specific vintages in your cellar. Know exactly how your 2010 Bordeaux collection is rated.

Wine merchants

Provide accurate vintage-specific ratings on your e-commerce site.

Investment funds

Monitor vintage ratings for wine investment portfolios. Identify undervalued years.

Auction houses

Research accurate valuations before sales with current rating data.

How it works

1. Takes your wine name + vintage
2. Searches Vivino for the wine
3. Filters results to match the exact vintage
4. Extracts rating and review count
5. Returns structured data

Integrations

• Apify API - Programmatic access
• Google Sheets - Direct export
• Webhooks - Real-time notifications
• Zapier/Make - Workflow automation

Tips for best results

🍾 Use full wine names - "Château Margaux" works better than "Margaux"

📅 Valid vintages - Use 4-digit years (2015, not '15)

🕐 Allow delays - 3000ms+ between requests recommended

📦 Batch wisely - Process 50-100 wines per run

Limitations

• Searches public Vivino data only
• Some obscure wines may not be found
• Vintage must exist in Vivino's database

Legal notice

This scraper extracts publicly available data. Users must comply with Vivino's Terms of Service and applicable laws.