ParseForge
Vivino Wine Catalog Scraper
parseforge/vivino-marketplace-scraper
AutomationE-commerceDeveloper tools
Scrapes Vivino marketplace catalog by keyword search. Returns each wine as a flat row with rating, price, vintage, and region. Filter by wine type and country.
- Total users
- 2
- Monthly active
- 1
- Total runs
- 65
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 8 days ago
Overview
Vivino Wine Catalog Scraper
Scrape Vivino's wine catalog by keyword, type, and country, up to a million wines per run. Each wine comes with its rating, price, vintage, and region. No API key or login. Export to CSV, JSON, Excel, or XML.
Vivino's official API is closed to new developers and rate-limits every request. This Vivino scraper reads the public marketplace pages directly, searching by wine name, winery, or region, and returns each match in one flat schema. Filter by wine type and marketplace country so only the wines you need reach your dataset.
| Who uses it | What they scrape Vivino for |
|---|---|
| Wine merchants | Monitor competitor pricing and catalog depth across multiple Vivino storefronts. |
| Market researchers | Map which regions and varietals dominate a given country's online wine market. |
| Data analysts | Build a structured dataset of wine ratings and price points for trend analysis. |
| App developers | Populate a wine recommendation or cellar-management app with current catalog data. |
What it does
This Actor collects Vivino wine catalog entries by keyword search and returns each wine as a flat row with its rating, price, vintage, and region.
- 🔍 Keyword search: supply any wine name, winery, or region and the scraper resolves it against Vivino's catalog.
- 🍷 Wine type filter: narrow results to Red, White, Sparkling, Rose, Dessert, or Fortified wines only.
- 🌍 Marketplace country: target any of 15 storefronts including the US, UK, Germany, France, Italy, and Australia.
- 📊 Flat row output: every wine returns as one row with its rating, price, vintage, and region, ready for analysis.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with Vivino data
📈 Monitor competitor pricing.
A wine merchant runs the Actor weekly for 'Bordeaux' on the US and UK storefronts to adjust their own shelf prices against the current market.
🗺️ Map regional availability.
A market researcher scrapes 'Riesling' across Germany, Austria, and Switzerland to compare how many listings each country carries.
📊 Build a rating dataset.
A data analyst collects 50,000 red wines from the French storefront to train a model that predicts quality from price and region.
🍇 Populate an app catalog.
An app developer scrapes the full Sparkling wine catalog from Italy to seed a new wine-pairing mobile application.
Why choose this scraper
| What you get | |
|---|---|
| No API key needed | Reads public Vivino pages so you skip the closed official API and its rate limits. |
| 15 country storefronts | Scrape the US, UK, German, French, Italian, Spanish, and other Vivino marketplaces from one Actor. |
| Type and country filters | Collect only Red wines from France, or only Sparkling wines from Italy, before a single row is written. |
| Scalable volume | Set a ceiling from 1 to 1,000,000 wines per run and let the Actor handle the pagination. |
How it compares
This Actor focuses on high-volume catalog extraction with country and type filters, while other Vivino scrapers target reviews or single-wine lookups.
| Feature | ParseForge | Vivino data scraper: wine rating and wine reviews | Vivino Wine Review Scraper | Vivino Wine Search API |
|---|---|---|---|---|
| Keyword search for catalog | Yes | Yes | Not listed | Yes |
| Wine type filter (Red, White, etc.) | Yes | Not listed | Not listed | Not listed |
| 15 country storefronts | Yes | Not listed | Not listed | Not listed |
| Up to 1,000,000 wines per run | Yes | Not listed | Not listed | Not listed |
| Full user review text | Not listed | Yes | Yes | Not listed |
| Taste profile and grape variety | Not listed | Yes | Not listed | Not listed |
Configure the run
Drive the Actor with a wine name, winery, or region keyword, then narrow the catalog by wine type and marketplace country so only matching wines reach your dataset. The Input tab lists every parameter.
A first run with the defaults:
{
"query": "margaux",
"maxItems": 10
}
A larger pull:
{
"query": "margaux",
"maxItems": 200
}
Pricing
Pay-per-result: $0.0085 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $0.85 |
| 1,000 results | $8.50 |
| 10,000 results | $85.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the Vivino Wine Catalog Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to Vivino through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/vivino-marketplace-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Check that your keyword is spelled correctly and that the selected Marketplace Country and Wine Type filters are not too narrow. Try a broader keyword like 'cabernet' with Wine Type set to Any.
The run stops before reaching my maxItems.
The Actor stops when Vivino has no more matching wines for your query and filters. Try a more general keyword or remove the wine type filter to see more results.
Prices are missing for some wines.
Some Vivino listings show a rating but no price because no merchant in that storefront currently stocks it. This is expected behavior and not a scraper error.
The scraper is slow.
The Actor respects Vivino's servers with polite delays. For large runs, set a higher maxItems and let it complete; the platform handles the pacing automatically.
I need data from a country not in the list.
The Actor currently supports the 15 listed storefronts. If your target country is missing, check the Apify Store for a more specialized Vivino scraper or contact support.
FAQ
| Question | Answer |
|---|---|
| Can I scrape Vivino without an API key? | Yes. This Actor reads the public Vivino marketplace pages, so you do not need to register an application or obtain an API key. |
| What data does the scraper return for each wine? | Each row includes the wine's name, rating, number of reviews, price, vintage, winery, region, and the source URL on Vivino. |
| How many wines can I collect in one run? | You set the maximum from 1 up to 1,000,000 wines. The Actor paginates through search results until it hits your limit or the catalog is exhausted. |
| Which Vivino storefronts are supported? | Fifteen countries: US, UK, Germany, France, Italy, Spain, Netherlands, Belgium, Denmark, Sweden, Finland, Ireland, Austria, Switzerland, and Australia. |
| Can I filter by wine type? | Yes. Choose Red, White, Sparkling, Rose, Dessert, or Fortified from the input, or leave it on Any to collect all types. |
| Does this scraper collect wine reviews? | This Actor focuses on the wine catalog: rating, price, vintage, and region. It does not extract the full text of individual user reviews. |
| What export formats are supported? | You can export your dataset to CSV, JSON, Excel, or XML directly from the Apify platform. |
| Can I search by winery name? | Yes. The keyword field accepts winery names, wine names, or regions like 'Napa Valley' or 'Chianti'. |
| Is this an official Vivino API? | No. This is an unofficial scraper that reads public data from Vivino's marketplace pages. It is not affiliated with Vivino, Inc. |
Related actors
Browse the full ParseForge collection for more scrapers.
🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Vivino, Inc. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| query | string | Wine search keyword such as a winery or region. | margaux |
| maxItems | integer | How many wines to collect per run. | 10 |
| wineType | string (7 options) | Wine type filter. | any |
| country | string (15 options) | Vivino marketplace storefront. | US |
Pricing
from $7.69 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.00769 to $0.0085 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~vivino-marketplace-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.