Vivino Scraper

Pull structured wine data from Vivino at scale — winery, vintage, region, grape varieties, community ratings, live pricing, full taste profiles, food pairings, and opt-in reviews. Search by wine name or paste Vivino URLs directly, and localize prices across 23 countries and 15 currencies. Built for wine retailers, sommeliers, market researchers, and catalog teams who need clean, comparable wine data without manually copying it bottle by bottle from Vivino.

Why This Scraper?

• Full taste profiles on every wine — body, acidity, tannins, sweetness, and fizziness on a measured scale, plus the dominant flavor-note groups Vivino's community tasted.
• Community ratings backed by rating counts — every wine carries an average rating and the number of ratings behind it, so you can weight a 4.5 from 12,000 tasters against a 4.5 from 9.
• Up to 100 community reviews per wine — each with reviewer username, their rating, the full comment text, and the review date, emitted as its own row for easy analysis.
• Localized pricing across 23 countries and 15 currencies — quote prices in USD, GBP, EUR, CHF, AUD, JPY, and more to match the market you actually sell into.
• Gather every vintage of a wine, or pin to one exact year — "Ignore vintage" sweeps all release years for price-over-time analysis; "Match exact vintage" locks to the year you typed.
• Grape varieties and food pairings out of the box — the grape blend and Vivino's suggested pairings come back as clean arrays, ready to filter or join.
• Alcohol content, region, and country on every bottle — ABV percentage plus the wine's region and country of origin, without a second lookup.
• Mix search queries and direct URLs in one run — paste a list of wine names, a list of Vivino wine URLs, or both, and let each run independently.

Use Cases

Wine Retail & Pricing

• Monitor competitor and market pricing on the same wine across countries
• Track a vintage's price as it moves from current release to back-vintage
• Spot under-rated, well-priced bottles by comparing rating to price
• Validate landed costs against local market currency before importing

Restaurants & Sommeliers

• Build a by-the-glass and bottle list ranked by community rating
• Match wines to menu courses using the food-pairing fields
• Surface crowd-pleasers with high ratings and high rating counts
• Find structurally similar alternatives using body, acidity, and tannin scores

Market Research & Trends

• Track how a region or grape variety is rated across thousands of wines
• Benchmark a producer's portfolio against its peers
• Analyze taste-profile trends by region, country, or vintage year
• Quantify community sentiment from review text and ratings

App & Catalog Building

• Enrich an e-commerce wine catalog with ratings, images, and tasting notes
• Power a wine-recommendation engine with taste-profile vectors
• Populate a wine app with structured pairings, grapes, and ABV
• Fill gaps in a product database using direct Vivino URL lookups

Getting Started

Search by Wine Name

The simplest run — one query, full taste profile on by default:

{
    "searchQueries": ["Barolo"],
    "maxResults": 50
}

Track Every Vintage of a Wine

Strip the vintage to gather all release years of a single wine, priced in euros:

{
    "searchQueries": ["Tignanello"],
    "vintageHandling": "name_only",
    "countryCode": "FR",
    "currencyCode": "EUR",
    "maxResults": 100
}

Pull a Wine With Community Reviews

Look up specific bottles by URL and collect up to 25 reviews each:

{
    "startUrls": [
        "https://www.vivino.com/wineries/antinori/wines/tignanello/w/1768523"
    ],
    "includeReviews": true,
    "maxReviewsPerWine": 25
}

Full-Featured Example

Mix queries and URLs, exact vintage matching, reviews on, localized to the UK:

