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.

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

PyPI
pip install brewfyi

Coffee data API client — varieties, brew methods, quality scores

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