じゃらんWebサービス／温泉検索API

国内宿泊

じゃらん宿表示API

空室検索API

エリア検索API

温泉検索API

じゃらんWebサービス　温泉検索API

温泉検索APIは、じゃらんnetに登録されている温泉地、温泉のコード、名称の情報を検索する機能を提供します。

リクエストURL

http://jws.jalan.net/APICommon/OnsenSearch/V1/

リクエストパラメーター

パラメーター	項目名	説明	必須	値
key	APIキー	APIを利用するためのキーです。アカウント登録時に割り当てられるAPIキーを指定してください。	○	半角数字16桁以下
reg	広域コード	各広域に割り当てられたコードで検索を行います。	エリアから検索を行う場合、いずれか必須	エリアコード対応表を参照するか、あるいはエリア検索APIでの検索結果を参考にしてください。
pref	都道府県コード	各都道府県に割り当てられたコードで検索を行います。
l_area	大エリアコード	都道府県を各地域ごとに分けたエリアのコードで検索を行います。
s_area	小エリアコード	大エリアを更に詳細に分けたエリアのコードで検索を行います。
onsen_q	泉質	泉質で絞り込みを行うかどうかを指定します。		0:絞り込まない（初期値） 1:単純温泉 2:アルカリ単純泉 3:単純炭酸泉 4:弱アルカリ性低張性泉 5:中性低張性高温泉 6:塩化物泉 7:ナトリウム塩化物泉 8:炭酸水素塩泉 9:炭酸鉄泉 10:硫酸塩泉 11:二酸化炭素泉 12:含鉄泉 13:含銅一鉄泉 14:硫黄泉 15:酸性泉 16:含アルミニウム泉 17:放射能泉 18:鉱泉 99:その他
start	表示From	出力されるデータの何件目から表示するかを指定します。		半角数字。初期値:1
count	表示件数	出力されるデータの最大出力件数を指定します。該当件数が出力件数よりも少ない場合は、全て表示されます。		1 ～ 100までの半角数字。初期値:10
xml_ptn	出力項目の範囲	レスポンスフィールドに出力される項目の範囲を指定します。		0:エリア内の温泉全て（初期値） 1:エリア内の温泉地全て出力される範囲については、レスポンスフィールドの説明の「範囲」を参考にしてください。

サンプルリクエストURL

http://jws.jalan.net/APICommon/OnsenSearch/V1/?key=**********&l_area=010300&count=1&xml_ptn=1

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

レスポンスフィールド

フィールド	説明	型	出現回数	例	範囲
Results	-	-	1	-	-
NumberOfResults	該当件数	半角数字	1	100	-
DisplayPerPage	表示件数	半角数字	1	5	-
DisplayFrom	表示From	半角数字	1	1	-
APIVersion	APIバージョン	半角数字・記号	1	1.0	-
Onsen	-	-	表示件数分	-	-
OnsenName	温泉名	全角漢字	1	丸駒温泉	0
OnsenNameKana	温泉名かな	全角かな	1	まるこまおんせん	0
OnsenID	温泉コード	半角数字	1	0042	0
OnsenAddress	温泉住所	全角・半角	1	北海道千歳市幌美内番外地	0
Area	-	-	-	-	0
Region	地域_広域エリア漢字名	全角・半角	1	北海道	0
Prefecture	地域_都道府県漢字名	全角・半角	1	北海道	0
LargeArea	地域_大エリア漢字名	全角・半角	1	石狩・空知・千歳	0
SmallArea	地域_小エリア漢字名	全角・半角	1	支笏湖・千歳	0
NatureOfOnsen	泉質	全角・半角	1	塩化物泉	0
OnsenAreaName	温泉地名	全角・半角	1	支笏湖畔の温泉	1
OnsenAreaNameKana	温泉地名かな	全角かな	1	しこつこはんのおんせん	1
OnsenAreaID	温泉地コード	半角数字	1	50024	0
OnsenAreaURL	温泉地ページURL	半角英数記号（URL）	1	https://www.jalan.net/JwsRedirect.do? key=guest&rd_key=NTAwMjQgICAgIDAxMDI=	1
OnsenAreaCaption	コピー	全角・半角	1	千歳市の西端に位置する支笏湖の東岸に支笏湖温泉、対岸の恵庭岳の麓に丸駒温泉と伊藤温泉がある。支笏湖温泉の泉質は重曹泉で、別名「美人の湯」といわれ入浴後は肌がスベスベになる。丸駒温泉と伊藤温泉の露天風呂はともに支笏湖と岩で区切られているだけで、まるで湖の中の温泉につかっているようだ。	1

サンプルレスポンス

検索条件：
大エリア＝石狩・空知・千歳、範囲＝エリア内の温泉地全て
での検索結果です。

<?xml version="1.0" encoding="UTF-8" ?>
<Results xmlns="jws">
    <NumberOfResults>23</NumberOfResults>
    <DisplayPerPage>1</DisplayPerPage>
    <DisplayFrom>1</DisplayFrom>
    <APIVersion>1.0</APIVersion>
    <Onsen>
        <OnsenName>丸駒温泉</OnsenName>
        <OnsenNameKana>まるこまおんせん</OnsenNameKana>
        <OnsenID>0042</OnsenID>
        <OnsenAddress>北海道千歳市幌美内番外地</OnsenAddress>
        <Area>
            <Region>北海道</Region>
            <Prefecture>北海道</Prefecture>
            <LargeArea>石狩・空知・千歳</LargeArea>
            <SmallArea>支笏湖・千歳</SmallArea>
        </Area>
        <NatureOfOnsen>塩化物泉</NatureOfOnsen>
        <OnsenAreaName>支笏湖畔の温泉</OnsenAreaName>
        <OnsenAreaNameKana>しこつこはんのおんせん</OnsenAreaNameKana>
        <OnsenAreaID>50024</OnsenAreaID>
        <OnsenAreaURL>https://www.jalan.net/JwsRedirect.do?key=guest&rd_key=NTAwMjQgICAgIDAxMDI=</OnsenAreaURL>
        <OnsenAreaCaption>千歳市の西端に位置する支笏湖の東岸に支笏湖温泉、対岸の恵庭岳の麓に丸駒温泉と伊藤温泉がある。支笏湖温泉の泉質は重曹泉で、別名「美人の湯」といわれ入浴後は肌がスベスベになる。丸駒温泉と伊藤温泉の露天風呂はともに支笏湖と岩で区切られているだけで、まるで湖の中の温泉につかっているようだ。</OnsenAreaCaption>
    </Onsen>
</Results>

エラー

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

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