# Vivino Scraper: Wine Prices, Ratings & Reviews (`trev0n/vivino-scraper`) Actor

Scrape Vivino wines in 21 markets: ratings, prices and shops, taste profile, grapes, food pairings, rankings, critic scores and reviews. Filter by type, country, grape, region, style, rating and price, search by name or paste links. Price watch mode alerts you to price drops.

- **URL**: https://apify.com/trev0n/vivino-scraper.md
- **Developed by:** [Paweł](https://apify.com/trev0n) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 wines

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🍷 Vivino Scraper: Wine Prices, Ratings & Reviews

🎯 **Turn the world's largest wine community into a clean spreadsheet: ratings, prices from real shops, taste profiles and reviews for any wine in 20 countries.**

Collect wines from Vivino by name, by filters or by link. Every wine comes with its winery, vintage, region, grape and style, the average rating and how many people rated it, the best price and the shop that sells it, the discount, and the taste profile (body, tannin, sweetness, acidity) with its top flavors. Switch on full details for food pairings, alcohol, drinking window, world and regional rankings, critic scores and every shop offer, or add community reviews.

### 🚀 What Does It Do?

This scraper reads Vivino for you and delivers **structured, ready-to-use data**. Pick a country, set your filters and press Start.

💡 **Three ways to use it:**

1. **🔍 Filters**: red Napa Cabernets rated 4.2+ under $100, Italian whites under €20, every Champagne with 1,000+ ratings. Combine wine type, country, grape, region, style, food pairing, rating, number of ratings, price and vintage.
2. **🔎 Wine names**: type "Opus One", "Tignanello" or "Barolo" and get every matching wine and vintage. Wines no shop sells in your country are still found.
3. **🔗 Vivino links**: paste a wine, an Explore page with your filters, a search, a winery, a region, a grape or a wine style page.

🔁 **Price watch mode** remembers earlier runs. Schedule it daily and each run returns only new wines and price changes, with the old price and the change in percent. Get an alert in Telegram, Discord, Slack or any webhook when a wine you follow gets cheaper.

### 👥 Who Is This For?

| 🏢 Use Case                          | 💬 How It Helps                                                                                                      |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| 🛒 **Wine shops & importers**        | Compare your prices with every competing shop, find gaps in your range and spot wines that rate high but sell cheap. |
| 📈 **Price trackers & deal hunters** | Watch the wines you love and get a ping the day their price drops.                                                   |
| 🍽️ **Restaurants & sommeliers**      | Build a wine list by style, food pairing, rating and budget, with drinking windows included.                         |
| 🤖 **Apps & AI assistants**          | Feed wine recommenders, pairing bots and catalogues with ratings, taste profiles and flavors.                        |
| 📊 **Analysts & researchers**        | Study price versus rating, regional rankings and consumer taste across 20 markets.                                   |
| 🍇 **Wineries & distributors**       | Track how your wines rate, what people write about them and where they are sold.                                     |

### ✨ Features

- 🌍 **20 countries**: United States, United Kingdom, Germany, France, Italy, Spain, Netherlands, Belgium, Austria, Switzerland, Denmark, Sweden, Finland, Portugal, Canada, Australia, Singapore, Hong Kong, Japan and Brazil, each with its own shops, prices and currency.
- 🎛️ **Every Vivino filter**: wine type, country of origin, grape, region, style, food pairing, minimum rating, minimum number of ratings, price range and vintage.
- 🚀 **Past Vivino's 2,000 limit**: Vivino lists at most 2,000 wines per search. Bigger searches are split into price bands automatically, so you can collect tens of thousands.
- 👅 **Taste profile**: body, tannin, sweetness, acidity and fizziness, plus the top flavor groups (black fruit, oak, earth…) with their keywords.
- 💲 **Real shop prices**: best price, original price and discount, bottle size and the shop link. With details: every shop offer, the median price and stock.
- 🏆 **Rankings & critics**: world, country, region and winery rank, critic scores, awards and Vivino top lists.
- 📅 **Drinking window**: when the vintage is ready and until when it stays good.
- 💬 **Reviews**: rating, text, language, date and likes, as many per wine as you want.
- 🔁 **Price watch**: only new wines and price changes, with previous price and change in %. Alerts to Telegram, Discord, Slack or a webhook.
- ⚡ **Fast & Scalable**: around 2,600 wines a minute, with no browser and no proxy needed.
- 🧹 **Deduplication**: every vintage once, even when several searches find it.
- 📤 **Export Anywhere**: Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM.

### 🎛️ Filters & Options

| Option                           | What It Does                                                                |
| -------------------------------- | --------------------------------------------------------------------------- |
| 🌍 **Market**                    | The country whose shops, prices and currency you get                        |
| 🔎 **Wine names**                | Search by name, e.g. "Opus One" or "Chateau Margaux"                        |
| 🍷 **Wine types**                | Red, white, sparkling, rosé, dessert or fortified                           |
| 🗺️ **Wine from**                 | Countries the wine comes from, e.g. France, Italy, Spain                    |
| 🍇 **Grapes**                    | e.g. Cabernet Sauvignon, Pinot Noir, Syrah                                  |
| 📍 **Wine regions**              | e.g. Napa Valley, Bordeaux, Rioja                                           |
| 🎨 **Wine styles**               | e.g. Napa Valley Cabernet Sauvignon, Italian Barolo                         |
| 🧀 **Goes well with**            | Food pairings, e.g. Beef, Lamb, Shellfish, Pasta                            |
| ⭐ **Minimum rating**            | Only wines rated at least 3.5, 4.0, 4.5…                                    |
| 👥 **Minimum number of ratings** | Only wines enough people have rated                                         |
| 💲 **Price range**               | Lowest and highest bottle price, in the market's currency                   |
| 📅 **Vintages**                  | Only these years                                                            |
| ↕️ **Sort by**                   | Best picks, highest rated, most rated, price, biggest discount              |
| ✂️ **Go past the 2,000 limit**   | Split big searches automatically                                            |
| 📖 **Full wine details**         | Add rankings, critics, drinking window, food pairings and all shop offers   |
| 💬 **Reviews**                   | Add community reviews, with a limit per wine                                |
| 🔁 **Price watch**               | Return only new wines and price changes since the last run                  |
| 🔔 **Alerts**                    | Telegram, Discord, Slack or webhook message after each run                  |
| 📋 **Compact output**            | Only the key columns, ideal for spreadsheets                                |
| 🔢 **Max Results**               | Control how many wines each search returns                                  |
| 🔗 **Direct URLs**               | Paste any Vivino wine, Explore, search, winery, region, grape or style page |

### 📦 What You Get (Output Fields)

Every wine vintage includes:

#### Wine

| Field            | Example                                                                  |
| ---------------- | ------------------------------------------------------------------------ |
| name             | `Stag's Leap Wine Cellars CHASE CREEK Cabernet Sauvignon 2014`           |
| winery           | `Stag's Leap Wine Cellars`                                               |
| year             | `2014`                                                                   |
| wineType         | `red`                                                                    |
| region / country | `Napa Valley` / `United States`                                          |
| style            | `Napa Valley Cabernet Sauvignon`                                         |
| url              | `https://www.vivino.com/w/2655759?year=2014`                             |
| imageUrl         | `https://images.vivino.com/thumbs/dBd_rhoWR8-wfg3fvSddPQ_pl_375x500.png` |

#### Rating

| Field                     | Example |
| ------------------------- | ------- |
| rating                    | `4.6`   |
| ratingsCount              | `154`   |
| wineRating (all vintages) | `4.5`   |
| wineRatingsCount          | `1185`  |

#### Price

| Field                       | Example                                 |
| --------------------------- | --------------------------------------- |
| price                       | `99.99`                                 |
| currency                    | `USD`                                   |
| discountedFrom              | `150`                                   |
| discountPercent             | `33.34`                                 |
| bottleSize / bottleVolumeMl | `bottle` / `750`                        |
| shopUrl                     | `https://www.vivino.com/wines/78466104` |
| market                      | `US`                                    |

#### Taste

| Field                      | Example                                                                         |
| -------------------------- | ------------------------------------------------------------------------------- |
| tasteIntensity (body, 1–5) | `4.55`                                                                          |
| tasteTannin                | `3.05`                                                                          |
| tasteSweetness             | `1.57`                                                                          |
| tasteAcidity               | `3.07`                                                                          |
| flavors                    | `[{ "group": "black_fruit", "keywords": ["plum", "blackberry", "blueberry"] }]` |

#### Full details (optional)

| Field                   | Example                                                                                    |
| ----------------------- | ------------------------------------------------------------------------------------------ |
| grapes                  | `["Cabernet Sauvignon"]`                                                                   |
| alcohol                 | `14.5`                                                                                     |
| foodPairings            | `["Beef", "Lamb", "Game (deer, venison)"]`                                                 |
| drinkingWindowFrom / To | `2016` / `2028`                                                                            |
| ranking                 | `{ "global": { "rank": 5915, "of": 12436506 }, "region": { "rank": 1604, "of": 234756 } }` |
| criticScores            | `[{ "score": 95, "reviewedAt": "2017-02-01" }]`                                            |
| medianPrice             | `99.99`                                                                                    |
| offers                  | `[{ "shop": "Fine Wine Direct", "price": 310, "currency": "GBP", "url": "https://…" }]`    |

#### Reviews and price watch (optional)

| Field                            | Example                                                                                           |
| -------------------------------- | ------------------------------------------------------------------------------------------------- |
| reviews                          | `[{ "rating": 5, "text": "Black cherry and other black fruits…", "language": "en", "likes": 1 }]` |
| changeType                       | `UPDATED`                                                                                         |
| previousPrice                    | `1092.55`                                                                                         |
| priceChange / priceChangePercent | `-182.09` / `-16.7`                                                                               |

### 📊 Example Output

```json
{
    "vintageId": 78466104,
    "wineId": 2655759,
    "year": 2014,
    "isNonVintage": false,
    "name": "Stag's Leap Wine Cellars CHASE CREEK Cabernet Sauvignon 2014",
    "wineName": "CHASE CREEK Cabernet Sauvignon",
    "winery": "Stag's Leap Wine Cellars",
    "wineryId": 3310,
    "wineType": "red",
    "region": "Napa Valley",
    "regionId": 25,
    "country": "United States",
    "countryCode": "us",
    "style": "Napa Valley Cabernet Sauvignon",
    "styleId": 289,
    "rating": 4.6,
    "ratingsCount": 154,
    "wineRating": 4.5,
    "wineRatingsCount": 1185,
    "price": 99.99,
    "currency": "USD",
    "discountedFrom": 150,
    "discountPercent": 33.34,
    "bottleSize": "bottle",
    "bottleVolumeMl": 750,
    "shopUrl": "https://www.vivino.com/wines/78466104",
    "merchantId": 29045,
    "isNatural": false,
    "tasteAcidity": 3.07,
    "tasteIntensity": 4.55,
    "tasteSweetness": 1.57,
    "tasteTannin": 3.05,
    "tasteFizziness": null,
    "tasteRatingsCount": 122,
    "flavors": [
        {
            "group": "black_fruit",
            "mentions": 155,
            "keywords": ["plum", "blackberry", "blueberry", "black fruit", "black cherry"]
        },
        { "group": "oak", "mentions": 145, "keywords": ["tobacco", "oak", "vanilla", "chocolate", "dark chocolate"] }
    ],
    "imageUrl": "https://images.vivino.com/thumbs/dBd_rhoWR8-wfg3fvSddPQ_pl_375x500.png",
    "url": "https://www.vivino.com/w/2655759?year=2014",
    "market": "US",
    "grapes": ["Cabernet Sauvignon"],
    "foodPairings": ["Beef", "Lamb", "Poultry", "Game (deer, venison)", "Mature and hard cheese"],
    "drinkingWindowFrom": 2016,
    "drinkingWindowTo": 2028,
    "ranking": {
        "global": { "rank": 5915, "of": 12436506 },
        "country": { "rank": 2089, "of": 1343956 },
        "region": { "rank": 1604, "of": 234756 },
        "winery": { "rank": 27, "of": 1283 }
    },
    "reviewsCount": 49,
    "medianPrice": 99.99,
    "offersCount": 1,
    "detailScraped": true,
    "matchedSearches": ["filters only"],
    "scrapedAt": "2026-11-04T19:41:06.690Z"
}
```

### 📋 Dataset Views

The Apify Console gives you **5 ready-made table views** to quickly browse your results:

| View                   | What It Shows                                                                              |
| ---------------------- | ------------------------------------------------------------------------------------------ |
| 🍷 **Overview**        | Label, wine, winery, vintage, type, region, country, rating, price and link                |
| 💲 **Prices & shops**  | Price, original price, discount, bottle, median price and every shop offer                 |
| 👅 **Taste & details** | Style, grapes, alcohol, taste profile, flavors, food, drinking window, ranking and critics |
| 🔁 **Price watch**     | What changed, new and previous price, change in % and when the wine was first seen         |
| 💬 **Reviews**         | Rating, number of reviews and the reviews themselves                                       |

### ❓ FAQ

**🤔 Why do prices differ between countries?**
Vivino shows different shops in every country. Pick the **Market** you sell or buy in, and you get that country's shops, prices and currency.

**🤔 Can I get more than 2,000 wines?**
Yes. Set **Max wines per search** to 0 (or any number above 2,000) and keep **Go past Vivino's 2,000 limit** on. The search is split into price bands, and then wine types, so you can collect everything Vivino lists.

**🤔 How do I watch prices?**
Choose your wines with names, filters or links, turn on **Price watch** and schedule the task daily. The first run saves today's prices. Every later run returns only new wines and price changes, with the old price and the change in percent. Add a Telegram, Discord or Slack alert to hear about drops right away.

**🤔 What if a wine is not sold in my country?**
A name search still finds it, without a price, so you get its rating, winery and region anyway. Turn on full details to see if any shop lists it.

**🤔 Can I export the data?**
Yes: JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

**🤔 How often should I run this?**
For fresh data, run daily or weekly. You can schedule automatic runs on Apify with just a few clicks.

**🤔 Does it work with proxies?**
No proxy is needed. If Vivino ever starts refusing requests, the scraper switches to Apify Proxy on its own.

### 🛠️ Need Custom Filters or Features?

**I'm happy to customize this scraper for your specific needs!** 🤝

Whether you need:

- 🎯 Additional filters (natural wines only, organic certification, bottle sizes, a specific shop or U.S. state)
- 📊 Extra data fields or custom output formats, such as price comparison reports for your range
- 🔄 Integration with your shop, ERP, Google Sheets or database
- ⏰ Scheduled price watches with automatic deduplication and alerts
- 🌐 Scraping other wine platforms (Wine-Searcher, CellarTracker, wine shops) alongside Vivino

👉 **Don't hesitate to reach out via private message**. I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific!

### ⚖️ Legal & Ethical Use

This scraper collects **only publicly available information** from Vivino: wine pages, ratings, shop prices and public reviews. It does not log in, place orders or bypass any access control, and it keeps only the public display name of reviewers. Please use the data responsibly and in compliance with applicable laws and Vivino's terms of service.

# Actor input Schema

## `market` (type: `string`):

The country whose shops, prices and currency you want. Vivino shows different shops and prices in every market.

## `searchTerms` (type: `array`):

Search wines by name, e.g. "Opus One", "Chateau Margaux", "Barolo". Each name is one search; the filters below also apply. A wine no shop sells in your market is still found, without a price.

## `wineTypes` (type: `array`):

Only these wine types. Empty = all types.

## `wineCountries` (type: `array`):

Countries the wine comes from: a name or a two-letter code, e.g. "France", "it", "Spain".

## `grapes` (type: `array`):

Grape varieties as Vivino names them, e.g. "Cabernet Sauvignon", "Pinot Noir", "Syrah".

## `regions` (type: `array`):

Wine regions, e.g. "Napa Valley", "Bordeaux", "Rioja", "Barolo".

## `wineStyles` (type: `array`):

Vivino wine styles, e.g. "Napa Valley Cabernet Sauvignon", "Spanish Rioja Red", "Italian Barolo".

## `foodPairings` (type: `array`):

Food pairings, e.g. "Beef", "Lamb", "Shellfish", "Pasta", "Spicy food", "Mature and hard cheese".

## `minRating` (type: `string`):

Only wines with at least this average rating (1–5).

## `minRatingsCount` (type: `integer`):

Skip wines rated by fewer people, e.g. 100 for well-known wines only. 0 = no limit.

## `priceMin` (type: `integer`):

Lowest bottle price, in the market's currency.

## `priceMax` (type: `integer`):

Highest bottle price, in the market's currency.

## `vintageYears` (type: `array`):

Only these years, e.g. "2018", "2019".

## `sortBy` (type: `string`):

The order wines come in. It decides which wines you get when you set a result limit.

## `startUrls` (type: `array`):

Paste Vivino pages: a wine (vivino.com/.../w/1911534?year=2018), an Explore page with your filters, a search, a winery (vivino.com/wineries/opus-one), a region, grape or wine style page.

## `maxResultsPerSearch` (type: `integer`):

How many wines each name, link or filter search may return. 0 = everything Vivino has.

## `splitLargeSearches` (type: `boolean`):

Vivino lists at most 2,000 wines per search. When you want more, the search is split into price bands (and wine types) automatically.

## `includeDetails` (type: `boolean`):

Adds description, alcohol, grapes and blend, food pairings, drinking window, rankings (world, country, region, winery), critic scores, awards, top lists and every shop offer. Charged per wine with details.

## `includeReviews` (type: `boolean`):

Adds community reviews (rating, text, language, date, likes) to each wine. Charged per review.

## `maxReviewsPerWine` (type: `integer`):

How many reviews per wine. 0 = all of them.

## `maxConcurrency` (type: `integer`):

How many requests run at the same time.

## `compact` (type: `boolean`):

Only the key columns: name, winery, year, type, region, country, rating, price, link.

## `excludeEmptyFields` (type: `boolean`):

Leave out fields with no value.

## `incrementalMode` (type: `boolean`):

Remember the wines and prices from earlier runs and return only new wines, price changes (with the old price and the change in %) and wines back in stock. Schedule it daily and pay only for what changed.

## `stateKey` (type: `string`):

Optional name for this watch, so several watches keep separate memories. Empty = derived from your search.

## `emitUnchanged` (type: `boolean`):

In price watch, also return wines whose price did not change.

## `emitExpired` (type: `boolean`):

In price watch, also return wines that dropped out of the results since the last run.

## `webhookUrl` (type: `string`):

POST a JSON summary of new wines and price changes here after each run.

## `telegramBotToken` (type: `string`):

Telegram bot token for alerts.

## `telegramChatId` (type: `string`):

Telegram chat that receives the alerts.

## `discordWebhookUrl` (type: `string`):

Discord channel webhook for alerts.

## `slackWebhookUrl` (type: `string`):

Slack incoming webhook for alerts.

## `notifyOnlyChanges` (type: `boolean`):

Skip the alert when a run finds nothing new.

## `notificationLimit` (type: `integer`):

How many wines one alert lists (price drops first).

## `includeRunSummary` (type: `boolean`):

Include the run summary in the webhook JSON.

## `proxyFallback` (type: `boolean`):

If Vivino starts refusing requests, continue the run through Apify Proxy.

## `proxyConfiguration` (type: `object`):

Not needed: Vivino answers without a proxy. Turn on only if your runs get blocked.

## Actor input object example

```json
{
  "market": "US",
  "searchTerms": [
    "Opus One"
  ],
  "minRating": "1",
  "minRatingsCount": 0,
  "sortBy": "bestPicks",
  "maxResultsPerSearch": 100,
  "splitLargeSearches": true,
  "includeDetails": false,
  "includeReviews": false,
  "maxReviewsPerWine": 20,
  "maxConcurrency": 4,
  "compact": false,
  "excludeEmptyFields": false,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "notifyOnlyChanges": true,
  "notificationLimit": 10,
  "includeRunSummary": true,
  "proxyFallback": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `prices` (type: `string`):

No description

## `taste` (type: `string`):

No description

## `runSummary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "Opus One"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/vivino-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchTerms": ["Opus One"] }

# Run the Actor and wait for it to finish
run = client.actor("trev0n/vivino-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerms": [
    "Opus One"
  ]
}' |
apify call trev0n/vivino-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,trev0n/vivino-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/v80RceynhMupGqFMn/builds/DaBLE0hIdFackgtdW/openapi.json
