さけのわデータ
さけのわデータとは
日本酒アプリさけのわが保有するフレーバーを数値化したデータや人気銘柄情報を公開するプロジェクトです。利用規約の範囲で誰でも無料で利用することができ、ECサイトでデータを表示したり、アプリやサービスを作ったり、データ解析を行ったりすることができます。
データの種類
さけのわではユーザーの感想コメントを解析してフレーバーを数値化しています。このデータに加えてランキング情報を含む以下のデータを公開します。
- 銘柄ごとのフレーバーを華やか、芳醇、重厚、穏やか、軽快、ドライの6つの観点で数値化したもの
- 銘柄ごとのフレーバーの詳細をタグ化したもの (フレーバータグ)
- さけのわでの人気銘柄ランキング
- その他、銘柄の基本情報
データの利用例
さけのわアプリではこれらのデータを利用してこちらの画像のように銘柄ごとにフレーバーチャート (6角形のレーダーチャート) とフレーバータグを表示しています。
またフレーバーサーチ機能ではチャートを任意の形に設定してフレーバーチャートが近い銘柄を検索するために利用しています。
利用規約
さけのわデータにて提供されるデータを利用するのに必要なのは 帰属表示 (後述) だけです。
- ✅無料です
- ✅商用、非商用を問わず利用できます
- ✅データを加工して利用できます
以下に該当する場合はご利用いただけません。
- 🚫帰属表示を行わない場合
- 🚫さけのわのイメージを損なうような利用
- 🚫その他当社が不適切と判断した場合
帰属表示
帰属表示は次の点にご留意ください。
-
利用者にわかりやすく表示する
- さけのわデータを利用している箇所に併記する
- 1画面で何箇所も利用している場合は、表示を1箇所にまとめることができます
-
https://sakenowa.com へのリンクを表示する
- Webの場合: https://sakenowa.com にリンクする
- 印刷物の場合: https://sakenowa.com を記載する
- アプリの場合: https://sakenowa.com を開く手段を提供する
帰属表示の例
<a href="https://sakenowa.com">さけのわデータ</a>を利用しています
- さけのわデータ (https://sakenowa.com) のデータを加工して利用しています
連絡先
さけのわデータについてのご要望やお問い合わせは support@sakenowa.com までご連絡ください。
API
さけのわデータにはHTTP APIを通じてアクセスできます。
共通仕様
- レスポンスはjson形式です
- レスポンスのエンコーディングはUTF-8です
エンドポイント
- 地域一覧 (
GET /areas
) - 銘柄一覧 (
GET /brands
) - 蔵元一覧 (
GET /breweries
) - ランキング (
GET /rankings
) - フレーバーチャート (
GET /flavor-charts
) - フレーバータグ一覧 (
GET /flavor-tags
) - 銘柄ごとのフレーバータグ (
GET /brand-flavor-tags
)
地域一覧 (GET /api/areas
)
GET https://muro.sakenowa.com/sakenowa-data/api/areas
地域 (主に都道府県) のIDと名前の一覧
レスポンス
プロパティ | 内容 |
---|---|
areas | Area型配列 |
Area型
プロパティ | 内容 |
---|---|
id | 地域のID |
name | 地域名 |
例
{
"areas": [
{
"id": 1,
"name": "北海道"
},
{
"id": 2,
"name": "青森県"
}
]
}
銘柄一覧 (GET /brands
)
GET https://muro.sakenowa.com/sakenowa-data/api/brands
レスポンス
プロパティ | 内容 |
---|---|
brands | Brand型配列 |
Brand型
プロパティ | 内容 |
---|---|
id | 銘柄ID |
name | 銘柄名 |
breweryId | 蔵元ID (空の場合あり) |
例
{
"brands": [
{
"id": 4558,
"name": "越の一",
"breweryId": 1832
},
{
"id": 4611,
"name": "吉の川",
"breweryId": 1128
}
]
}
蔵元一覧 (GET /breweries
)
GET https://muro.sakenowa.com/sakenowa-data/api/breweries
レスポンス
プロパティ | 内容 |
---|---|
breweries | Brewery型配列 |
Brewery型
プロパティ | 内容 |
---|---|
id | 蔵元ID |
name | 蔵元名 |
areaId | 地域ID |
例
{
"breweries": [
{
"id": 1796,
"name": "麻原酒造",
"areaId": 9
},
{
"id": 1797,
"name": "阿部勘酒造",
"areaId": 4
}
]
}
ランキング (GET /rankings
)
GET https://muro.sakenowa.com/sakenowa-data/api/rankings
さけのわでの総合および地域ランキング
- 総合ランキング
- 全国のランキング
- 50件
- 地域ランキング
- 地域ごとのランキング
- 件数は地域によって異なる (ない場合もある)
レスポンス
プロパティ | 内容 |
---|---|
yearMonth | ランキングの対象年月 (YYYYMM形式) |
overall | 総合ランキング (RankingItem型の配列) |
areas | 地域ランキング (AreaRanking型の配列) |
RankingItem型
プロパティ | 内容 |
---|---|
rank | 順位。1位が最高 |
score | 人気の度合を5点満点で表現したもの。rankは本項目の降順で算出される |
brandId | 銘柄ID |
AreaRanking型
プロパティ | 内容 |
---|---|
areaId | 地域ID |
ranking | 地域ランキング (RankingItem型の配列) |
例
{
"yearMonth": "202007",
"overall": [
{
"rank": 1,
"score": 4.41221904754639,
"brandId": 109
},
{
"rank": 2,
"score": 4.11432790756226,
"brandId": 792
}
],
"areas": [
{
"areaId": 1,
"ranking": [
{
"rank": 1,
"score": 4.41221904754639,
"brandId": 8685
},
{
"rank": 2,
"score": 4.11443662643433,
"brandId": 1928
}
]
}
]
}
フレーバーチャート (GET /flavor-charts
)
GET https://muro.sakenowa.com/sakenowa-data/api/flavor-charts
銘柄ごとのフレーバーチャート。
レスポンス
プロパティ | 内容 |
---|---|
flavor-chart | FlavorChart型の配列 |
FlavorChart型
プロパティ | 内容 |
---|---|
brandId | 銘柄ID |
f1 | 華やか |
f2 | 芳醇 |
f3 | 重厚 |
f4 | 穏やか |
f5 | ドライ |
f6 | 軽快 |
例
{
"flavorChart": [
{
"brandId": 2,
"f1": 0.257238459795324,
"f2": 0.424835098066976,
"f3": 0.353698484182939,
"f4": 0.480473334729331,
"f5": 0.47061712325654,
"f6": 0.419411247406479
},
{
"brandId": 7,
"f1": 0.267467145120062,
"f2": 0.377822546680296,
"f3": 0.289076396929994,
"f4": 0.747658835061302,
"f5": 0.239046174961479,
"f6": 0.293273726798657
}
]
}
フレーバータグ一覧 (GET /flavor-tags
)
GET https://muro.sakenowa.com/sakenowa-data/api/flavor-tags
レスポンス
プロパティ | 内容 |
---|---|
tags | FlavorTag型の配列 |
FlavorTag型
カラム | 内容 |
---|---|
id | フレーバータグID |
name | フレーバータグ名 |
例
{
"tags": [
{
"id": 2,
"tag": "酸味"
},
{
"id": 3,
"tag": "辛口"
}
]
}
銘柄ごとのフレーバータグ (GET /brand-flavor-tags
)
GET https://muro.sakenowa.com/sakenowa-data/api/brand-flavor-tags
レスポンス
プロパティ | 内容 |
---|---|
flavorTags | BrandFlavorTag型の配列 |
BrandFlavorTag型
プロパティ | 内容 |
---|---|
brandId | 銘柄ID |
tagIds | フレーバータグID (数値型) の配列 |
例
{
"flavorTags": [
{
"brandId": 1,
"tagIds": [
50,
38,
12,
23,
36,
3,
34,
17,
2,
5
]
}
]
}