Developer Documentation
Comprehensive wine encyclopedia with 100K+ wines, 777 grape varieties, 2,299 wine regions, 30K+ wineries, and 62 countries. Includes food pairings, winemaking methods, vintage charts, flavor notes, 230 guides, 194 glossary terms, and 10 interactive tools. All data sourced from VinoFYI — the Beverage FYI Family encyclopedia at vinofyi.com.
- 100,646 wines with ratings, type, and winery information
- 777 grape varieties (red, white) with origin countries and synonyms
- 2,299 wine regions with hierarchical parent-child relationships
- 30,156 wineries across 62 countries
- 19 wine styles with food pairing and serving recommendations
- 116 flavor notes for wine tasting vocabulary
- 115 food categories for wine-food pairings
- 423K+ wine-food pairing records
- 40 winemaking methods with descriptions
- 15 wine faults with causes and remedies
- 162 vintage charts across 11 major regions (2000-2023)
- N² combination pages: region×grape, grape vs grape, food×style, country×grape, style×region
- 230 educational guide articles across 10 series
- 194 glossary terms with difficulty levels
- 10 interactive tools (serving guide, ABV calculator, tasting builder, region finder)
- 15 languages supported
Quick Start
curl -s "https://vinofyi.com/api/v1/grapes/cabernet-sauvignon/"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/countries/ | List wine-producing countries |
| GET | /api/v1/regions/ | List wine regions |
| GET | /api/v1/grapes/ | List grape varieties |
| GET | /api/v1/wineries/ | List wineries |
| GET | /api/v1/wines/ | List wines |
| GET | /api/v1/styles/ | List wine styles |
| GET | /api/v1/flavors/ | List flavor notes |
| GET | /api/v1/foods/ | List food categories |
| GET | /api/v1/methods/ | List winemaking methods |
| GET | /api/v1/faults/ | List wine faults |
| GET | /api/v1/glossary/ | List glossary terms |
| GET | /api/v1/guides/ | List guides |
| GET | /api/v1/faqs/ | List FAQs |
| GET | /api/v1/search/?q={query} | Unified search |
| GET | /api/v1/stats/ | Site statistics |
URL Patterns
Use these patterns to construct URLs programmatically:
/wines/
Browse all wines (list) (e.g. /wines/)
/wine/{slug}/
Wine detail (singular) (e.g. /wine/chateau-margaux-2015/)
/grapes/
Browse all grape varieties (list) (e.g. /grapes/)
/grape/{slug}/
Grape variety detail (singular) (e.g. /grape/cabernet-sauvignon/)
/regions/
Browse all wine regions (list) (e.g. /regions/)
/region/{slug}/
Wine region detail (singular) (e.g. /region/bordeaux/)
/wineries/
Browse all wineries (list) (e.g. /wineries/)
/winery/{slug}/
Winery detail (singular) (e.g. /winery/chateau-margaux/)
/countries/
Browse all wine countries (list) (e.g. /countries/)
/country/{slug}/
Country detail (singular) (e.g. /country/france/)
/styles/
Browse wine styles (list) (e.g. /styles/)
/style/{slug}/
Wine style detail (singular) (e.g. /style/full-bodied-red/)
/flavors/
Browse flavor notes (list) (e.g. /flavors/)
/flavor/{slug}/
Flavor note detail (singular) (e.g. /flavor/blackberry/)
/food/
Browse food categories for pairing (list) (e.g. /food/)
/food/{slug}/
Food category detail (singular) (e.g. /food/red-meat/)
/methods/
Winemaking methods (list) (e.g. /methods/)
/method/{slug}/
Method detail (singular) (e.g. /method/barrel-aging/)
/faults/
Wine faults (list) (e.g. /faults/)
/fault/{slug}/
Fault detail (singular) (e.g. /fault/cork-taint/)
/glossary/
Wine glossary (list) (e.g. /glossary/)
/glossary/{slug}/
Glossary term detail (e.g. /glossary/terroir/)
/guides/
All guides (list) (e.g. /guides/)
/guide/{slug}/
Guide detail (singular — NOT /guides/{slug}/) (e.g. /guide/wine-tasting-basics/)
/tools/
Interactive wine tools (list) (e.g. /tools/)
/tool/{slug}/
Tool page (singular — NOT /tools/{slug}/) (e.g. /tool/serving-guide/)
/developers/
API documentation (e.g. /developers/)
/nearby/
Wine regions near me (hub) (e.g. /nearby/)
/nearby/{slug}/
Nearby wine regions within 200 km (e.g. /nearby/bordeaux/)
Response Format
All endpoints return JSON with pagination:
Example JSON response
{
"count": 636,
"next": "https://example.com/api/v1/items/?page=2",
"previous": null,
"results": [
{"slug": "example", "name": "Example Item", "...": "..."}
]
}
OpenAPI Specification
Full API schema available as OpenAPI 3.1.0 JSON. Import into Swagger UI, Postman, or any OpenAPI-compatible tool.
SDK Packages
PyPI
pip install vinofyi
Wine data API client — grapes, regions, pairings
npm
npm install vinofyi
TypeScript wine data client
Embed Widget
Embed data cards on your site:
https://widget.vinofyi.com
npm install vinofyi-embed
Format Support
- Markdown endpoints: Append
.mdto any page URL for LLM-friendly markdown output. - Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.