さけのわデータ

さけのわデータとは

日本酒アプリさけのわが保有するフレーバーを数値化したデータや人気銘柄情報を公開するプロジェクトです。利用規約の範囲で誰でも無料で利用することができ、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
    }
  ]
}

プロパティ	内容
yearMonth	ランキングの対象年月 (YYYYMM形式)
overall	総合ランキング (RankingItem型の配列)
areas	地域ランキング (AreaRanking型の配列)

プロパティ	内容
rank	順位。1位が最高
score	人気の度合を5点満点で表現したもの。rankは本項目の降順で算出される
brandId	銘柄ID

プロパティ	内容
areaId	地域ID
ranking	地域ランキング (RankingItem型の配列)

フレーバーチャート (`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
      ]
    }
  ]
}