获取单个酒店的照片与设施内容集合

查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →

传入必填的酒店 id,以及 YYYY-MM-DD 格式的入住日期 checkIn 和退房日期 checkOut,即可获取该酒店的内容数据。酒店标识需先通过酒店搜索获得,并在作为 id 传入前核对所选结果的标识是否正确。可选的 adults、rooms、childrenAges 和 currency 用来让请求与实际出行人数和住宿安排保持一致。文档中 childrenAges 是年龄数组,取值范围 0 到 17,0 表示不满一岁的儿童。已保存的一次成功 HTTP 200 探测返回了 JSON 对象,包含 status=true、message 字符串、整数 timestamp,以及内含 photos 和 amenitiesScreen 两个数组的 data 对象。探测元数据只能证明这两个集合存在,无法说明其中每个条目的结构或内容是否完整。另有一份被截断的文档示例还显示了带有 title、tags、content 的 data.about,带有 title 和 content 的 amenitiesScreen 分区,以及 data.attractionsNearby.content;这些额外字段未被所提供的探测元数据证实。请显式处理集合为空或字段缺失的情况,不要把内容缺失当作该设施不存在的证据。本接口只是内容查询,不代表预订确认,也不保证房间库存、价格、点评或房源信息完整。

API 功能

读取房源照片集合 使用已观测到的 data.photos 数组来支撑所选酒店的照片展示流程。构建图集前请先检查条目字段,探测元数据并未确认图片条目的结构。
获取设施分区集合 把已观测到的 data.amenitiesScreen 数组当作酒店内容读取。文档示例暗示其中是带标题的分区,但在规范化之前需要先核实各分区的字段。
与行程匹配的房源请求 传入酒店 id 和两个住宿日期,并保留可选的 adults、rooms、childrenAges 与 currency,在为同一出行团队补全同一房源信息时保持上下文一致。
内容覆盖状态区分 把已有数据的数组、空集合、缺失字段与请求失败区分开来记录。缺少某条设施条目,并不能说明该酒店没有这项设施。

在线 API 演示

GET /api/project/tripadvisor-data/get-hotel-details

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-hotel-details?key=<API_KEY>&checkIn=<checkIn>&checkOut=<checkOut>&id=<id>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

请求酒店内容需要哪些标识和日期?

必填输入是 id、checkIn 和 checkOut,日期格式为 YYYY-MM-DD。文档要求通过酒店搜索获取酒店标识;在把搜索结果的标识作为 id 发送之前,请先核对它是否正确。

酒店详情中实际观测到了哪些字段?

已保存的成功探测返回了 status=true、message 字符串、整数 timestamp,以及包含 photos 和 amenitiesScreen 数组的 data 对象。所提供的探测元数据没有确认这两个数组中各条目的字段。

如何描述儿童和其他出行人员?

可选的 adults 表示 18 岁及以上的成人数量,rooms 表示所需房间数。childrenAges 是 0 到 17 的儿童年龄数组;文档示例 [0,10] 表示一名不满一岁的儿童和一名十岁儿童。文档中没有给出默认的出行人数。

每次返回的详情都能依赖 about 和周边景点字段吗?

不能。一份被截断的文档示例包含 data.about 和 data.attractionsNearby.content,但所提供的探测元数据并未确认这些字段。在检查过实际响应之前,请把它们视为可能出现、尚未验证的示例内容。

设施集合为空是否表示酒店没有这些设施?

不是。内容为空或缺失,只能说明该次请求返回了什么,并不能证明设施不存在;这个内容查询也不会确认房间是否可订或完成预订。

相关接口

相关指南

查看订阅方案 →