さけのわデータ

さけのわデータとは

日本酒アプリさけのわが保有するフレーバーを数値化したデータや人気銘柄情報を公開するプロジェクトです。利用規約の範囲で誰でも無料で利用することができ、ECサイトでデータを表示したり、アプリやサービスを作ったり、データ解析を行ったりすることができます。

データの種類

さけのわではユーザーの感想コメントを解析してフレーバーを数値化しています。このデータに加えてランキング情報を含む以下のデータを公開します。

  • 銘柄ごとのフレーバーを華やか、芳醇、重厚、穏やか、軽快、ドライの6つの観点で数値化したもの
  • 銘柄ごとのフレーバーの詳細をタグ化したもの (フレーバータグ)
  • さけのわでの人気銘柄ランキング
  • その他、銘柄の基本情報

データの利用例

さけのわアプリではこれらのデータを利用してこちらの画像のように銘柄ごとにフレーバーチャート (6角形のレーダーチャート) とフレーバータグを表示しています。

またフレーバーサーチ機能ではチャートを任意の形に設定してフレーバーチャートが近い銘柄を検索するために利用しています。

利用規約

さけのわデータにて提供されるデータを利用するのに必要なのは 帰属表示 (後述) だけです。

  • 無料です
  • 商用、非商用を問わず利用できます
  • データを加工して利用できます

以下に該当する場合はご利用いただけません。

  • 🚫帰属表示を行わない場合
  • 🚫さけのわのイメージを損なうような利用
  • 🚫その他当社が不適切と判断した場合

帰属表示

帰属表示は次の点にご留意ください。

  • 利用者にわかりやすく表示する

    • さけのわデータを利用している箇所に併記する
    • 1画面で何箇所も利用している場合は、表示を1箇所にまとめることができます
  • 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と名前の一覧

レスポンス

プロパティ内容
areasArea型配列

Area型

プロパティ内容
id地域のID
name地域名

{
  "areas": [
    {
      "id": 1,
      "name": "北海道"
    },
    {
      "id": 2,
      "name": "青森県"
    }
  ]
}

銘柄一覧 (GET /brands)

GET https://muro.sakenowa.com/sakenowa-data/api/brands

レスポンス

プロパティ内容
brandsBrand型配列

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

レスポンス

プロパティ内容
breweriesBrewery型配列

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-chartFlavorChart型の配列

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

レスポンス

プロパティ内容
tagsFlavorTag型の配列

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

レスポンス

プロパティ内容
flavorTagsBrandFlavorTag型の配列

BrandFlavorTag型

プロパティ内容
brandId銘柄ID
tagIdsフレーバータグID (数値型) の配列

{
  "flavorTags": [
    {
      "brandId": 1,
      "tagIds": [
        50,
        38,
        12,
        23,
        36,
        3,
        34,
        17,
        2,
        5
      ]
    }
  ]
}