jalan/api/advance/hotel_search/v1

宿表示API　アドバンス

宿泊施設の一覧を取得します。

じゃらん Web サービス

api URL

api url
http://jws.jalan.net/APIAdvance/HotelSearch/V1/
format
xml
method
GET
認証
不要
実行制限
なし
公式ドキュメント
http://www.jalan.net/jw/jwp0100/jww0102.do

parameter set

parameter value 省略 説明
key
MyApiKey-key をセット 		必須 APIキー。アカウント登録時に取得したキー。
[MyApiKey-key]を指定すると、Apiキーを預けるで設定されたApiキーに自動変換します。
reg 可 広域コード。エリア検索APIで取得できる。
pref 可 都道府県コード。エリアコード対応表もしくはエリア検索APIで取得できる。
l_area 可 大エリアコード。エリアコード対応表もしくはエリア検索APIで取得できる。
s_area 可 小エリアコード。エリアコード対応表もしくはエリア検索APIで取得できる。
h_id 可 宿番号。指定した場合は他の検索条件は無視される。最大10件まで可能。
o_area_id 可 温泉地コード。温泉検索APIのレスポンス OnsenAreaID を使用。
o_id 可 温泉コード。温泉検索APIのレスポンス OnsenID を使用。
x 可 経度。日本測地系（ミリ秒） 439200000 ～ 554400000 の範囲。
y 可 緯度。日本測地系（ミリ秒） 72000000 ～ 165600000の範囲。
range 可 x,y指定時必須。x,yの地点からの検索範囲。0.1 ～ 10で指定。Km単位。
h_name 可 宿名。半角スペース区切りでAND検索。4ワードまで。
stay_date 可 宿泊開始日。yyyymmdd形式。
stay_count 可 宿泊日数。1～9までの整数。
room_count 可 予約する部屋数。1～10までの整数。
adult_num 可 1室あたりに宿泊する大人の人数。1～10までの整数。
sc_num 可 1室あたりに宿泊する小学生の人数。0～5までの整数。
lc_num_bed_meal 可 1室あたりに宿泊する幼児（食事・布団あり）の人数。0～5までの整数。
lc_num_meal_only 可 1室あたりに宿泊する幼児（食事あり）の人数。0～5までの整数。
lc_num_bed_only 可 1室あたりに宿泊する幼児（布団あり）の人数。0～5までの整数。
lc_num_no_bed_meal 可 1室あたりに宿泊する幼児（食事・布団なし）の人数。0～5までの整数。
min_rate 可 1泊 1室あたりの料金の下限。
1 ～ 1000000000までの整数。
max_rate 可 1泊 1室あたりの料金の上限。
1 ～ 1000000000までの整数。
h_type 可 宿泊施設のタイプで絞り込みを行うかどうか。
o_pool 可 「施設内に屋外プールがある宿泊施設」で絞り込むかどうか。
parking 可 「駐車場が無料の宿泊施設」で絞り込むかどうか。
pub_bath 可 「館内に内湯・大浴場がある宿泊施設」で絞り込むかどうか。
onsen 可 「温泉がある宿泊施設」で絞り込むかどうか。
prv_bath 可 「貸切風呂がある宿泊施設」で絞り込むかどうか。
v_bath 可 「展望風呂がある宿泊施設」で絞り込むかどうか。
sauna 可 「サウナ設備がある宿泊施設」で絞り込むかどうか。
jacz 可 「ジャグジー設備がある宿泊施設」で絞り込むかどうか。
mssg 可 「マッサージサービスがある、もしくは、手配可能な宿泊施設」で絞り込むかどうか。
r_ski 可 「館内・敷地内に宿泊者向けに貸しスキーがある宿泊施設」で絞り込むかどうか。
r_brd 可 「館内・敷地内に宿泊者向けに貸しスノーボードがある宿泊施設」で絞り込むかどうか。
pet 可 「施設にペット同伴可能な宿泊施設」で絞り込むかどうか。
esthe 可 「エステ設備が施設内か近隣にある、もしくはエステサービスを手配可能な宿泊施設」で絞り込むかどうか。
p_pong 可 「館内に卓球台が設置されている宿泊施設」で絞り込むかどうか。
limo 可 「最寄の駅からの送迎サービスがある宿泊施設」で絞り込むかどうか。
room_b 可 「部屋で朝食が食べられる宿泊施設」で絞り込むかどうか。
room_d 可 「部屋で夕食が食べられる宿泊施設」で絞り込むかどうか。
prv_b 可 「食事専用の個室で朝食が食べられる宿泊施設」で絞り込むかどうか。
prv_d 可 「食事専用の個室で夕食が食べられる宿泊施設」で絞り込むかどうか。
early_in 可 「チェックインが14時以前の宿泊プランのある宿泊施設」で絞り込むかどうか。
late_out 可 「チェックアウトが11時以降の宿泊プランのある宿泊施設」で絞り込むかどうか。
no_smk 可 「禁煙ルームのある宿泊施設」で絞り込むかどうか。
net 可 「部屋でインターネットが利用できる宿泊プランのある宿泊施設」で絞り込むかどうか。
r_room 可 「露天風呂付き客室に泊まれる宿泊プランのある宿泊施設」で絞り込むかどうか。
high 可 「じゃらんnet編集部が設けた一定の基準を満たした高級感・上質感のある宿泊施設」で絞り込むかどうか。
p_ok 可 「じゃらんポイント割引が利用できる宿泊施設」で絞り込むかどうか。
sp_room 可 「特別室・離れ・スイートのいずれかに宿泊できる宿泊プランのある宿泊施設」で絞り込むかどうか。
bath_to 可 「客室内にバス・トイレが付いている宿泊プランのある宿泊施設」で絞り込むかどうか。
o_bath 可 「露天風呂のある宿泊施設」で絞り込むかどうか。
pour 可 「天然温泉掛け流しの温泉のある宿泊施設」で絞り込むかどうか。
cloudy 可 「にごり湯の温泉のある宿泊施設」で絞り込むかどうか。
i_pool 可 「施設内に屋内プールがある宿泊施設」で絞り込むかどうか。
fitness 可 「施設内にフィットネスジムがある宿泊施設」で絞り込むかどうか。
gym 可 「施設内に体育館がある宿泊施設」で絞り込むかどうか。
p_field 可 「施設内にグラウンドがある宿泊施設」で絞り込むかどうか。
bbq 可 「施設内にバーベキュー施設がある宿泊施設」で絞り込むかどうか。
hall 可 「施設内に宴会場がある宿泊施設」で絞り込むかどうか。
5_station 可 「最寄り駅から徒歩5分以内にある宿泊施設」で絞り込むかどうか。
5_beach 可 「最寄りのビーチから徒歩5分以内にある宿泊施設」で絞り込むかどうか。
5_slope 可 「最寄りのゲレンデから徒歩5分以内にある宿泊施設」で絞り込むかどうか。
c_card 可 「クレジットカードが利用可能な宿泊施設」で絞り込むかどうか。
c_jcb 可 「クレジットカード（JCB）が利用可能な宿泊施設」で絞り込むかどうか。
c_visa 可 「クレジットカード（VISA）が利用可能な宿泊施設」で絞り込むかどうか。
c_master 可 「クレジットカード（Master）が利用可能な宿泊施設」で絞り込むかどうか。
c_amex 可 「クレジットカード（AMEX）が利用可能な宿泊施設」で絞り込むかどうか。
c_uc 可 「クレジットカード（UC）が利用可能な宿泊施設」で絞り込むかどうか。
c_dc 可 「クレジットカード（DC）が利用可能な宿泊施設」で絞り込むかどうか。
c_nicos 可 「クレジットカード（NICOS）が利用可能な宿泊施設」で絞り込むかどうか。
c_diners 可 「クレジットカード（ダイナース）が利用可能な宿泊施設」で絞り込むかどうか。
c_saison 可 「クレジットカード（セゾン）が利用可能な宿泊施設」で絞り込むかどうか。
c_ufj 可 「クレジットカード（UFJ）が利用可能な宿泊施設」で絞り込むかどうか。
cvs 可 「最寄のコンビニまで徒歩5分以内の宿泊施設」で絞り込むかどうか。
no_meal 可 「食事なしの宿泊プランのある宿泊施設」で絞り込むかどうか。
b_only 可 「朝食のみの宿泊プランのある宿泊施設」で絞り込むかどうか。
d_only 可 「夕食のみの宿泊プランのある宿泊施設」で絞り込むかどうか。
2_meals 可 「朝食、夕食付きの宿泊プランのある宿泊施設」で絞り込むかどうか。
sng_room 可 「シングルベッド（幅100cm程度）、もしくはセミダブルベッド（幅120cm程度）が1つ設置されている客室のある宿泊施設」で絞り込むかどうか。
twn_room 可 「ベッド（ベッド幅は問わない）が2つ設置されている客室のある宿泊施設」で絞り込むかどうか。
dbl_room 可 「ダブルベッド（幅140cm程度）が1つ設置されている客室のある宿泊施設」で絞り込むかどうか。
tri_room 可 「ベッド（ベッド幅は問わない）が3つ設置されている客室のある宿泊施設」で絞り込むかどうか。
4bed_room 可 「ベッド（ベッド幅は問わない）が4つ設置されている客室のある宿泊施設」で絞り込むかどうか。
jpn_room 可 「畳敷きの客室がある宿泊施設」で絞り込むかどうか。
j_w_room 可 「洋室部分にベッドが設置され、和室・洋室部分どちらにも寝泊まりできる客室がある宿泊施設」で絞り込むかどうか。
child_price 可 「子供の宿泊料金設定がある宿泊施設」で絞り込むかどうか。
c_sc 可 「小学生向けに宿泊料金設定がある宿泊施設」で絞り込むかどうか。
c_bed_meal 可 「幼児向けに布団・食事ともにある宿泊施設」で絞り込むかどうか。
c_no_bed_meal 可 「幼児向けに布団・食事ともにない宿泊施設」で絞り込むかどうか。
c_meal_only 可 「幼児向けの食事がある宿泊施設」で絞り込むかどうか。
c_bed_only 可 「幼児向けの布団がある宿泊施設」で絞り込むかどうか。
pict_size 可 宿泊施設の画像のサイズを指定。画像のサンプル
picts 可 出力する写真の個数。1~5
order 可 並び順。
start 可 該当結果全体に対して、何番目の結果から出力するか。整数。
count 可 １回のコールで何件分取得するか。1～100までの整数。
xml_ptn 可 レスポンスフィールドに出力される項目の範囲。

取得形式 :

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から取得してきたデータと異なることがあります。
  • あらかじめご理解・ご了承ください。