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

じゃらんWebサービス/じゃらん宿表示API ライト

APIリファレンス

じゃらんWebサービス 宿表示API ライト

宿表示APIは、じゃらんnetに公開されている宿泊施設の情報を検索する機能を提供します。

リクエストURL

http://jws.jalan.net/APILite/HotelSearch/V1/

リクエストパラメーター

パラメーター 項目名 説明 必須
key APIキー APIを利用するためのキーです。
アカウント登録時に割り当てられるAPIキーを指定してください。
半角数字16桁以下
pref 都道府県コード 各都道府県に割り当てられたコードで検索を行います。 エリアから検索を行う場合、いずれか必須 エリアコード対応表を参照するか、 あるいはエリア検索APIでの検索結果を参考にしてください。
l_area 大エリアコード 都道府県を各地域ごとに分けたエリアのコードで検索を行います。
s_area 小エリアコード 大エリアを更に詳細に分けたエリアのコードで検索を行います。
h_id 宿番号 宿に割り当てられた番号で検索を行います。
※ この項目を指定した場合、宿番号での検索条件が最優先となり、他の検索条件は無視されます。
宿番号指定で検索を行う場合、必須 半角数字6桁。
h_type 宿タイプ 宿泊施設のタイプで絞り込みを行うかどうかを指定します。 0:指定なし(初期値)
1:旅館
2:ペンション・民宿
3:貸別荘・コンドミニアム
4:ホテル・ビジネスホテル
5:公共の宿
o_pool 屋外プール 「施設内に屋外プールがある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
parking 駐車場無料 「駐車場が無料の宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
pub_bath 内湯・大浴場 「館内に内湯・大浴場がある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
onsen 温泉 「温泉がある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
prv_bath 貸切風呂 「貸切風呂がある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
v_bath 展望風呂 「展望風呂がある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
sauna サウナ 「サウナ設備がある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
jacz ジャグジー 「ジャグジー設備がある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
mssg マッサージ 「マッサージサービスがある、もしくは、手配可能な宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
r_ski 貸しスキー 「館内・敷地内に宿泊者向けに貸しスキーがある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
r_brd 貸しボード 「館内・敷地内に宿泊者向けに貸しスノーボードがある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
pet ペットOKの宿 「施設にペット同伴可能な宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
esthe エステ設備 「エステ設備が施設内か近隣にある、もしくはエステサービスを手配可能な宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
p_pong 卓球あり 「館内に卓球台が設置されている宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
limo 送迎あり 「最寄の駅からの送迎サービスがある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
late_out チェックアウト11時以降 「チェックアウトが11時以降の宿泊プランのある宿泊施設」という条件で絞込みを行うかどうかを指定します。 0:絞り込まない(初期値)
1:絞り込む
pict_size 画像サイズ 宿泊施設の画像のサイズを指定します。 0:pictSS
1:pictS
2:pict
3:pictM(初期値)
4:pictL
5:pictLL

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

サンプルリクエストURL

http://jws.jalan.net/APILite/HotelSearch/V1/?key=**********&pref=160000&l_area=162600&s_area=162612&h_type=1&start=1&count=1

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

レスポンスフィールド

