按目的地、日期和可选筛选条件搜索酒店
查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →使用必填的目的地 geoId,以及 YYYY-MM-DD 格式的 checkIn 与 checkOut 日期搜索酒店。geoId 需通过酒店地点搜索获得,并以字符串形式传入。可选的 adults、rooms 和 childrenAges 用来描述出行人员;currencyCode 从货币查询操作中选择货币;pageNumber 用于选择结果页,文档中的默认值为 1。接口还支持 sort、priceMin、priceMax、rating、distFrom、distFromMaxDistance,以及 amenity、brand、class、deals、healthSafety、neighborhood、style、type 这几个数组筛选项。所提供的文档没有定义可接受的筛选取值、排序取值、评分范围或距离单位。请先检查对应的筛选元数据再映射控件,未经验证的可选值请留空不传。已保存的一次成功 HTTP 200 探测返回了 status=true、message 字符串、整数 timestamp,以及内含 data 数组的 data 对象:已观测到的酒店列表路径是 data.data,而不是外层的 data 对象。另有一份被截断的文档示例显示结果行包含 id、title、bubbleRating、cardPhotos、isSponsored、primaryInfo、secondaryInfo、priceDetails、priceForDisplay、priceSummary 和 strikethroughPrice;这些行内字段未被所提供的探测元数据证实,不应假定一定存在。把某一行的酒店标识传给酒店详情的 id 输入之前,请先核对该标识。现有证据没有确认总数、每页数量、稳定排序、预订能力、完整库存或实时价格。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/tripadvisor-data/search-hotels API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-hotels?key=<API_KEY>&checkIn=<checkIn>&checkOut=<checkOut>&geoId=<geoId>&pageNumber=1'
查询结果
使用场景
- 在旅客从酒店地点搜索中选定目的地 geoId 后,生成针对特定日期的酒店候选清单。
- 实现一个结果分页适配层,读取 data.data 并记录所请求的 pageNumber,而不去编造总页数或每页数量等元数据。
- 把搜索条件与选中的酒店行一并保存,便于之后对比时还原当初的出行人员、住宿日期、货币和已核实的筛选选择。
- 构建受控的从候选清单到详情的流程,在请求额外房源内容之前先核对所选酒店的标识。
- 仅在检查过可接受的取值之后,再去试做价格、评分和分面控件,并隐藏不受支持或未验证的选项。
常见问题
geoId 标识的是目的地还是某家酒店?
它标识的是通过酒店地点搜索选定的目的地,而不是某一家具体酒店。这里 geoId 是必填字符串,同时还需要 YYYY-MM-DD 格式的必填日期 checkIn 和 checkOut。
在已观测的响应中酒店列表在哪里?
已保存的成功探测返回了 JSON 对象,包含 status=true、message、timestamp 和外层 data 对象。列表位于嵌套的 data.data 数组中。所提供的探测元数据没有确认每一行内部的字段。
文档说明了哪些分页行为?
pageNumber 为可选参数,文档中的默认值是 1。现有证据没有确认每页数量、总页数字段、最大页码或稳定的排序保证。
可以发送哪些可选筛选条件?
接口接受 amenity、brand、class、deals、healthSafety、neighborhood、style 和 type 这些数组参数,以及 priceMin、priceMax、rating、distFrom、distFromMaxDistance 和 sort。可接受的令牌、排序代码、评分范围和距离单位均未在文档中说明。发送前请检查对应的元数据并核实映射关系。
行内的价格、评分和照片是否经过验证?
被截断的文档示例显示了 priceForDisplay、priceDetails、priceSummary、strikethroughPrice、bubbleRating 和 cardPhotos,但所提供的探测元数据只确认了嵌套列表的形状。请把这些行内字段视为可选且未经验证;无论是示例还是搜索结果,都不能说明存在可预订的报价。
如何从搜索结果过渡到酒店详情?
有意识地选定酒店,并在转发之前核实详情接口的 id 输入所接受的标识,同时保持相同的住宿和出行人员上下文。注意搜索接口使用 currencyCode,而详情查询把货币输入命名为 currency。