Wine API Scraper

Search and browse wine data from a public wine database — no API key, no login, no paid proxies required. Covers red, white, sparkling, rosé, dessert wines, and port wines from top wineries worldwide.

What you can do

• Search wines by name keyword (e.g., "cabernet", "chardonnay", "bordeaux")
• Browse by type — reds, whites, sparkling, rosé, dessert wines, or port
• Filter by country — France, Italy, United States, Spain, Australia, and more
• Filter by region — Bordeaux, Napa Valley, Tuscany, Champagne, Barossa Valley, and more
• Filter by winery — narrow results to a specific producer
• Filter by rating — only return wines above a minimum community score
• Filter by vintage year — find wines from a specific era or decade

Output fields

Each record includes:

Field	Description
wineName	Full wine name (may include vintage year and varietal)
winery	Name of the producer/winery
vintage	Vintage year extracted from the wine name (if present)
country	Country of origin
region	Wine region or appellation
ratingAverage	Community average rating (1.0–5.0 scale)
reviewsCount	Number of community ratings
wineType	Category: Red, White, Sparkling, Rosé, Dessert, or Port
imageUrl	Wine bottle image URL
sourceUrl	Direct link to the wine record
scrapedAt	ISO timestamp of when the record was collected
recordType	Always "wine"

Input parameters

Parameter	Type	Description
mode	select	search (filter by name/winery/etc), byType (browse a category), all (all types)
searchQuery	text	Keyword to match against wine name or winery (mode=search)
wineType	select	Wine category for byType mode: reds, whites, sparkling, rose, dessert-wines, port
filterCountry	text	Only wines from this country (partial, case-insensitive)
filterRegion	text	Only wines from this region (partial, case-insensitive)
filterWinery	text	Only wines from this winery (partial, case-insensitive)
minRating	number	Minimum community rating (1.0–5.0)
vintageMin	integer	Minimum vintage year
vintageMax	integer	Maximum vintage year
maxItems	integer	Maximum number of records to return (default: 100, max: 5000)

Example use cases

Find Bordeaux red wines rated 4.5+:

• mode: search, searchQuery: bordeaux, minRating: 4.5, filterCountry: France

Browse all port wines:

• mode: byType, wineType: port

Find Italian Barolo wines from the 1990s:

• mode: search, filterCountry: Italy, filterRegion: Barolo, vintageMin: 1990, vintageMax: 1999

Get all sparkling wines:

• mode: byType, wineType: sparkling, maxItems: 500

FAQs

Does this require an API key or login? No. The data source is a fully public API — no registration, no API key, no paid plan needed.

How many wines are available? The database contains approximately 3,500+ wines across all six categories: reds (~700), whites (~500), sparkling (~700), rosé (~500), dessert wines (~600), and port (~400).

Are prices included? No — the public database does not include pricing data.

How often is the data updated? The underlying database is maintained by the public API. The actor fetches fresh data on each run.

Can I search for a specific wine by exact name? Use mode=search with searchQuery set to part of the wine name. The match is case-insensitive and searches both the wine name and winery field.

What does the vintage field contain? The vintage year (e.g., 2015) is extracted from the wine name string. Wines labeled "N.V." (non-vintage) will not have a vintage field.

How are ratings scored? Ratings are community scores on a 1.0–5.0 scale, aggregated from wine enthusiast reviews.

Data source

Wine data sourced from Sample APIs — Wines, a freely available, publicly accessible wine database. No credentials required.