じゃらん 宿・ホテル予約サイト
 じゃらんnetトップ じゃらんnetのご利用方法 ご要望・お問合せ
宿・ホテル予約TOP > じゃらんWebサービス > 海外ホテル 空室検索API

じゃらんWebサービス/海外ホテル 空室検索API

じゃらんWebサービス 海外ホテル 空室検索API

海外ホテル 空室検索APIは、じゃらんnetに公開されている海外の宿泊施設の空室情報を検索する機能を提供します。

リクエストURL

http://jws.jalan.net/rs/rsp0100/Rst0153Action.do

リクエストパラメーター

パラメーター 項目名 説明 必須
key APIキー APIを利用するためのキーです。
アカウント登録時に割り当てられるAPIキーを指定してください。
半角英数字16桁以下
l_area 大エリアコード 地域 大エリアCD(海外用)を指定。 いずれか必須 半角英数字3桁
s_area 小エリアコード 地域 小エリアCD(海外用)を指定。小エリアのみ指定の場合は、大エリアをマスタから取得する 半角英数字6桁
x 経度 ある地点からの範囲内のホテルの検索を行う場合の経度です。 地点、範囲検索を行う場合、x、y、range必須 世界測地系(ミリ秒)
-158.10.27.412
例(西経 158度 10分 24.412秒 / -157.825719)= -568172588
y 緯度 ある地点からの範囲内のホテルの検索を行う場合の緯度です。 世界測地系(ミリ秒)

