hotpepperbeauty/api/salon/v1

サロンサーチAPI

登録されているヘアサロンを検索して一覧を取得します。

ホットペッパーBeauty Webサービス

api URL

api url
http://webservice.recruit.co.jp/beauty/salon/v1/
format
json / jsonp / xml
method
GET
認証
ApiKey
実行制限
なし
公式ドキュメント
http://webservice.recruit.co.jp/beauty/reference.html#a1to

parameter set

parameter value 省略 説明
key
MyApiKey-key をセット
必須 APIキー。アカウント登録時に取得したキー。
[MyApiKey-key]を指定すると、Apiキーを預けるで設定されたApiキーに自動変換します。
id サロンID。
name サロン名。部分一致検索。
name_kana サロン名かな。部分一致検索。
address サロンの住所。部分一致検索。
service_area サービスエリアコード。カンマ区切りで複数指定可能。OR検索。
middle_area 中エリアコード。カンマ区切りで複数指定可能。OR検索。
small_area 中エリアコード。カンマ区切りで複数指定可能。OR検索。
feature 特集コード。特殊記法でOR検索
feature_detail 特集詳細コード。特殊記法でOR検索
keyword フリーワード検索。部分一致。サロン名、サロン名かな、住所、キャッチなど。
lat 緯度。
lng 経度。
range 緯度経度からの範囲。省略時は1000m。
datum 測地系。省略時は世界測地系。
hair_image 髪のイメージコード。複数指定時の特殊記法
hair_length 髪の長さコード。複数指定時の特殊記法
hair_ryou 髪の量コード。複数指定時の特殊記法
1: 少ない
2: 普通
3: 多い
hair_shitsu 髪質コード。複数指定時の特殊記法
1: 柔かい
2: 普通
3: 硬い
hair_futosa 髪の太さコード。複数指定時の特殊記法
1: 細い
2: 普通
3: 太い
hair_kuse 髪のクセコード。複数指定時の特殊記法
1: なし
2: 少し
3: 強い
hair_kaogata 顔型コード。複数指定時の特殊記法
1: 丸型
2: 卵型
3: 四角
4: 逆三角
5: ベース
kodawari こだわり条件コード。複数指定時の特殊記法
kodawari_setsubi こだわり設備条件コード。複数指定時の特殊記法
kodawari_menu こだわりメニュー条件コード。複数指定時の特殊記法
order 並び順。省略時はランダム。位置検索の場合は常に距離順。
start 取得開始位置。1以上の整数。
count 1ページあたりの取得件数。1~100の範囲。省略時は10。
format 出力形式。

取得形式 :

call results

[call update]ボタンを押してください。ここに結果が表示されます。

  • このデータは、jsonpで取得しjabascriptオブジェクトに変換されたものを再度json形式に変換した結果です。
  • 受信されるデータと厳密に同じでないことをご理解ください。

発行したAPIのURLとパラメータ

下記のURLで、本ページの各パラメータに自動的にセットされます。

開発メンバー間でパラメータの指定例をメールで送信したり、ブログやホームページでApiの説明を書く際にお使いください。
※パラメータにApiキーなどが含まれる場合はご注意ください。

  • javascriptでは桁数の大きな数値で値がズレることがあります。
  • 例えば、twitterの id_str と id です。
  • id_str は文字列型ですので正しい値が表示されます。
  • id は数値型です。桁数が大きな場合、 +-1のズレが発生することがあります。
  • id_str と id が異なる場合は、id_str を信用してください。
  • 試しに下記をクリックして実行してみてください。期待する値がalertされるでしょうか?
  • javascript:eval('var a = 13782936788668417, b = \'13782936788668417\';'); alert(a+' : 数値型'+'\n\n'+b+' : 文字列型');
  • 本サイトでは、javascriptで処理をしている関係上、apiから取得してきたデータと異なることがあります。
  • あらかじめご理解・ご了承ください。