さけのわ

さけのわデータプロジェクト

さけのわデータとは

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