例(北緯 21度 16分 52.445秒 / 21.2812347)= 76612445
range 範囲 ある地点からの範囲内の宿の検索を行う場合の範囲です。
緯度(y)、経度(x)を中心に東西南北に伸びる距離を指定してください。
0.1 〜 10までの半角数字
小数点第一位まで
単位:km
h_name ホテル名 ホテル名の検索を行います。
※ この項目を指定した場合、宿泊開始日(stay_date)は指定できません。
全角・半角
※ 日本語を指定する場合は、文字コードをUTF-8にしてください。
stay_date 宿泊開始日 宿泊開始日を指定します。 日付(yyyymmdd形式)
※ 値を省略した場合は、宿泊日未定で検索を行います。
宿泊日未定で検索の場合、宿泊数の値は無視されます。
日付は現時日時で指定されます。
stay_count 宿泊数 宿泊日数を指定します。 1 〜 9 までの半角数字
初期値:1
room_count 部屋数 予約する部屋数を指定します。 1 〜 10 までの半角数字
初期値:1
adult_num 1室あたりの大人人数 1室あたりに宿泊する大人の人数を指定します。 1 〜 10 までの半角数字
初期値:1
sc_num 1室あたりの子供人数 - 小学生 1室あたりに宿泊する小学生の人数を指定します。 0 〜 5 までの半角数字
初期値:0
lc_num_bed_meal 1室あたりの子供人数 - 幼児(食事・布団あり) 1室あたりに宿泊する幼児(食事・布団あり)の人数を指定します。 0 〜 5 までの半角数字
初期値:0
lc_num_meal_only 1室あたりの子供人数 - 幼児(食事あり) 1室あたりに宿泊する幼児(食事あり)の人数を指定します。 0 〜 5 までの半角数字
初期値:0
lc_num_bed_only 1室あたりの子供人数 - 幼児(布団あり) 1室あたりに宿泊する幼児(布団あり)の人数を指定します。 0 〜 5 までの半角数字
初期値:0
lc_num_no_bed_meal 1室あたりの子供人数 - 幼児(食事・布団なし) 1室あたりに宿泊する幼児(食事・布団なし)の人数を指定します。 0 〜 5 までの半角数字
初期値:0
min_rate 予算下限 1泊 1室あたりの料金の下限を指定します。 1 〜 1000000000 までの半角数字
初期値:下限なし
max_rate 予算上限 1泊 1室あたりの料金の上限を指定します。 1 〜 1000000000 までの半角数字
初期値:上限なし
o_pool 屋外プール 「施設内に屋外プールがある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
bath_tb バスタブ付き 「バスタブ設備がある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
sauna サウナ 「サウナ設備がある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
jacz ジャグジー 「ジャグジー設備がある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
mssg マッサージ 「マッサージサービスがある、もしくは、手配可能な宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
esthe エステ設備 「エステ設備が施設内か近隣にある、もしくはエステサービスを手配可能な宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
limo 送迎あり 「最寄の駅からの送迎サービスがある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
p_ok ポイント割引OKの宿 「じゃらんポイント割引が利用できる宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
p_5_only ポイント5%宿のみ表示 「じゃらんポイントが5%付与される宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
5_station 駅から徒歩5分 「最寄り駅から徒歩5分以内にある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
5_beach ビーチから徒歩5分 「最寄りのビーチから徒歩5分以内にある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
c_card クレジットカードが利用可能 「クレジットカードが利用可能な宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
c_jcb クレジットカード(JCB)が利用可能 「クレジットカード(JCB)が利用可能な宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
c_visa クレジットカード(VISA)が利用可能 「クレジットカード(VISA)が利用可能な宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
c_master クレジットカード(master)が利用可能 「クレジットカード(master)が利用可能な宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
c_amex クレジットカード(AMEX)が利用可能 「クレジットカード(AMEX)が利用可能な宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
c_diners クレジットカード(ダイナース)が利用可能 「クレジットカード(ダイナース)が利用可能な宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
room_b 部屋で朝食 「部屋で朝食が食べられる宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
room_d 部屋で夕食 「部屋で夕食が食べられる宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
prv_b 個室で朝食 「食事専用の個室で朝食が食べられる宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
prv_d 個室で夕食 「食事専用の個室で夕食が食べられる宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
early_in チェックイン14時以前 「チェックインが14時以前の宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
late_out チェックアウト11時以降 「チェックアウトが11時以降の宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
no_smk 禁煙ルーム 「禁煙ルームの宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
net 部屋でインターネットOK 「部屋でインターネットが利用できる宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
no_meal 食事なしプラン 「食事なしの宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
b_only 朝食のみプラン 「朝食のみの宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
d_only 夕食のみプラン 「夕食のみの宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
2_meals 朝夕食付プラン 「朝食、夕食付きの宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
sng_room シングルルーム 「シングルベッド(幅100cm程度)、もしくはセミダブルベッド(幅120cm程度)が1つ設置されている客室の宿泊プラン」という条件で絞込みを行うかどうかを指定します。
スタジオツインは「シングル」扱いとしています。
0:絞り込まない(初期値)
1:絞り込む
twn_room ツインルーム 「ベッド(ベッド幅は問わない)が2つ設置されている客室の宿泊プラン」という条件で絞込みを行うかどうかを指定します。
1台がエキストラベッドの場合はシングルとしています。
0:絞り込まない(初期値)
1:絞り込む
dbl_room ダブルルーム 「ダブルベッド(幅140cm程度)が1つ設置されている客室の宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
tri_room トリプルルーム 「ベッド(ベッド幅は問わない)が3つ設置されている客室の宿泊プラン」という条件で絞込みを行うかどうかを指定します。
1台がエキストラベッドの場合はツインとしています。
0:絞り込まない(初期値)
1:絞り込む
4bed_room 4ベッドルーム 「ベッド(ベッド幅は問わない)が4つ設置されている客室の宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
c_sc 小学生料金設定あり 「小学生向けに宿泊料金設定がある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
c_bed_meal 幼児向けに布団・食事ともにあり 「幼児向けに布団・食事ともにある宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
c_no_bed_meal 幼児向けに布団・食事ともになし 「幼児向けに布団・食事ともにない宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
c_meal_only 幼児向けに食事のみあり 「幼児向けの食事のある宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
c_bed_only 幼児向けに布団のみあり 「幼児向けの布団のある宿泊プラン」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
hotelcs_5 ホテルクラス:クラス5 「ホテルクラス:クラス5の宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
hotelcs_4 ホテルクラス:クラス4 「ホテルクラス:クラス4の宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
hotelcs_3 ホテルクラス:クラス3 「ホテルクラス:クラス3の宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
hotelcs_2ud ホテルクラス:クラス2以下 「ホテルクラス:クラス2以下の宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
pict_size 画像サイズ 宿泊プランの画像のサイズを指定します。 0:pictSS
1:pictS
2:pict
3:pictM(初期値)
4:pictL
5:pictLL

