Vivino Wine Data Scraper: ratings, prices & taste profiles

What does Vivino Wine Data Scraper do?

Vivino Wine Data Scraper is an Apify Actor that extracts structured wine data from Vivino, the world's largest wine marketplace with 60M+ users. Provide a mix of wine names and Vivino URLs; the scraper auto-detects each entry and returns ratings, prices, taste profiles, reviews, and full wine details in JSON or CSV.

No browser, no Vivino account, no API key, no rate limits.

Key capabilities:

• Mixed input, auto-routed: paste wine names (with or without vintage) and Vivino URLs in any combination
• Taste profiles: body, acidity, tannins, sweetness, fizziness, flavor notes, food pairings
• User reviews: up to 100 per wine with ratings, comments, and dates
• Market-specific pricing: pick a shipping destination and currency for local prices and wine availability
• Streaming + dedup: 100+ wines per run at 512 MB, no duplicates across URLs and names
• Pay-per-event: pay per result returned in the dataset (~$0.003 each), not compute time

Which Vivino scraper should I use?

Need	Best scraper	What it does
Look up specific wines by name or URL	Vivino Wine Data Scraper (this one)	Search by name or paste Vivino URLs; returns ratings, prices, taste profiles, and reviews
Browse wines by region (all wines from Bordeaux, Italy, and more)	Vivino Wine Scraper	Browse and extract all wines from a region or category on Vivino

In short: use this Actor when you know which wines you want. Use the Vivino Wine Scraper when you want to discover wines in a region.

Why scrape Vivino?

Vivino has over 60 million users and 12+ million wines cataloged. Common uses:

• Wine merchants and retailers: monitor pricing across markets, compare ratings, watch what competitors stock
• Sommeliers and buyers: pick wines for the list based on community ratings and taste profiles
• Market researchers: analyze trends in wine ratings, pricing, and consumer preferences by region
• Wine collectors: track ratings and prices for wines in your cellar or wishlist
• E-commerce platforms: enrich product catalogs with Vivino ratings, taste profiles, and images
• Data journalists: build visualizations and stories on top of a 12M-wine dataset

What data does this scraper extract?

Data Point	Description	Always included
Wine name	Full name as listed on Vivino	Yes
Winery / Producer	Producer name	Yes
Vintage year	Harvest year	Yes
Wine type	Red, White, Rosé, Sparkling, Dessert, Fortified	Yes
Region & Country	Wine region and country of origin	Yes
Grape varieties	List of grape varietals	Yes
Average rating	Vivino community rating (1-5)	Yes
Ratings count	Number of ratings on Vivino	Yes
Price	Price in your selected currency	Yes
Vivino URL	Direct link to the wine page	Yes
Image	Wine bottle image URL	Yes
Food pairings	Recommended food pairings (Beef, Lamb, Pasta)	Yes
Description	Wine description text	Yes
Alcohol content	ABV percentage	Yes
Taste profile	Body, acidity, tannins, sweetness, fizziness, flavor notes	Optional (on by default)
User reviews	Rating, comment, date, username	Optional (off by default)

How to use Vivino Wine Data Scraper

1. Open Vivino Wine Data Scraper on Apify (a free account is needed only at run time).
2. In the Wines field, paste a mix of wine names and Vivino URLs (one per line). The scraper auto-detects each entry.
3. Optionally adjust localization (Country Code, Currency Code, Ship To Country) for market-specific prices.
4. Click Start. Download results from the Dataset tab in JSON, CSV, Excel, or XML.

Input parameters

Parameter	Type	Default	Description
wines	array	sample	Mixed list of Vivino URLs and wine names. Auto-detected per entry.
searchMode	string	auto	Vintage handling: auto, name_and_vintage, name_only
includeTasteProfile	boolean	true	Fetch taste profile (body, acidity, tannins, sweetness, fizziness, flavor notes)
includeReviews	boolean	false	Fetch user reviews (increases cost)
maxReviewsPerWine	integer	10	Maximum reviews per wine (1-100)
shipTo	string	--	Shipping destination country (ISO 3166-1 alpha-2). Controls wine visibility per market. Example: ES, US, FR
countryCode	string	FR	Country for pricing and wine-origin filtering (ISO 3166-1 alpha-2)
currencyCode	string	EUR	Currency for prices (ISO 4217)

Example input

{
    "wines": [
        "Château Margaux 2015",
        "https://www.vivino.com/cloudy-bay-sauvignon-blanc/w/18978",
        "Opus One",
        "Penfolds Grange 2018",
        "Dom Pérignon"
    ],
    "includeTasteProfile": true,
    "includeReviews": false,
    "shipTo": "FR",
    "countryCode": "FR",
    "currencyCode": "EUR"
}

Output format

Each wine produces one dataset item. The structure:

