🍷 Vivino Ratings Scraper with Vintages from URL List

Extract vintage-specific wine ratings from Vivino by providing a list of wine page URLs. Get ratings and review counts for each specific vintage year displayed on the wine pages.

What does this scraper do?

This Actor extracts vintage-specific rating data from Vivino.com wine pages. You provide a list of Vivino wine URLs, and the scraper returns ratings broken down by vintage year.

Key features:

• 🎯 Vintage-specific data - Get ratings per year, not just overall averages
• 📅 Historical insights - See how ratings vary across vintages
• 📊 Structured output - Clean JSON/CSV/Excel data ready for analysis
• 💰 Cost-optimized - Tries free methods first, uses paid proxies only when needed
• ⚡ High accuracy - Direct extraction from exact pages you specify

Why vintage-specific ratings matter

Wine quality varies dramatically by year. The same wine can score 4.8 in an exceptional vintage and 3.9 in a difficult year. This scraper gives you the complete picture.

Use cases:

• Wine investment - Identify the best vintages to buy or sell
• Auction valuation - Price wines accurately by year
• Cellar management - Track your collection's ratings by vintage
• Retail pricing - Set prices based on vintage quality
• Sommelier research - Recommend specific years to customers

Cost to run

Method	Cost	When used
Direct fetch	Free	First attempt
SuperScraper (datacenter)	~$0.001/page	If blocked
SuperScraper (residential)	~$0.01/page	Last resort

Typical cost: $0.002 - $0.005 per wine URL

Input

Parameter	Type	Required	Description
wineUrls	array	✅	List of Vivino wine page URLs
vintages	array	No	Specific vintages to extract (default: all available)
delayBetweenRequests	integer	No	Delay in ms (default: 3000)
debug	boolean	No	Enable detailed logging

Example input

{
    "wineUrls": [
        "https://www.vivino.com/en/chateau-margaux-margaux/w/14509",
        "https://www.vivino.com/en/opus-one/w/1289"
    ],
    "vintages": [2015, 2016, 2017, 2018, 2019, 2020],
    "delayBetweenRequests": 3000
}

Get all vintages (default)

{
    "wineUrls": [
        "https://www.vivino.com/en/chateau-margaux-margaux/w/14509"
    ]
}

Output

{
    "wineName": "Château Margaux",
    "vintage": 2015,
    "rating": 4.7,
    "ratingsCount": 3421,
    "overallRating": 4.5,
    "overallRatingsCount": 45231,
    "sourceUrl": "https://www.vivino.com/en/chateau-margaux-margaux/w/14509",
    "vintageUrl": "https://www.vivino.com/en/chateau-margaux-margaux/w/14509?year=2015",
    "status": "success",
    "fetchStrategy": "direct (free)",
    "scrapedAt": "2026-01-05T10:30:00.000Z"
}

Output fields

Field	Type	Description
wineName	string	Wine name from Vivino
vintage	integer	Vintage year
rating	number	Rating for this specific vintage (0-5)
ratingsCount	integer	Number of ratings for this vintage
overallRating	number	Overall wine rating across all vintages
overallRatingsCount	integer	Total ratings across all vintages
sourceUrl	string	Original Vivino URL
vintageUrl	string	Direct link to vintage-specific page
status	string	success, blocked, or parse_error
fetchStrategy	string	Method used to fetch
scrapedAt	string	ISO timestamp

How to get Vivino URLs

1. Go to vivino.com
2. Search for a wine
3. Click on the wine to open its page
4. Copy the URL (format: https://www.vivino.com/en/wine-name/w/123456)

The scraper will automatically find all available vintages for each URL.

Use cases

Wine investment funds

Track vintage-specific ratings across your portfolio. Identify which years are appreciating in reputation.

Auction houses

Provide accurate valuations based on specific vintage ratings, not just overall wine reputation.

Wine retailers

Display accurate ratings for each vintage you stock. Help customers choose the best year.

Collectors

Monitor your cellar's ratings by vintage. Decide when to drink or sell based on current ratings.

Sommeliers

Recommend specific vintages to customers with confidence, backed by community ratings.

Comparison: Overall vs Vintage ratings

Wine	Overall Rating	2015 Vintage	2018 Vintage
Château Margaux	4.5	4.7	4.4
Opus One	4.6	4.5	4.7

This scraper gives you the vintage-level detail that matters.

Integrations

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

Tips for best results

🕐 Use delays - 3000ms+ between requests recommended

📦 Batch processing - Process 50-100 URLs per run

🔗 Validate URLs - Ensure URLs contain /w/ followed by numbers

📅 Filter vintages - Specify years if you don't need all vintages

Limitations

• Extracts publicly available vintage data only
• Some wines may have limited vintage information
• Very old vintages may have few ratings
• Website changes may temporarily affect scraping

Legal notice

This scraper extracts publicly available data and does not collect private user information. Users must comply with Vivino's Terms of Service and applicable laws.