画像のサンプルは こちらをご覧ください。
picts 宿画像個数 出力される宿泊プランの画像の出力個数を指定します。 1 〜 3までの半角数字。
初期値:1
order 並び順 出力されるデータの並び順を指定します。 0:宿番号順(初期値)
1:プラン名 50音順
start 表示From 出力されるデータの何件目から表示するかを指定します。 半角数字。
初期値:1
count 表示件数 出力されるデータの最大出力件数を指定します。
該当件数が出力件数よりも少ない場合は、全て表示されます。
1 〜 100までの半角数字。
初期値:10

サンプルリクエストURL

http://jws.jalan.net/rs/rsp0100/Rst0153Action.do?key=**********&s_area=H24010
&stay_count=3&adult_num=2&count=5

※ keyの「**********」を取得したAPIキーに置き換えて実行してください。

レスポンスフィールド

フィールド 説明 出現回数
Results - - 1 -
NumberOfResults 該当件数 半角数字 1 9
DisplayPerPage 表示件数 半角数字 1 1
DisplayFrom 表示From 半角数字 1 1
APIVersion APIバージョン 半角数字・記号 1 1.0
Plan - - 表示件数分 -
PlanName プラン名 全角・半角 1 ワイキキ満喫♪ルームオンリープラン
PlanCD プランCD 半角数字 1 01036650
RoomName 部屋名 全角・半角 1 【29平米】キチネット付ストゥディオ
RoomCD 部屋タイプCD 半角 1 0010884
RoomType 部屋種類 全角・半角 1 禁煙ルーム
PlanDetailURL プラン詳細ページURL(宿泊条件指定なし) 半角英数記号(URL) 1 http://www.jalan.net/JwsRedirect.do?
key=**************
&rd_key=MzAwNjI0ICAgIDAwMDE=
PlanCommonDetailURL じゃらんプラン詳細URL 半角英数記号(URL) 1 http://www.jalan.net/JwsRedirect.do?
key=**************
&rd_key=MzAwNjI0ICAgIDAwMDE=
Facilities - - 1 -
Facility 部屋設備 全角・半角 部屋設備数分 トイレ
PlanCheckIn チェックイン 半角 1 15:00
PlanCheckOut チェックアウト 半角 1 10:00
PlanPictureURL プラン画像URL 半角英数記号(URL) 3 http://www.jalan.net/jalan/images/
pictM/Y4/Y300624/Y300624003.jpg
PlanPictureCaption プラン画像説明 全角・半角 3 ダイヤモンドヘッドタワー・ガーデン・キング
Meal 食事条件 全角・半角 1 朝/夕あり
RateType 料金タイプ 全角・半角
「大人 1名あたり」あるいは「1室あたり」
1 大人 1名あたり
SampleRateDispEng 参考料金(現地通貨・通貨表記有) 半角数字 1 219.00USD
SampleRateEng 参考料金(現地通貨) 半角数字 1 219.00
SampleRate 参考料金(日本円) 半角数字 1 6300
Stay ※ 宿泊日未定の場合は、出力されません - 宿泊日分 -
PlanDetailURL プラン詳細ページURL(宿泊条件指定あり) 半角英数記号(URL) 1 http://www.jalan.net/JwsRedirect.do?
key=**************
&rd_key=MzAwNjI0ICAgIDAwMDE=
Date - - 宿泊数分 -
date 宿泊日(日) 半角数字 1 30
month 宿泊日(月) 半角数字 1 01
year 宿泊日(年) 半角数字 1 2007
RateDispEng 1室1泊あたりの料金(現地通貨・通貨表記あり) 半角数字 1 219.00USD
RateEng 1室1泊あたりの料金(現地通貨) 半角数字 1 219.00
Rate 1室1泊あたりの料金(日本円) 半角数字 1 9600
Stock 空き室数
※ 空き室数が10部屋以上ある場合は、空要素となります。
半角数字 1 9
Hotel - - 1 -
HotelID 宿番号 半角数字 1 300624
HotelName 宿名漢字 全角・半角 1 ハワイ ジャラン リゾート アンド スパ
HotelNameEng 宿名英字 全角・半角 1 Hawaii Jalan Resort & Spa
HotelGrade ホテルクラス 半角数字 1 3
PostCode 各国郵便番号 半角数字・記号 1 96815
HotelAddress 住所 全角・半角 1 ハワイ州 ホノルル カリア ロード 2005
Area - - 1 -
Region 地域_広域エリア漢字名 全角・半角 1 ハワイ/グアム
Prefecture 地域_都道府県漢字名 全角・半角 1 ハワイ/グアム
LargeArea 地域_大エリア漢字名 全角・半角 1 オアフ島
SmallArea 地域_小エリア漢字名 全角・半角 1 ワイキキ/アラモアナ/カハラ(ホノルル)
HotelType 宿種名
※海外ホテルの場合は「ホテル」のみを出力します
全角・半角 1 ホテル
HotelDetailURL 宿詳細ページURL 半角英数記号(URL) 1 http://www.jalan.net/JwsRedirect.do?
key=**************
&rd_key=MzAwNjI0ICAgIDAwMDE=
HotelCatchCopy キャッチ 全角漢字 1 ワイキキビーチに面した約9万平米の敷地に建つリゾートホテル
HotelCaption コピー 全角漢字 1 ワイキキ最大の広さを誇るビーチに建つ9万平米の広大な敷地の中に美しい緑と滝が広がるトロピカルガーデンがあり、ペンギンをはじめとする70種類以上の鳥達が暮らす、まさに究極のリゾートホテルです。
PictureURL 宿画像URL 半角英数記号(URL) 1 http://www.jalan.net/jalan/images/ pictM/8/00218/00218461.jpg
PictureCaption 宿画像キャプション 全角・半角 1 ホテルの外観パノラマ
X 経度(ミリ秒)
※ 緯度・経度は世界測地系の値です。
半角数字・記号 1 -568172588
Y 緯度(ミリ秒)
※ 緯度・経度は世界測地系の値です。
半角数字・記号 1 76612445
HotelNameKana 宿名かな 全角かな 1 はわい じゃらん りぞーと あんど すぱ
NumberOfRatings クチコミ件数 半角数字 1 3
Rating クチコミ評点
※クチコミ件数が5件未満の宿泊施設については、評点は表示しておりません。
半角数字 1 0

