# BeerFYI

> Beer encyclopedia with BJCP-based style taxonomy, ingredients, breweries, and N² pSEO. 113 beer styles with BJCP codes, 82 hops, 41 malts, 29 yeasts, 8K+ breweries, 150 guides, glossary terms, and interactive tools. All data sourced from BeerFYI — the Beverage FYI Family encyclopedia at beerfyi.com.

## Data Scope
- 113 beer styles with BJCP codes, OG/FG/IBU/SRM/ABV ranges
- 82 hop varieties with alpha acid ranges, flavor descriptors, and origin countries
- 41 malt types (base, specialty, adjunct) with SRM color and flavor contribution
- 29 yeast strains (ale, lager, wild, hybrid) with attenuation and temperature ranges
- 8,000+ breweries across multiple countries and regions
- Beer categories grouping related styles
- Brewing regions with country associations
- N² comparison pages: style vs style
- 150 educational guides across multiple series
- Glossary terms with definitions
- Interactive brewing 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).
- `/categories/` — Beer categories (e.g. `/categories/`)
- `/category/{slug}/` — Category detail (e.g. `/category/ale/`)
- `/styles/` — All beer styles (NOT /beer-styles/) (e.g. `/styles/`)
- `/style/{slug}/` — Beer style detail with BJCP data (e.g. `/style/american-ipa/`)
- `/countries/` — Beer countries (e.g. `/countries/`)
- `/country/{slug}/` — Country detail (e.g. `/country/germany/`)
- `/regions/` — Brewing regions (e.g. `/regions/`)
- `/region/{slug}/` — Region detail (e.g. `/region/bavaria/`)
- `/hops/` — All hop varieties (e.g. `/hops/`)
- `/hop/{slug}/` — Hop variety detail (e.g. `/hop/citra/`)
- `/malts/` — All malt types (e.g. `/malts/`)
- `/malt/{slug}/` — Malt detail (e.g. `/malt/pale-ale-malt/`)
- `/yeasts/` — All yeast strains (e.g. `/yeasts/`)
- `/yeast/{slug}/` — Yeast strain detail (e.g. `/yeast/us-05/`)
- `/breweries/` — All breweries (e.g. `/breweries/`)
- `/brewery/{slug}/` — Brewery detail (e.g. `/brewery/sierra-nevada/`)
- `/compare/{slug_a}-vs-{slug_b}/` — Compare two styles (e.g. `/compare/american-ipa-vs-english-ipa/`)
- `/guide/` — All guides (e.g. `/guide/`)
- `/guide/{slug}/` — Guide detail (e.g. `/guide/intro-to-hops/`)
- `/glossary/` — Beer glossary (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term detail (e.g. `/glossary/dry-hopping/`)
- `/tools/` — Interactive tools (e.g. `/tools/`)
- `/tools/{slug}/` — Tool page (e.g. `/tools/abv-calculator/`)
- `/search/` — Search (e.g. `/search/?q=ipa`)
- `/developers/` — API documentation (e.g. `/developers/`)

## Browse Beer
- [Beer Styles (113)](https://beerfyi.com/styles/)
- [Categories](https://beerfyi.com/categories/)
- [Countries](https://beerfyi.com/countries/)
- [Regions](https://beerfyi.com/regions/)
- [Breweries (8K+)](https://beerfyi.com/breweries/)

## Ingredients
- [Hops (82)](https://beerfyi.com/hops/)
- [Malts (41)](https://beerfyi.com/malts/)
- [Yeasts (29)](https://beerfyi.com/yeasts/)

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

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

## REST API

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

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/categories/` | List beer categories |
| GET | `/api/v1/styles/` | List beer styles with BJCP data |
| GET | `/api/v1/countries/` | List countries |
| GET | `/api/v1/regions/` | List brewing regions |
| GET | `/api/v1/hops/` | List hop varieties |
| GET | `/api/v1/malts/` | List malt types |
| GET | `/api/v1/yeasts/` | List yeast strains |
| GET | `/api/v1/breweries/` | List breweries |
| 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://beerfyi.com/api/v1/styles/american-ipa/"
```

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

## Developer Tools
- **PyPI**: `pip install beerfyi` — [beerfyi](https://pypi.org/project/beerfyi/) — Beer style data API client — BJCP styles, hops, malts
- **Embed Widget**: [beerfyi-embed](https://widget.beerfyi.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
- [BrewFYI](https://brewfyi.com) — 72 coffee varieties, roasting, 21 brew methods
- [WhiskeyFYI](https://whiskeyfyi.com) — 80 whiskey expressions, distilleries, regions
- [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://beerfyi.com/llms-full.txt)
- [XML Sitemap](https://beerfyi.com/sitemap.xml)