按目的地、日期和可选筛选条件搜索酒店

查看 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 功能

按日期发现目的地酒店 把酒店地点搜索得到的 geoId 与 checkIn、checkOut 结合,为指定的住宿时段建立目的地候选清单,而不是通过酒店标识来搜索。
解析已观测的嵌套结果列表 从成功探测中观测到的 data.data 数组里提取酒店行。不要把外层 data 对象当作结果列表,也不要根据外层信封去推断条目字段。
明确的分页与出行人员上下文 使用文档中 pageNumber 默认值 1,并在每次请求的结果页旁保留日期、adults、rooms、childrenAges 和 currencyCode。每页数量与总页数元数据并未确认。
仅用已核实的值细化搜索 接口提供数组类分面,以及价格、评分、距离和排序控件。只映射已检查过的取值;所提供的参数说明中没有定义分面令牌集合、排序代码、评分范围和距离单位。
有选择地交接到详情查询 有意识地挑选结果行,核实详情查询所接受的酒店标识,再只对这些记录补全内容。文档示例中的行 id 本身并不能证明条目之间的对应关系。

在线 API 演示

GET /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 标识的是目的地还是某家酒店?

它标识的是通过酒店地点搜索选定的目的地,而不是某一家具体酒店。这里 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。

相关接口

相关指南

查看订阅方案 →