{
    "wineId": 13548,
    "vintageId": 167890,
    "vivino_url": "https://www.vivino.com/chateau-margaux-margaux/w/13548?year=2015",
    "name": "Chateau Margaux Margaux",
    "winery": "Chateau Margaux",
    "vintage": 2015,
    "wine_type": "Red",
    "region": "Margaux",
    "country": "France",
    "appellation": "French Margaux",
    "grape_varieties": ["Cabernet Sauvignon", "Merlot"],
    "average_rating": 4.2,
    "ratings_count": 12345,
    "price": 450.0,
    "currency": "EUR",
    "taste_profile": {
        "body": 4.2,
        "acidity": 3.8,
        "tannins": 4.5,
        "sweetness": 1.1,
        "fizziness": null,
        "flavor_notes": ["black fruit", "oak", "spices", "earth", "tobacco"]
    },
    "reviews": [
        {
            "rating": 4.5,
            "note": "Excellent wine with deep fruit flavors and a long finish.",
            "created_at": "2024-03-15T10:30:00.000Z",
            "user_name": "WineLover42",
            "vintage_year": 2015
        }
    ],
    "image_url": "https://images.vivino.com/thumbs/chateau-margaux_375x500.png",
    "scrapedAt": "2026-03-03T12:00:00.000Z",
    "inputSource": "url",
    "searchQuery": null,
    "shipTo": null
}

taste_profile is omitted when includeTasteProfile: false. reviews is omitted when includeReviews: false. inputSource is "url" or "search".

Error rows

Inputs that fail to resolve to a wine (no Vivino match, too-short query, URL parse error) still produce a dataset row so every billed event is traceable. Error rows carry two additional fields:

{
    "searchQuery": "Nonexistent Wine 9999",
    "inputSource": "search",
    "name": "Unknown",
    "winery": "Unknown",
    "error": "NAME_SEARCH_ERROR",
    "errorMessage": "No match found for \"Nonexistent Wine 9999\"",
    "scrapedAt": "2026-03-03T12:00:00.000Z"
}

error is one of URL_PROCESSING_ERROR (URL could not be parsed or page fetch failed) or NAME_SEARCH_ERROR (no Vivino match, too-short query, or empty result). Dataset views include a dedicated "Errors" tab for filtering.

Diagnostic _strategy field

Every row carries an optional _strategy string indicating which code path produced it:

Value	Meaning
url	URL input, direct fetch of /seo/w/{id} HTML
s1	Strategy 1: winery slug → winery ID → explore by winery
s2-discovered-slug	Strategy 2.1: search page surfaced a better winery slug, retried Strategy 1
s2-entries	Strategy 2.2: search page wine entries, per-entry HTML fetch
s2-shortened	Strategy 2.3: shortened-query retry (Vivino search ranker buried the wine under sibling cuvees)
error	Error row (see Error rows above)

Safe to ignore in client integrations. Useful for debugging matching anomalies.

Run summary in Key-Value Store

Every run writes a JSON summary to the default Key-Value Store under the key last-run-summary:

{
    "startedAt": "2026-03-03T12:00:00.000Z",
    "finishedAt": "2026-03-03T12:02:34.000Z",
    "durationMs": 154000,
    "input": { "count": 10, "urlCount": 2, "nameCount": 8, "searchMode": "auto", "shipTo": "FR" },
    "output": { "processed": 10, "strategies": { "s1": 4, "s2-entries": 4, "url": 2 } },
    "cache": { "hits": 6, "misses": 14 },
    "resilience": { "rateLimit429Trips": 0, "strategy2Fallbacks": 4, "chargeFailures": 0, "chargeLimitReached": false }
}

Useful for offline drift detection and capacity planning.

How much does scraping Vivino cost?

Tier	Cost	What you get
Per result	~$0.003/wine	Pay only for extracted data, not compute time
Free tier	$5 free credits/month	~1,600 wines per month
Starter plan	$29/month	~9,600 wines per month

This Actor uses pay-per-event pricing: no startup fee, and you pay only per result returned in the dataset (one wine = one event). Start with $5 free credits.

Wines	Cost
100	~$0.30
500	~$1.50
1,000	~$3.00
10,000	~$30.00

Estimates based on event pricing only. Actual costs may include minimal platform compute fees. The free $5 credit covers both.

Memory recommendation: 512 MB for most use cases. Increase to 1024 MB only for very large batches (5,000+ wines).

Cap your run cost: set the ACTOR_MAX_TOTAL_CHARGE_USD environment variable in the Run options to enforce a hard ceiling per run. The Actor stops gracefully (graceful exit, dataset preserved) as soon as the cap is reached.

Tips & troubleshooting

• Include vintage years in wine names for precise matching (Chateau Margaux 2015 rather than Chateau Margaux).
• Start without reviews to minimize cost. Add them later if needed.
• Use Ship To Country for market-specific wine availability (ES for Spain-only listings). Use Country Code for pricing currency.
• For very large batches (5,000+ wines): increase memory to 1024 MB in Advanced Settings.
• Switch to Residential proxies in Advanced Settings if you experience blocks on large volumes.

Common issues

