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.

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

PyPI
pip install whiskeyfyi

Whiskey data API client — types, distilleries, expressions

npm
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 .md to 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.