WineFolly Grape Variety Scraper

Scrape 200+ grape variety profiles from WineFolly.com. Extract tasting profiles, flavor notes, body, tannin, acidity, sweetness, food pairings, wine regions, aromas, and serving recommendations for every grape variety.

What data can you extract?

For each grape variety, the scraper extracts:

Field	Description
grapeName	Name of the grape variety
alternateNames	Other names for the grape (e.g., Spätburgunder for Pinot Noir)
wineColor	red, white, or rosé
body	Wine body (light, medium, full)
sweetness	Sweetness level (dry, off-dry, sweet)
tannin	Tannin level (none, low, medium, high)
acidity	Acidity level (low, medium, high)
flavors	Primary flavor descriptors (Cherry, Vanilla, etc.)
aromas	Aromatic notes
foodPairings	Recommended food pairings
regions	Major wine-producing regions for the grape
description	Brief description of the grape variety
imageUrl	Featured image URL
url	WineFolly grape page URL
searchQuery	The query that matched this result
scrapedAt	ISO timestamp of when the data was scraped

How to use

Search for specific grapes

{
    "searchQueries": ["Pinot Noir", "Chardonnay", "Merlot"],
    "maxListings": 10,
    "scrapeDetails": true
}

Scrape all grapes with full details

{
    "searchQueries": [],
    "maxListings": 250,
    "scrapeDetails": true
}

Quick directory listing (basic data only)

{
    "searchQueries": [],
    "maxListings": 25,
    "scrapeDetails": false
}

Input parameters

Parameter	Type	Default	Description
searchQueries	string[]	[]	Grape names or wine types to search for. Leave empty for all grapes.
maxListings	integer	100	Maximum number of grape profiles to return.
scrapeDetails	boolean	false	Visit individual grape pages for full profiles (tasting notes, food pairings, regions).
proxyConfiguration	object	{}	Proxy settings for large-scale runs.

How it works

1. Discovery: The scraper reads the WineFolly /grapes/ directory page or sitemap to find grape variety URLs.
2. Filtering: If search queries are provided, grapes are filtered by name matching.
3. Detail scraping: When scrapeDetails is enabled, each grape's detail page is visited to extract full tasting profiles, food pairings, regions, and more from the __NEXT_DATA__ JSON and HTML content.
4. Data extraction: Structured tag data (body, acidity, sweetness, tannin, flavors) is parsed from WineFolly's tag taxonomy. Additional data (food pairings, regions, aromas, alternate names) is extracted from the page HTML.

Example output

{
    "grapeName": "Pinot Noir",
    "alternateNames": ["Pinot Nero", "Spätburgunder", "Blauburgunder"],
    "wineColor": "red",
    "body": "medium",
    "sweetness": "dry",
    "tannin": "low",
    "acidity": "medium-high",
    "flavors": ["Cherry", "Raspberry", "Mushroom", "Hibiscus", "Clove"],
    "aromas": null,
    "foodPairings": ["Duck", "Mushroom dishes", "Grilled salmon"],
    "regions": ["Burgundy, France", "Willamette Valley, Oregon", "Central Otago, New Zealand"],
    "description": "The 'heartbreak grape' rewards patience with unrivaled depth...",
    "imageUrl": "https://media.winefolly.com/Pinot-Noir-wine-tasting-WineFolly.jpg",
    "url": "https://winefolly.com/grapes/pinot-noir/",
    "searchQuery": "Pinot Noir",
    "scrapedAt": "2026-04-26T12:00:00.000Z"
}

Tips

• Basic data (name, body, tannin, acidity, sweetness, flavors) is available from the directory listing without visiting detail pages. Set scrapeDetails: false for faster runs.
• Full profiles with food pairings, regions, alternate names, and descriptions require scrapeDetails: true.
• The directory page shows ~25 grapes. For comprehensive scraping, the actor automatically uses the sitemap to discover all 200+ grape varieties.
• Use proxy configuration for large-scale runs to avoid rate limits.