按 rentalId 获取度假民宿详情
查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →针对一套已知的度假民宿,通过必填的 rentalId 查询字符串获取房源内容。请完整保留该标识,参数文档指出其来源于民宿搜索结果。该操作不接受入住日期、人数或页码。 该操作在所提供的证据中没有已观测的探测响应。源响应示例被截断,其可见的 data 对象包含 amenities、geoCoordinates.lat 与 geoCoordinates.lng、nearbyGeosInfo、overview 和 paymentStats.totalPayments,随后是 photos 的开头部分。可见的 overview 字段包括 name、descriptions、averageRatingNumber、userReviewCount、roomCount、bathCount、sleepCount、minStay、cancellationPolicy、carRequired、isInstantBook 与 isOnlineBookable。这些只是未经验证的源示例字段,并非完整且已验证的结构,也不保证字段一定存在。在使用房源内容、坐标或可预订标识之前,请先检查实际返回的结构;该查询不会创建预订,也不提供带日期的报价。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/tripadvisor-data/rental-details API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/rental-details?key=<API_KEY>&rentalId=VacationRentalReview-g60763-d24235431-Sonder_The_Industrialist_Queen_Room-New_York_City_New_York'
查询结果
使用场景
- 为已有的已知 ID 度假民宿目录补全名称、描述与容量字段,而不是依赖民宿搜索来发现房源。
- 为已知房源搭建人工内容质检队列,在检查实际返回结果之后,再对不可用记录和请求失败进行分类。
- 在房源对比视图中补充设施和地图坐标,前提是这些文档示例字段确实出现在返回数据里。
- 将返回的汇总评分与评价数量同已保存的房源快照比对,找出需要编辑关注的房源。
常见问题
房源详情请求所需的 rentalId 从哪里获取?
参数文档指出 rentalId 来自度假民宿合集中的民宿搜索结果。这个详情接口本身不负责发现房源。请使用你记录中已有的 rentalId,并完整保留整个字符串,包括 VacationRentalReview 前缀及其余标识片段。
可以按具体入住日期或入住人数请求详情吗?
不可以。rentalId 是该操作唯一开放的输入。日期和人数属于单独的 rental-rates 请求,而不是这个房源内容查询。
响应示例中记录了哪些房源字段?
可见部分包括 data.amenities、geoCoordinates.lat 与 lng、nearbyGeosInfo、overview 以及 paymentStats.totalPayments。overview 中包含房源名称、描述、容量、入住规则和汇总评价等字段。示例中 photos 字段刚开头就被截断,因此无法确定完整的图片结构,也无法确定完整的响应格式。
房源概览里是否包含住客的单条评价?
可见示例只在 overview 中记录了 averageRatingNumber 与 userReviewCount,没有单条评价项。如需分页获取住客反馈,请另行使用 rental-reviews;不要把概览中的汇总字段当作评价记录。
这些房源详情字段是否经过实际调用验证?
没有。该操作未提供已观测的探测响应。字段说明来自被截断的源示例,在依赖其存在或含义之前,必须先对照实际返回数据进行检查。