Developer Documentation
Japanese sake encyclopedia with brewery data, rice varieties, grades, and prefecture-based taxonomy. 80 sake products, 10 rice varieties, 50 breweries, 47 prefectures, 9 official sake grades (特定名称酒), yeast strains, serving temperatures, 10-axis flavor profiles, 101 guides, and glossary terms. All data sourced from NihonshuFYI — the Beverage FYI Family encyclopedia at nihonshufyi.com.
- 80 sake products with ABV, polishing ratio, SMV, acidity, and amino acid levels
- 9 official sake grades (特定名称酒): Junmai Daiginjo, Daiginjo, Junmai Ginjo, etc.
- 47 Japanese prefectures with regional grouping (Kanto, Kansai, Tohoku, etc.)
- 50 sake breweries (酒蔵) with founding year, toji school, and water source
- 10 sake rice varieties (酒造好適米) with shinpaku rate and polishing ratios
- 20+ yeast strains (協会酵母, proprietary, wild)
- Serving temperatures (冷酒, 常温, 燗酒) with recommended pairings
- 10-axis flavor profiles (fruity, floral, rice, umami, earthy, herbal, lactic, aged, sweet, dry)
- N² comparison pages: grade vs grade
- 101 educational guides across 15 series
- Glossary terms with Japanese terminology
- Interactive sake tools
- 15 languages supported
Quick Start
curl -s "https://nihonshufyi.com/api/v1/grades/junmai-daiginjo/"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/grades/ | List sake grades |
| GET | /api/v1/prefectures/ | List prefectures |
| GET | /api/v1/rice/ | List sake rice varieties |
| GET | /api/v1/yeast/ | List yeast strains |
| GET | /api/v1/breweries/ | List breweries |
| GET | /api/v1/sake/ | List sake products |
| GET | /api/v1/serving/ | List serving temperatures |
| GET | /api/v1/glossary-categories/ | List glossary categories |
| 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:
/grades/
Sake grades (特定名称酒) (e.g. /grades/)
/grades/{slug}/
Grade detail (e.g. /grades/junmai-daiginjo/)
/prefectures/
Japanese prefectures (e.g. /prefectures/)
/prefectures/{slug}/
Prefecture detail (e.g. /prefectures/niigata/)
/rice/
Sake rice varieties (e.g. /rice/)
/rice/{slug}/
Rice variety detail (e.g. /rice/yamadanishiki/)
/yeast/
Yeast strains (e.g. /yeast/)
/yeast/{slug}/
Yeast strain detail (e.g. /yeast/kyokai-7/)
/breweries/
Sake breweries (e.g. /breweries/)
/breweries/{slug}/
Brewery detail (e.g. /breweries/dassai/)
/sake/
All sake products (e.g. /sake/)
/sake/{slug}/
Sake detail (e.g. /sake/dassai-23/)
/serving/
Serving temperatures (e.g. /serving/)
/serving/{slug}/
Temperature detail (e.g. /serving/reishu/)
/compare/{slug_a}-vs-{slug_b}/
Compare two grades (e.g. /compare/junmai-daiginjo-vs-junmai-ginjo/)
/guides/
All guides (e.g. /guides/)
/guides/{slug}/
Guide detail (e.g. /guides/sake-tasting-101/)
/glossary/
Sake glossary (e.g. /glossary/)
/glossary/{slug}/
Glossary term detail (e.g. /glossary/seimaibuai/)
/tools/
Interactive tools (e.g. /tools/)
/tools/{slug}/
Tool page (e.g. /tools/smv-calculator/)
/search/
Search (e.g. /search/?q=daiginjo)
/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 nihonshufyi
Sake data API client — grades, breweries, rice varieties
npm install nihonshufyi
TypeScript sake data client
Embed Widget
Embed data cards on your site:
https://widget.nihonshufyi.com
npm install nihonshufyi-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.