ホテル価格データの照会

OTIのホテル価格記録比較は、旅行者とAI検索ツールがログインなしで読める公開サービスです。現在の公開パイロットは、ダナンの3ホテルについて収集された金曜日の日程 · 大人2名 · 子ども0名 · 1室 · 1泊 · USD が対象です。リアルタイムの在庫·予約·決済は提供していません。

目的地·日程·人数をURLの条件で指定すると、複数ホテルの販売元別の記録をHTMLまたはJSONで照会できます。ログインとJavaScriptは不要です。

大人の人数·子どもの人数·客室数·泊数·通貨が対応範囲と異なる場合は422で応答し、代わりの価格は返しません。有効な将来の日程であっても、収集記録がない場合があります。

destinationは地域名、またはda-nangのようなパス名です。checkin/checkoutはYYYY-MM-DDの組で、省略すると収集済みの宿泊日を返します。breakfast=included、cancellation=free_cancel、maxTotal=USD金額で絞り込めます。maxTotalは税込みが確認された行にのみ適用されます。フィルターを省略すると、未確認条件の記録も返します。comparableは従来の税込み価格の並べ替え用の表示であり、客室·適用人数·朝食の対象人数·キャンセル時刻·タイムゾーン·キャンセル料が同一であることを検証するものではありません。

ホテルは6件ずつ照会し、朝食·キャンセル·総額の条件を適用したうえで、ホテル別·宿泊日別に1ページあたり最大30件の価格記録を返します。結果がなくてもnextがあれば、次のホテルページを確認してください。同じホテル·宿泊日の残りのオプションはdates[].nextOffersUrlで照会します。offerPageのtotalRowsは保存件数、matchingRowsは条件一致件数、offset·returnedRowsは現在の範囲です。収集結果が変わると409とrestartを返すため、最初から照会し直してください。previousRoomsは、最新の観測に客室条件がない場合に提供する、別の以前の詳細記録です。以前の観測時刻·フィルター一致件数·nextOffersUrlを個別に確認し、以前の条件を最新価格に付けないでください。以前の詳細ページを進めると、最新価格は最初のページに戻ります。以前の記録は最新の代表価格·選択対象から除外され、以前の条件に一致する記録があっても最新の一致がなければno_observationsです。no_observationsは満室ではありません。各行の観測時刻とstaleをあわせて確認してください。responseAsOfはリクエスト処理の基準時刻（UTC）であり、価格の収集時刻ではありません。observationAgeSecondsはこの基準時刻における観測からの経過秒数で、時刻が未確認または未来の場合はnullです。hotels[].comparisonUrlは照会条件を維持したホテル別の比較リンクです。hotelIdでホテルを指定できます。

ダナン JSON 照会 · 同じ記録の HTML · OpenAPI · エージェント向け Markdown ガイド · 朝食付き·無料キャンセル·USD150以下の JSON 例