# WhiskeyFYI

> 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.

## Data Scope
- 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

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/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/`)

## Browse Whiskey
- [Whiskey Types (15)](https://whiskeyfyi.com/types/)
- [Countries (7)](https://whiskeyfyi.com/countries/)
- [Regions (50)](https://whiskeyfyi.com/regions/)
- [Distilleries (500+)](https://whiskeyfyi.com/distilleries/)
- [Expressions (2,200+)](https://whiskeyfyi.com/expressions/)
- [Cask Types](https://whiskeyfyi.com/casks/)

## Learn
- [Guides (150)](https://whiskeyfyi.com/guide/)
- [Glossary](https://whiskeyfyi.com/glossary/)
- [Tools](https://whiskeyfyi.com/tools/)

## Embed Widget
- [WhiskeyFYI Widget Docs](https://widget.whiskeyfyi.com)
- [whiskeyfyi-embed on npm](https://www.npmjs.com/package/whiskeyfyi-embed)
- [whiskeyfyi-embed on GitHub](https://github.com/fyipedia/whiskeyfyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| 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 |

```bash
curl -s "https://whiskeyfyi.com/api/v1/types/single-malt-scotch/"
```

[API Docs](https://whiskeyfyi.com/developers/) · [OpenAPI Spec](https://whiskeyfyi.com/api/openapi.json)

## Developer Tools
- **PyPI**: `pip install whiskeyfyi` — [whiskeyfyi](https://pypi.org/project/whiskeyfyi/) — Whiskey data API client — types, distilleries, expressions
- **npm**: `npm install whiskeyfyi` — [whiskeyfyi](https://www.npmjs.com/package/whiskeyfyi) — TypeScript whiskey data client
- **Embed Widget**: [whiskeyfyi-embed](https://widget.whiskeyfyi.com)

## Beverage FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [CocktailFYI](https://cocktailfyi.com) — 636 cocktails, ABV, calories, flavor profiles
- [VinoFYI](https://vinofyi.com) — Wines, grapes, regions, wineries, food pairings
- [BeerFYI](https://beerfyi.com) — 112 beer styles, hops, malts, yeast, BJCP
- [BrewFYI](https://brewfyi.com) — 72 coffee varieties, roasting, 21 brew methods
- [TeaFYI](https://teafyi.com) — 60 tea varieties, teaware, brewing guides
- [NihonshuFYI](https://nihonshufyi.com) — 80 sake, rice varieties, 50 breweries

## Full Index
- [Full content index](https://whiskeyfyi.com/llms-full.txt)
- [XML Sitemap](https://whiskeyfyi.com/sitemap.xml)