>

roomesto.com · English

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いいえ、既定値21〜6の整数。
children_agesいいえ子どもの年齢をカンマ区切りで、0〜17歳、最大4人。例:5,12。
currencyいいえ、既定値USDUSD、EUR、RUB、GBP、TRY、AED、THB、CNY。
min_priceいいえ指定した通貨での1泊あたりの料金、0〜100000。
limitいいえ、既定値101〜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 で、それ以外は英語)。

例

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 の各要素には次が含まれます:

利用ルール

その他の利用方法