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.

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

PyPI
pip install nihonshufyi

Sake data API client — grades, breweries, rice varieties

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