Developer Documentation
Coffee encyclopedia with CQI quality data, FAOSTAT production stats, and flavor taxonomy. 72 coffee varieties, 21 brew methods, 1,340 CQI Q-grader samples, 4,800 FAOSTAT production records, 3-tier flavor taxonomy (9 categories, 30 subcategories, 85 descriptors), 150 guides, glossary terms, and interactive tools. All data sourced from BrewFYI — the Beverage FYI Family encyclopedia at brewfyi.com.
- 72 coffee varieties with species, genetic group, altitude, and quality ratings
- 21 brew methods with time, temperature, grind size, and difficulty
- 1,340 CQI Q-grader quality samples with 10-axis scoring (aroma, flavor, aftertaste, acidity, body, balance, uniformity, clean cup, sweetness, overall)
- 4,800 FAOSTAT production statistics by country and year
- 3-tier flavor taxonomy: 9 categories, 30 subcategories, 85 descriptors (SCA flavor wheel)
- Coffee species with caffeine content and production share
- Growing regions with altitude, climate, soil, and harvest months
- Processing methods (natural, washed, honey, etc.) with flavor impact
- Roast levels with Agtron numbers and temperature ranges
- Countries with production data and growing regions
- N² comparison pages: variety vs variety
- 150 educational guides
- Glossary terms with definitions
- Interactive coffee tools
- 15 languages supported
Quick Start
curl -s "https://brewfyi.com/api/v1/varieties/bourbon/"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/species/ | List coffee species |
| GET | /api/v1/varieties/ | List coffee varieties |
| GET | /api/v1/countries/ | List countries |
| GET | /api/v1/regions/ | List growing regions |
| GET | /api/v1/processing-methods/ | List processing methods |
| GET | /api/v1/roast-levels/ | List roast levels |
| GET | /api/v1/brew-methods/ | List brew methods |
| 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:
/varieties/
All coffee varieties (e.g. /varieties/)
/variety/{slug}/
Variety detail (e.g. /variety/bourbon/)
/countries/
Coffee countries (e.g. /countries/)
/country/{slug}/
Country detail (e.g. /country/ethiopia/)
/origins/
Growing regions (e.g. /origins/)
/origin/{slug}/
Region detail (e.g. /origin/yirgacheffe/)
/species/
Coffee species (e.g. /species/)
/species/{slug}/
Species detail (e.g. /species/arabica/)
/processing/
Processing methods (e.g. /processing/)
/processing/{slug}/
Processing method detail (e.g. /processing/natural/)
/roasting/
Roast levels (e.g. /roasting/)
/roasting/{slug}/
Roast level detail (e.g. /roasting/medium/)
/methods/
Brew methods (e.g. /methods/)
/method/{slug}/
Brew method detail (e.g. /method/pour-over/)
/flavors/
Flavor explorer (SCA flavor wheel) (e.g. /flavors/)
/compare/{slug_a}-vs-{slug_b}/
Compare two varieties (e.g. /compare/bourbon-vs-typica/)
/guide/
All guides (e.g. /guide/)
/guide/{slug}/
Guide detail (e.g. /guide/pour-over-basics/)
/glossary/
Coffee glossary (e.g. /glossary/)
/glossary/{slug}/
Glossary term detail (e.g. /glossary/extraction/)
/tools/
Interactive tools (e.g. /tools/)
/tools/{slug}/
Tool page (e.g. /tools/brew-ratio-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 brewfyi
Coffee data API client — varieties, brew methods, quality scores
npm install brewfyi
TypeScript coffee data client
Embed Widget
Embed data cards on your site:
https://widget.brewfyi.com
npm install brewfyi-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.