How We Built the Vivino Discovery Scraper
Why Vivino data needs two different tools, and how the Discovery Scraper turns criteria like region, rating and price into a ranked wine list.
Crawl Wine-Searcher region pages recursively, from countries down to individual appellations. Extract wine rankings, critic scores, grape varieties, and popularity data. Automatic pagination captures every wine, even deep in large regions. Perfect for building complete regional wine databases.
The Wine-Searcher Region Scraper runs on the Apify platform and systematically crawls Wine-Searcher.com’s regional hierarchy, the most complete geographic classification of wines available online, covering virtually every wine-producing country, region, and appellation in the world.
You provide one or more Wine-Searcher region URLs as starting points. The scraper discovers all sub-regions linked from that page, follows them recursively, and extracts wine ranking data from each level. Pagination is handled automatically, so even appellations with hundreds of listed wines are fully captured, with no configuration on your end.
This recursive approach means you can start with a single country URL and end up with a complete hierarchical database of every ranked wine across all its regions and appellations, all in one run.
Wine database companies building or maintaining complete regional wine catalogs, using the recursive crawl to populate geographic hierarchies from country level down to individual appellations with complete ranking data.
Market research analysts studying regional wine trends by extracting ranking and pricing data across all appellations within a macro-region (e.g., all of Burgundy or the Rhone Valley), then analyzing score distributions, price tiers, and grape variety prevalence.
Wine fund managers identifying emerging appellations by comparing average critic scores and price levels across regions, spotting areas where quality-to-price ratios suggest undervaluation relative to neighboring appellations.
Travel and hospitality companies creating data-driven wine tourism guides by mapping appellation-level data (top-ranked wines, dominant grape varieties, average price points) to geographic regions for interactive destination planning tools.
Example Input:
{
"startUrls": [
"https://www.wine-searcher.com/regions-burgundy"
],
"maxDepth": 3,
"maxItems": 500,
"outputFormat": "json"
}
Example Output (single record):
{
"rank": 1,
"wineName": "Domaine de la Romanee-Conti Romanee-Conti Grand Cru",
"vintage": "N.V.",
"region": "Burgundy",
"subRegion": "Cote de Nuits",
"appellation": "Romanee-Conti",
"country": "France",
"criticScore": 98,
"averagePrice": 22450.00,
"currency": "USD",
"merchantCount": 142,
"grapeVarieties": ["Pinot Noir"],
"popularity": "Top 0.1% worldwide",
"regionUrl": "https://www.wine-searcher.com/regions-romanee+conti",
"wineUrl": "https://www.wine-searcher.com/find/drc+romanee+conti"
}
| Field | Type | Description |
|---|---|---|
rank | number | Position in the regional ranking |
wineName | string | Full wine name (producer + cuvee + classification) |
vintage | string | Vintage year, or “N.V.” for non-vintage aggregations |
region | string | Top-level wine region |
subRegion | string | Intermediate geographic zone |
appellation | string | Specific AOC/AOP appellation |
country | string | Country of origin |
criticScore | number | Aggregated critic score (0-100) |
averagePrice | number | Average merchant price |
currency | string | Price currency code |
merchantCount | number | Number of merchants listing this wine |
grapeVarieties | array | Dominant grape varieties |
popularity | string | Wine-Searcher popularity percentile |
regionUrl | string | Wine-Searcher region page URL |
wineUrl | string | Wine-Searcher wine detail page URL |
Scrape Millesima wine prices, vintages and critic scores as displayed on its wine pages, including Parker, Wine Spectator and Decanter.
4 MCP tools for Vivino wine data: search wines, explore by rating, price & style, fetch details and get meal-aware recommendations in Claude or ChatGPT.
Discover Vivino wines by criteria: filter 299 regions by grape, rating and price, sort by rating or popularity. Bulk export, no account needed.
Why Vivino data needs two different tools, and how the Discovery Scraper turns criteria like region, rating and price into a ranked wine list.
An overview of the main wine data sources and how to access wine prices, ratings, and reviews programmatically with web scrapers.
1,896 Burgundy wines, two sources per bottle: critic score saturates at the village tier, and fame splits between collectors and the Vivino public.