サンプルレスポンス

検索条件:
小エリア=ワイキキ/アラモアナ/カハラ(ホノルル)、宿名 = ビレッジ、表示件数 = 1
での検索結果です。

<?xml version="1.0" encoding="UTF-8"?>
<Results xmlns="jws">
  <NumberOfResults>26</NumberOfResults>
  <DisplayPerPage>1</DisplayPerPage>
  <DisplayFrom>1</DisplayFrom>
  <APIVersion>1.0</APIVersion>
  <Plan>
    <PlanName>じゃらんのお客様へ【アーリーチェックイン@1PM】</PlanName>
    <PlanCD>01086496</PlanCD>
    <RoomName>リゾートビュー<1キングベッド></RoomName>
    <RoomCD>0220603</RoomCD>
    <PlanDetailURL>http://www.jalan.net/JwsRedirect.do?key=**********
&amp;rd_key=MDEwODY0OTYsOTI3MjIxLDAyMjA2MDMsLCwsMSwxLCwsLCwsLDE3LDA3
    </PlanDetailURL>
    <PlanCommonDetailURL>http://www.jalan.net/uo/uop3200/uow3201.do?yadNo=927221&amp;planCd=01086496&amp;roomTypeCd=0220603&amp;rootCd=55&amp;stayYear=
