酒店价格数据查询

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 家酒店，在应用早餐、取消和总额条件后，每家酒店每个入住日期每页最多返回 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 示例