Developer Documentation
Whiskey encyclopedia covering distilleries, expressions, cask types, and regional traditions. 2,200+ whiskey expressions, 500+ distilleries, 15 whiskey types, 15-20 cask types, 7 countries, 50 regions, 150 guides, and glossary terms. All data sourced from WhiskeyFYI — the Beverage FYI Family encyclopedia at whiskeyfyi.com.
- 2,200+ whiskey expressions with ABV, age statement, tasting notes (nose, palate, finish)
- 500+ distilleries with founding year, status, owner, and water source
- 15 whiskey types (Scotch Single Malt, Bourbon, Irish, Japanese, Rye, etc.)
- 15-20 cask types with origin, size, previous contents, and flavor contribution
- 7 countries with whiskey traditions
- 50 whiskey-producing regions
- N² comparison pages: type vs type
- 150 educational guides
- Glossary terms with definitions
- Interactive whiskey tools
- 15 languages supported
Quick Start
curl -s "https://whiskeyfyi.com/api/v1/types/single-malt-scotch/"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/countries/ | List countries |
| GET | /api/v1/regions/ | List regions |
| GET | /api/v1/types/ | List whiskey types |
| GET | /api/v1/distilleries/ | List distilleries |
| GET | /api/v1/casks/ | List cask types |
| GET | /api/v1/expressions/ | List whiskey expressions |
| GET | /api/v1/glossary/ | List glossary terms |
| GET | /api/v1/guides/ | List guides |
| GET | /api/v1/tools/ | List tools |
| 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:
/countries/
Whiskey countries (e.g. /countries/)
/country/{slug}/
Country detail (e.g. /country/scotland/)
/regions/
Whiskey regions (e.g. /regions/)
/region/{slug}/
Region detail (e.g. /region/speyside/)
/types/
Whiskey types (e.g. /types/)
/type/{slug}/
Whiskey type detail (e.g. /type/single-malt-scotch/)
/distilleries/
All distilleries (e.g. /distilleries/)
/distillery/{slug}/
Distillery detail (e.g. /distillery/macallan/)
/casks/
Cask types (e.g. /casks/)
/cask/{slug}/
Cask type detail (e.g. /cask/ex-bourbon/)
/expressions/
All whiskey expressions (e.g. /expressions/)
/expression/{slug}/
Expression detail (e.g. /expression/macallan-12/)
/compare/{slug_a}-vs-{slug_b}/
Compare two types (e.g. /compare/bourbon-vs-rye/)
/guide/
All guides (e.g. /guide/)
/guide/{slug}/
Guide detail (e.g. /guide/how-to-taste-whiskey/)
/glossary/
Whiskey glossary (e.g. /glossary/)
/glossary/{slug}/
Glossary term detail (e.g. /glossary/angel-share/)
/tools/
Interactive tools (e.g. /tools/)
/tools/{slug}/
Tool page (e.g. /tools/proof-calculator/)
/search/
Search (e.g. /search/?q=bourbon)
/developers/
API documentation (e.g. /developers/)
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
pip install whiskeyfyi
Whiskey data API client — types, distilleries, expressions
npm install whiskeyfyi
TypeScript whiskey data client
Embed Widget
Embed data cards on your site:
https://widget.whiskeyfyi.com
npm install whiskeyfyi-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.