• "No results found" for a wine name: check for typos, try with or without the vintage year, or set searchMode: "name_only" to ignore vintage filtering. Very niche or new wines may not be in Vivino.
• Empty price field: prices depend on countryCode and shipTo; not all wines have prices in every market. Try the wine's country of origin (IT for Italian wines).
• Wrong wine returned for a name search: include the full producer name (Chateau Margaux Margaux rather than Margaux) and the vintage year.
• Out of memory: bump memory to 1024 MB. Split very large inputs (1,000+ wines) into multiple runs.
• Rate-limited: switch to Residential proxies, or split large volumes across scheduled runs.

Integrate into your workflow

Send results to Google Sheets, Airtable, your database, or your own API.

API integration

Call this Actor programmatically using the Apify API. Get your API token from Settings → Integrations.

cURL:

curl "https://api.apify.com/v2/acts/mrbridge~vivino-wine-data-scraper/run-sync-get-dataset-items" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -d '{
    "wines": ["Chateau Margaux 2015", "Opus One 2019"],
    "includeTasteProfile": true
  }'

Node.js:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('mrbridge/vivino-wine-data-scraper').call({
    wines: ['Chateau Margaux 2015', 'Opus One 2019'],
    includeTasteProfile: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python:

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("mrbridge/vivino-wine-data-scraper").call(run_input={
    "wines": ["Chateau Margaux 2015", "Opus One 2019"],
    "includeTasteProfile": True,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['name']} - {item['average_rating']}★ - {item['price']} {item['currency']}")

Export formats, schedules, webhooks

• Export formats: append ?format=json|csv|xlsx|xml to the dataset URL. Filter columns with ?fields=name,average_rating,price,currency or exclude them with ?omit=reviews,image_url.
• Scheduled runs: create a Task with your saved input, then in the Schedules tab set a cron expression (e.g. 0 8 * * 1 for every Monday at 8 AM UTC). Ideal for weekly price tracking.
• Webhooks: set up an endpoint in the Integrations tab on event "Run succeeded" to receive datasetId and run metadata; no polling.

No-code integrations

Platform	What it does
Google Sheets	Export wine data to a sheet automatically
Airtable	Sync wines to a base with field mapping
Zapier	Trigger Zaps on run completion → push to 5,000+ apps
Make	Visual workflows: scrape → transform → insert into DB
n8n	Self-hosted workflow automation with the Apify trigger node

Setup for each: see the Apify Integrations docs. Actor ID for run-actor steps: qRSfN5MBLbaEbSU6n.

FAQ

Does Vivino have an official API? No, Vivino does not provide a public API. This scraper uses Vivino's internal endpoints to extract data.

How fast is the scraper? Throughput depends on enrichment. With taste profiles only and no market filtering, expect ~30-50 wines per minute. With reviews and shipTo both enabled (extra HTTP fetches per wine and a dual-search), throughput drops to ~5-10 wines per minute. Vivino's own rate limiting can slow large batches; the scraper handles this automatically with retries and cooldowns.

Can I scrape large volumes? Yes. Deduplication is automatic. For 10,000+ wines, switch to Residential proxies and consider splitting across scheduled runs.

What if a wine is not found? The scraper logs a warning and continues with the next wine. Check for typos or try with or without the vintage year.

Can I use this scraper via MCP? Yes, through the standard Apify MCP integration. Add mrbridge/vivino-wine-data-scraper to your MCP client config (Claude Desktop, Cursor, and more) and call the scraper with a JSON input. The Actor doesn't expose its own MCP server endpoint; it works as a tool inside Apify's catalog-wide MCP server.

What regions and countries are supported? All wines on Vivino are supported worldwide. Use the Country Code setting (e.g. FR, US, GB, DE, IT) to get prices in your local market.

Is my data stored? Results stay in your Apify dataset for 31 days (default retention), fully under your control. No wine data is shared with third parties, no Vivino account or personal data is involved, and requests are stateless and GDPR-compliant.

Is it legal to scrape Vivino?

Web scraping of publicly available data is generally considered legal, as confirmed by the 2022 US Ninth Circuit ruling in hiQ Labs v. LinkedIn. This scraper only accesses pages any visitor can see on Vivino.com without logging in, and never extracts private user data, direct messages, or paid features.

Review Apify's web scraping legality guide and ensure your specific use case complies with Vivino's Terms of Service and applicable laws (GDPR in the EU, particularly if you store review text from identifiable users).

Provided as-is for personal and commercial use; usage must comply with Vivino's Terms of Service. Not affiliated with or endorsed by Vivino.

Your feedback

We're always working on improving the performance of this Actor. If you have technical feedback for Vivino Wine Data Scraper or simply found a bug, please create an issue on the Actor's Issues tab on Apify Console.

Related Actors: Vivino Wine Scraper (browse wines by region), Millesima Wine Scraper (wine prices and critic ratings), Wine-Searcher Scraper from List (popularity, critic scores, prices from Wine-Searcher).