🍷 Vivino Ratings Scraper from Wine List

Search and extract wine ratings from Vivino by providing a simple list of wine names. No vintage required - the scraper returns the overall wine rating across all years.

What does this scraper do?

This Actor searches Vivino.com using wine names and extracts the overall rating data. It's the fastest way to get wine ratings when you don't need vintage-specific data.

Key features:

• 🎯 Simple input - Just wine names, no vintages needed
• ⚡ Fast - Quick lookups without vintage filtering
• 🔍 Smart search - Automatically finds wines on Vivino
• 📊 Structured output - Clean JSON/CSV/Excel data
• 💰 Cost-optimized - Free methods first

When to use this scraper

Choose this scraper when:

• You need general wine ratings quickly
• You don't have vintage information
• You want overall wine reputation, not year-specific

For vintage-specific ratings, use Vivino Ratings Scraper with Vintages instead.

Cost to run

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

Typical cost: $0.001 - $0.003 per wine

Input

Parameter	Type	Required	Description
wineNames	array	✅	List of wine names to search
delayBetweenRequests	integer	No	Delay in ms (default: 3000)
debug	boolean	No	Enable detailed logging

Example input

{
    "wineNames": [
        "Château Margaux",
        "Opus One",
        "Penfolds Grange",
        "Caymus Cabernet Sauvignon"
    ],
    "delayBetweenRequests": 3000
}

Output

{
    "wineName": "Château Margaux",
    "rating": 4.5,
    "ratingsCount": 45231,
    "winery": "Château Margaux",
    "region": "Margaux, Bordeaux",
    "vivinoUrl": "https://www.vivino.com/en/chateau-margaux-margaux/w/14509",
    "searchQuery": "Château Margaux",
    "status": "success",
    "scrapedAt": "2026-01-05T10:30:00.000Z"
}

Output fields

Field	Type	Description
wineName	string	Wine name as found on Vivino
rating	number	Overall average rating (0-5)
ratingsCount	integer	Total number of ratings
winery	string	Producer/winery name
region	string	Wine region
vivinoUrl	string	Direct link to wine on Vivino
searchQuery	string	Original search query
status	string	success, not_found, or error
scrapedAt	string	ISO timestamp

Use cases

Quick wine research

Get instant ratings for wines you're considering buying.

Menu creation

Add ratings to restaurant wine lists without vintage specifics.

Wine discovery

Find highly-rated wines by searching producer names.

Catalog enrichment

Add Vivino ratings to your wine database quickly.

How it works

1. Takes your wine name
2. Searches Vivino
3. Returns the top matching result with overall rating
4. Outputs structured data

Integrations

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

Tips for best results

🍾 Full names work best - "Château Margaux" not "Margaux"

🏭 Include producer - "Caymus Cabernet" better than just "Cabernet"

🕐 Use delays - 3000ms+ recommended

Comparison with other scrapers

Feature	This Scraper	With Vintages	From URL
Input	Wine names	Names + years	URLs
Speed	Fastest	Medium	Fast
Precision	Good	Highest	Exact
Best for	Quick lookup	Investment	Known wines

Limitations

• Returns overall rating, not vintage-specific
• Search may return similar wines if exact match not found
• Obscure wines may not be found

Legal notice

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

FAQ

Do I need the exact wine name?

No. The scraper performs a search on Vivino and returns the best match. Partial names usually work well, but more specific names yield better results.

What if no matching wine is found?

If Vivino returns no results for a wine name, it will be skipped. Check the run log for any unmatched entries.

Can I include vintage years in the wine names?

Yes, but it depends on the variant. This scraper searches by wine name only. For vintage-specific data, use the "with Vintages" variant of this scraper.

How accurate are Vivino ratings?

Vivino ratings are crowdsourced from millions of users worldwide. Wines with higher ratingsCount values have more reliable averages.

Can I schedule automated runs?

Yes. Use the Apify platform's scheduling feature to run the scraper at any interval. Combined with webhooks or integrations (Zapier, Make, Google Sheets), you can automate your wine data pipeline.

Related Actors

Looking for more wine data tools?

• Vivino Wine Scraper - Advanced Vivino scraper with filters by region, grape, producer, and price
• Millesima Wine Scraper - Extract prices and critic ratings from Millesima.fr
• Vivino Ratings Scraper from URL List - Get Vivino ratings from specific wine URLs
• Vivino Ratings Scraper from Search Results - Bulk extract wine ratings from Vivino search pages