AIアシスタント向けホテル検索
roomesto.com は、ホテル検索のリクエストに最新の料金と空室状況を通常のGETリクエストで返します。アカウント、APIキー、Cookie、JavaScript、MCPクライアントは必要ありません。サイトと同じ検索エンジンを使っています。
リクエスト先
GET https://roomesto.com/ai/hotels は、JavaScriptなしで読めるHTMLの結果ページを返します。format=json を付ける(または /ai/hotels.json を呼ぶ、Accept: application/json を送る)と構造化JSONを取得できます。
パラメーター
| パラメーター | 必須 | 形式と制限 |
|---|---|---|
destination | はい | 都市名または地域名、2〜80文字。例:Dubai、Istanbul、Paris(英語名が最適です)。 |
checkin | はい | 日付 YYYY-MM-DD:今日以降(UTC)、最大365日先まで。 |
checkout | はい | 日付 YYYY-MM-DD、チェックインより後。最大30泊。 |
adults | いいえ、既定値2 | 1〜6の整数。 |
children_ages | いいえ | 子どもの年齢をカンマ区切りで、0〜17歳、最大4人。例:5,12。 |
currency | いいえ、既定値USD | USD、EUR、RUB、GBP、TRY、AED、THB、CNY。 |
min_price | いいえ | 指定した通貨での1泊あたりの料金、0〜100000。 |
limit | いいえ、既定値10 | 1〜20の整数。 |
lang | いいえ、既定値en | ページとホテル名の言語:en、ru、de、es、fr、tr、it、zh、ar、ja、ko、pt、nl、sv、no、da、fi、pl、cs、el、he、hi、id、th、vi、uk、ro(ホテル名は仕入れ先の言語 en、ru、de、es、fr、tr、it で、それ以外は英語)。 |
例
- ドバイのホテル、2名、2026年11月10日〜15日、1泊150 USDまで、JSON:
https://roomesto.com/ai/hotels?destination=Dubai&checkin=2026-11-10&checkout=2026-11-15&adults=2¤cy=USD&max_price=150&format=json - イスタンブール、大人2名と7歳の子どもの家族、HTMLページ:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
JSONレスポンス
status は ok、no_results(HTTP 200)、destination_not_found(404)、invalid_request(400、param と message からなる errors リスト付き)、または provider_unavailable(503:結果も料金もなし。仕入れ先の検索が失敗したときに推測はしません)のいずれかです。
data_status は結果の出どころを示します:live — 検索を実行した直後、cached — 最近の検索を再利用、stale — 新しい検索が制限されている間の古い検索、partial — 待ち時間が切れた時点で仕入れ先がまだホテルを返していた状態(hotels_received は受け取ったホテル数。この応答はキャッシュされないため、同じリクエストを後で繰り返してください)。
results の各要素には次が含まれます:
hotel:id、name、star_rating、address(ローカルデータにホテルカードがない場合、名前と住所はnullになることがあります)。room:指定日の最安料金のnameとmeal食事プラン(room_only、breakfast、half_board、full_board、all_inclusiveなど)。price:滞在全体のtotal、per_night、currency。taxes:included_in_price(true、false、不明なら null)とnot_included— 通常は現地で別途支払う税金や手数料で、それぞれ金額と通貨を持ちます。payment:typeはpay_now(予約ページで支払い)またはpay_at_hotel。cancellation:typeはfree_until(UTCのfree_until時刻付き)、partial、non_refundable、unknownのいずれか。penaltiesは期間ごとの金額を列挙します。availability:statusはavailable、checked_at(検索を実行した時刻、UTC)、requires_recheck= true:料金と客室は予約ページで確定します。booking_url:同じ日付・人数・通貨の roomesto.com 予約ページ。
利用ルール
- 料金は日付、通貨、
checked_atの時刻と一緒に表示してください。予約までは変わることがあります。 not_includedの税金は料金のそばに表示してください。included_in_priceが null の場合は税金が不明であると伝えてください。- 旅行者を
booking_urlのリンクへ案内してください。予約と支払いは roomesto.com で行われます。 - 結果ページには
noindexが付いています。インデックス対象はこのページとドキュメントです。 - 制限:IPアドレスあたり毎分120リクエスト。通常のAIアシスタントの通信量はこの制限を大きく下回ります。
- 本サービスは個人データやアカウント情報を返しません。