Developer Documentation
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.
- 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
Quick Start
curl -s "https://beerfyi.com/api/v1/styles/american-ipa/"
API Endpoints
| 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 |
URL Patterns
Use these patterns to construct URLs programmatically:
/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/)
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 beerfyi
Beer style data API client — BJCP styles, hops, malts
Embed Widget
Embed data cards on your site:
https://widget.beerfyi.com
npm install beerfyi-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.