{
    "searchQueries": ["Penfolds Grange 2017", "Napa Cabernet Sauvignon"],
    "startUrls": [
        "https://www.vivino.com/wineries/penfolds/wines/grange/w/1146"
    ],
    "vintageHandling": "name_and_vintage",
    "includeTasteProfile": true,
    "includeReviews": true,
    "maxReviewsPerWine": 50,
    "countryCode": "GB",
    "currencyCode": "GBP",
    "maxResults": 200
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
searchQueries	string[]	["Tignanello 2019"]	Wine names or keywords to search on Vivino (e.g. "Barolo", "Penfolds Grange"). Include the vintage year or leave it out. Each query runs independently.
startUrls	string[]	[]	Paste Vivino wine URLs directly. Each URL is fetched as a single wine.

Results

Parameter	Type	Default	Description
maxResults	integer	100	Maximum number of wines to return across all queries and URLs. Set to 0 for unlimited. Start with 10–50 to test, then increase. This caps wines only — when reviews are on, each wine adds up to maxReviewsPerWine review rows on top of this number.
vintageHandling	select	Smart (detect year automatically)	How vintage years are matched: detect a year in your query automatically, match the exact year you typed, or ignore the year and return every vintage of the wine.

Detail

Parameter	Type	Default	Description
includeTasteProfile	boolean	true	Collect the taste profile — body, acidity, tannins, sweetness, fizziness, dominant flavor notes, and food pairings.

Reviews

Parameter	Type	Default	Description
includeReviews	boolean	false	Also collect user reviews. Each review is its own result row, added on top of the maxResults wine count, so total results grow with the number of reviews collected.
maxReviewsPerWine	integer	10	Maximum reviews to collect per wine (across all of its vintages) when reviews are on. Up to 100. Ignored when reviews are off.

Localization

Parameter	Type	Default	Description
countryCode	select	United States	Country market used for pricing and availability. 23 countries supported.
currencyCode	select	US Dollar	Currency for wine prices (ISO 4217). 15 currencies supported.

Output

Every row carries a recordType field — wine or review — so you can filter cleanly downstream.

Wine (recordType: "wine")

{
    "recordType": "wine",
    "wineId": "1768523",
    "vintageId": "162938511",
    "name": "Antinori Tignanello",
    "url": "https://www.vivino.com/en/antinori-tignanello/w/1768523",
    "winery": "Antinori",
    "vintage": "2019",
    "wineType": "Red",
    "region": "Toscana IGT",
    "country": "Italy",
    "grapes": ["Sangiovese", "Cabernet Sauvignon", "Cabernet Franc"],
    "averageRating": 4.4,
    "ratingsCount": 28714,
    "price": 129.99,
    "currency": "USD",
    "imageUrl": "https://images.vivino.com/thumbs/example.png",
    "foodPairings": ["Beef", "Lamb", "Game (deer, venison)"],
    "description": "A Tuscan icon blending Sangiovese with Bordeaux varieties.",
    "alcoholContent": 13.5,
    "body": 4.2,
    "acidity": 3.1,
    "tannins": 3.8,
    "sweetness": 1.4,
    "fizziness": null,
    "flavorNotes": [
        { "group": "oak", "score": 34699, "count": 240 },
        { "group": "red_fruit", "score": 29551, "count": 209 }
    ],
    "inputSource": "search",
    "searchQuery": "Tignanello 2019",
    "scrapedAt": "2026-05-29T14:30:00Z"
}

Core Fields

Field	Type	Description
recordType	string	Always "wine"
wineId	string	Vivino wine identifier
vintageId	string	Vivino vintage identifier — the rated, priced bottle
name	string	Wine name
url	string	Canonical Vivino wine URL
winery	string	Winery / producer name
vintage	string	Vintage year, or "N.V." for non-vintage wines
wineType	string	Red, White, Rosé, Sparkling, Dessert, or Fortified
region	string	Wine region
country	string	Country of origin
grapes	string[]	Grape varieties in the blend
imageUrl	string	Bottle / label image
description	string	Wine description when Vivino provides one
alcoholContent	number	Alcohol by volume (ABV %)
inputSource	string	search or url — how this row was found
searchQuery	string	The query or URL that produced this row
scrapedAt	string	ISO timestamp of extraction

Ratings & Pricing

Field	Type	Description
averageRating	number	Community average rating (0–5)
ratingsCount	integer	Number of community ratings behind the average
price	number	Price in the selected currency
currency	string	Currency code (ISO 4217)
foodPairings	string[]	Vivino's suggested food pairings

Taste Profile

Populated when includeTasteProfile is on.

Field	Type	Description
body	number	Light-to-full body score
acidity	number	Soft-to-acidic score
tannins	number	Smooth-to-tannic score
sweetness	number	Dry-to-sweet score
fizziness	number	Still-to-fizzy score (sparkling wines)
flavorNotes	object[]	Dominant flavor-note groups, each with a group name, a score (how strongly the community tasted it), and a count (mentions behind it)

Review (recordType: "review")

Emitted only when includeReviews: true. Capped at maxReviewsPerWine per wine.

{
    "recordType": "review",
    "wineId": "1768523",
    "vintageId": "162938511",
    "wineUrl": "https://www.vivino.com/en/antinori-tignanello/w/1768523",
    "username": "winelover_42",
    "rating": 4.5,
    "comment": "Silky tannins, dark cherry, and a long finish. Worth the splurge.",
    "date": "2026-03-18T09:12:00Z"
}

Field	Type	Description
recordType	string	Always "review"
wineId	string	Parent wine identifier
vintageId	string	Parent vintage identifier
wineUrl	string	Parent wine URL
username	string	Reviewer's Vivino username
rating	number	Reviewer's own rating (0–5)
comment	string	Full review text
date	string	Review date

Tips for Best Results

• Strip the vintage to track a wine across release years. Set vintageHandling to "Ignore vintage" and the scraper returns every year of a wine — ideal for charting how a label's price moves from current release to back vintage.
• Weight ratings by their count. A 4.6 from 50,000 tasters is far stronger signal than a 4.6 from 8. Sort or filter on ratingsCount alongside averageRating before you trust a score.
• Reviews add on top of your maxResults cap. maxResults limits the number of wines; it does not bound reviews. Each review is a separate billable row added on top, capped at maxReviewsPerWine per wine (across its vintages). So a 50-wine run with maxReviewsPerWine: 100 can return up to 50 wines + 5,000 reviews. Reviews are off by default — turn them on deliberately and set maxReviewsPerWine to keep result counts predictable.
• Set currency and country to your real market. currencyCode controls the price currency and countryCode localizes availability — match both to the market you sell into so the prices you see are the prices your customers see.
• Start small, then scale. Run 10–50 results first to confirm the wines and fields match what you expect, then raise maxResults (or set it to 0 for unlimited).
• Mix names and URLs in one run. Combine a list of search terms with a list of specific Vivino URLs to cover broad discovery and exact lookups in a single pass.
• Use the taste-profile scores to find alternatives. Body, acidity, and tannin values let you match a sold-out favorite to a structurally similar bottle that's still in stock.

Pricing

$1.80 per 1,000 results — roughly 40% below the going market rate for Vivino wine data, with taste profiles bundled in at no extra charge.

Results	Estimated Cost
100	$0.18
1,000	$1.80
10,000	$18.00
100,000	$180.00

A "result" is any row in the output dataset — a wine or a single review. No compute charges — you only pay per result returned. Reviews are off by default; turning them on adds one billable row per review collected.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor is designed for legitimate wine retail research, market analysis, catalog enrichment, and product discovery. Users are responsible for complying with applicable laws and Vivino's terms of service, including making reasonable-rate requests and respecting content usage rules. Review text and usernames are user-generated content — handle any personal data responsibly and in line with applicable privacy regulations. Do not use extracted data for spam, harassment, or any illegal purpose.