フィールド 説明 出現回数
Results - - 1 -
NumberOfResults 該当件数 半角数字 1 6
DisplayPerPage 表示件数 半角数字 1 1
DisplayFrom 表示From 半角数字 1 1
APIVersion APIバージョン 半角数字・記号 1 1.3
Hotel - - 表示件数分 -
HotelID 宿番号 半角数字 1 300624
HotelName 宿名漢字 全角・半角 1 天空の城三宜亭本館
PostCode 郵便番号 半角数字・記号 1 395-0034
HotelAddress 住所 全角・半角 1 長野県飯田市追手町2−641−10
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=MzAwNjI0ICAgIDAwMDA=
HotelCatchCopy キャッチ 全角漢字 1 飯田城址の高台に建つ眺望・味覚・天然温泉の御宿。
HotelCaption コピー 全角漢字 1 飯田城址の高台に建つ、眺望・味覚・天然温泉の御宿です。大浴場からは遠く南アルプスを望み、眼下に飯田市街をご覧頂けます。湯上りには、四季折々旬の素材を大切にした季節の会席膳をお楽しみください。
PictureURL 宿画像URL 半角英数記号(URL) 1 http://www.jalan.net/jalan/images/ pictM/8/00218/00218461.jpg
PictureCaption 宿画像キャプション 全角・半角 1 南アルプスを一望、飯田市街を眼下に臨む最高の見晴らし
AccessInformation 交通案内 全角・半角 1 〜 3 車/中央道名古屋方面〜飯田〜R153を飯田市街へ15分 車以外/JR飯田線飯田駅タクシー5分
name 交通案内のタイトル 全角・半角 1 東京より
CheckInTime 標準的なチェックイン時刻
※宿泊プランごとにチェックイン時間の設定がある場合は、そちらが優先されます。
半角数字・記号 1 15:00
CheckOutTime 標準的なチェックアウト時刻
※宿泊プランごとにチェックアウト時間の設定がある場合は、そちらが優先されます。
半角数字・記号 1 10:00
X 経度(ミリ秒)
※緯度・経度は日本測地系の値です。
半角数字 1 496212164
Y 緯度(ミリ秒)
※緯度・経度は日本測地系の値です。
半角数字 1 127830116
LastUpdate 情報更新日 - 1 -
day 情報更新日(日) 半角数字 1 30
month 情報更新日(月) 半角数字 1 01
year 情報更新日(年) 半角数字 1 2007
WifiHikariStation 光ステーション設置
全角漢字 1 設置有り

サンプルレスポンス

検索条件:
都道府県=長野県、大エリア=伊那・駒ヶ根・飯田・昼神、小エリア= 【飯田・天竜峡】
での検索結果です。

<?xml version="1.0" encoding="UTF-8"?>
<Results xmlns="jws">
    <NumberOfResults>6</NumberOfResults>
    <DisplayPerPage>1</DisplayPerPage>
    <DisplayFrom>1</DisplayFrom>
    <APIVersion>1.3</APIVersion>
    <Hotel>
        <HotelId>300624</HotelId>
        <HotelName>天空の城三宜亭本館</HotelName>
        <PostCode>395-0034</PostCode>
        <HotelAddress>長野県飯田市追手町2−641−10</HotelAddress>
        <Area>
            <Region>甲信越</Region>
            <Prefecture>長野県</Prefecture>
            <LargeArea>伊那・駒ヶ根・飯田・昼神</LargeArea>
            <SmallArea>飯田・天竜峡</SmallArea>
        </Area>
        <HotelType>旅館</HotelType>
        <HotelDetailURL>http://www.jalan.net/JwsRedirect.do?key=**************&rd_key=MzAwNjI0ICAgIDAwMDA=</HotelDetailURL>
        <HotelCatchCopy>飯田城址の高台に建つ眺望・味覚・天然温泉の御宿。</HotelCatchCopy>
        <HotelCaption>飯田城址の高台に建つ、眺望・味覚・天然温泉の御宿です。大浴場からは遠く南アルプスを望み、眼下に飯田市街をご覧頂けます。湯上りには、四季折々旬の素材を大切にした季節の会席膳をお楽しみください。</HotelCaption>
        <PictureURL>http://www.jalan.net/jalan/images/pictM/8/00218/00218461.jpg</PictureURL>
        <PictureCaption>南アルプスを一望、飯田市街を眼下に臨む最高の見晴らし</PictureCaption>
        <AccessInformation name="東京より">車/中央道名古屋方面〜飯田〜R153を飯田市街へ15分 車以外/JR飯田線飯田駅タクシー5分</AccessInformation>
        <AccessInformation name="名古屋より">車/中央道飯田方面〜飯田〜R153を飯田市街へ15分 車以外/JR飯田線飯田駅よりタクシー5分</AccessInformation>
        <CheckInTime>15:00</CheckInTime>
        <CheckOutTime>10:00</CheckOutTime>
        <X>496212164</X>
        <Y>127830116</Y>
        <LastUpdate day="30" month="01" year="2007"/>
        <WifiHikariStation>設置有り</WifiHikariStation>
    </Hotel>
</Results>

エラー

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


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