&amp;stayMonth=&amp;stayDay=&amp;stayCount=1&amp;roomCount=1&amp;adultNum=
&amp;child1Num=&amp;child2Num=&amp;child3Num=&amp;child4Num=&amp;child5Num=
    </PlanCommonDetailURL>
    <Facilities>
      <Facility>その他</Facility>
      <Facility>部屋でインターネット</Facility>
      <Facility>禁煙ルーム</Facility>
      <Facility>バス</Facility>
      <Facility>トイレ</Facility>
    </Facilities>
    <PlanCheckIn>13:00</PlanCheckIn>
    <PlanCheckOut>11:00</PlanCheckOut>
    <PlanPictureURL>http://www.jalan.net/jalan/images/pictM/Y1/Y927221/Y927221047.jpg
    </PlanPictureURL>
    <PlanPictureCaption>ダイヤモンドヘッドタワー・ガーデン・キング</PlanPictureCaption>
    <Meal>食事なし</Meal>
    <RateType>1室あたり</RateType>
    <SampleRateDispEng>199.00USD</SampleRateDispEng>
    <SampleRateEng>199.00</SampleRateEng>
    <SampleRate>16443</SampleRate>
    <Hotel>
      <HotelID>927221</HotelID>
      <HotelName>ヒルトン ハワイアン ビレッジ ビーチリゾート アンド スパ</HotelName>
      <HotelNameEng>Hilton Hawaiian Village Beach Resort &amp; Spa</HotelNameEng>
      <HotelGrade>4</HotelGrade>
      <PostCode>96815</PostCode>
      <HotelAddress>ハワイ州 ホノルル カリア ロード 2005</HotelAddress>
      <Area>
        <Region>ハワイ/グアム</Region>
        <Prefecture>ハワイ/グアム</Prefecture>
        <LargeArea>オアフ島</LargeArea>
        <SmallArea>ワイキキ/アラモアナ/カハラ(ホノルル)</SmallArea>
      </Area>
      <HotelType>ホテル</HotelType>
      <HotelDetailURL>http://www.jalan.net/JwsRedirect.do?key=**********&amp;rd_key=OTI3MjIxLDE3LDA2</HotelDetailURL>
      <HotelCatchCopy>ワイキキビーチに面した約9万平米の敷地に建つリゾートホテル</HotelCatchCopy>
      <HotelCaption>ワイキキ最大の広さを誇るビーチに建つ9万平米の広大な敷地の中に美しい緑と滝が広がるトロピカルガーデンがあり、ペンギンをはじめとする70種類以上の鳥達が暮らす、まさに究極のリゾートホテルです。</HotelCaption>
      <PictureURL>http://www.jalan.net/jalan/images/pictM/Y1/Y927221/Y927221072.jpg
      </PictureURL>
      <PictureCaption>ヒルトン・ハワイアンビレッジの外観パノラマ</PictureCaption>
      <X>-568207670</X>
      <Y>76617507</Y>
      <HotelNameKana>ひるとん はわいあん びれっじ びーちりぞーと あんど すぱ</HotelNameKana>
      <NumberOfRatings>1</NumberOfRatings>
      <Rating></Rating>
    </Hotel>
  </Plan>
</Results>

エラー

じゃらんWebサービスは共通のエラーを返します。
詳しくは、 ガイドラインをごらんください。


ビジネスホテル高級ホテル温泉・露天風呂ペットとホテル宿・ホテル一覧レンタカーツアー航空券高速バス・夜行バス旅行・観光ガイド