Jalan WebAPI

October 4, 2015

Jalan API について

じゃらん Web サービスとは

じゃらん net が提供する宿泊宿、空室検索用 WebAPI

API の種類

じゃらん宿表示 API（アドバンス）
じゃらん宿表示 API（ライト）
空室検索 API
エリア検索 API
温泉検索 API

API の制限

特定 IP アドレスからの一定時間内での連続アクセスは制限される。（制限条件は非公開）

API の取得

以下のページからアカウント登録することで API-KEY がメール送付される。
https://www.jalan.net/jw/jwp0400/jww0401.do

API の利用例

リクエスト URL: http://jws.jalan.net/APILite/HotelSearch/V1/?
key: API-KEY
pref: 都道府県に割り当てられたコード
http://jws.jalan.net/APILite/HotelSearch/V1/?key=XXXXXX&pref=270000
結果は XML 形式で返却される。API 利用制限等のエラー時はエラー XML が返却される。

    <?xml version="1.0" encoding="UTF-8" ?>
    <Error xmlns="jws">
         <Message>アクセスが拒否されました。</Message>
    </Error>

jalan のエリア横断検索

jalan の Web 検索には複数エリアをまたいでの検索機能がなかったので API で実装。
jalan 横断検索

コメント

都道府県をキーにした検索ができない点が不便。検索結果が多くなるから？
API の利用制限が厳しい。一定期間連続アクセスがあると遮断（HTTP 406 が返却される）されるとあるが、2 分に一回の間隔でも NG になるため使いづらい。

reference