按入住日期与人数获取民宿房价
查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →针对一套已知度假民宿请求房价信息,必填查询参数为 rentalId、adults、startDate 与 endDate。adults 是数值型的入住人数输入;startDate 为入住日期,endDate 为离店日期,二者均采用 YYYY-MM-DD 格式。可选的 currencyCode 用于选择文档中的货币代码,USD 仅为示例,并不代表服务端默认值。 该操作在所提供的证据中没有已观测的探测响应。未经验证的源示例顶层包含 data、message、status 与 timestamp 字段;其中 data 含有 rapData、rapRate、view、errors 和 validationError。示例中的 rapData 字段包括 baseRate、bookingFee、ownerFees、deposit、subtotal 与 tax,并配有对应的货币字段和若干格式化后的价格值。rapRate 字段包括 amount、currency、details、minStay、instantBook 与 paymentSchedule;details 的每一项含 amount、currency、optional、refundable、ruleDescription、ruleType、type 与 typeName,paymentSchedule 的每一项含 amount、currency 与 dueDate。view 则包含 adults、guests、stayLength、checkInDate、checkOutDate,以及入住或可订状态的阻断标识。部分示例字段为空。请将这些视为源示例字段,而非已验证的响应契约:在展示总价之前,先确认费用、税费、货币与金额的具体含义。这是房价查询,不是预订,也不保证当前可订或价格可成交。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/tripadvisor-data/rental-rates API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/rental-rates?key=<API_KEY>&adults=<adults>&endDate=<endDate>&rentalId=<rentalId>&startDate=<startDate>'
查询结果
使用场景
- 在 adults 与 currencyCode 保持不变的情况下,对比同一 rentalId 的两个入住时段,并在比较总价前先核对费用和税费的含义。
- 搭建入住晚数敏感度分析笔记本,把房源 ID、日期、人数与所请求货币同每次房价响应一起存档。
- 用返回的价格构成整理出分项的民宿预算表,在相关标记可用时,把可选项和可退款项单独区分开来。
- 制作一个核对界面,在旅客进入独立的预订流程之前,先展示最少入住晚数提示与付款计划条目。
常见问题
民宿房价请求需要哪些必填输入?
需要提供完整的 rentalId、数值型 adults、startDate 与 endDate。startDate 为入住日期,endDate 为离店日期,二者均使用 YYYY-MM-DD 格式。currencyCode 为可选项。
adults 是否包含单独的儿童人数设置?
adults 是唯一开放的数值输入,文档描述为入住人数。该操作没有单独的儿童参数。源示例的响应里虽然出现了其他与人数相关的字段,但它们并不能说明存在另外受支持的请求输入,也不能说明存在儿童定价规则。
省略 currencyCode 时默认货币是 USD 吗?
USD 只是文档中的示例。所提供的参数信息没有说明服务端默认值。文档指向货币配置查询来获取可用的货币代码;请以返回的货币字段为准,不要默认认为省略 currencyCode 就一定返回 USD。
可以把 rapRate.amount 当作每晚价格,或者把所有费用字段直接相加吗?
仅凭现有证据并不稳妥。源示例包含 rapRate.amount 与 currency、rapRate.details,以及 rapData 的 baseRate、subtotal、tax 和各类费用字段,但它们的计算关系与计价周期含义尚未验证。请核对实际响应中的含义,并避免把格式化后的金额或相互重叠的金额重复计算。
返回的房价能保证可以预订吗?
不能。该接口只获取房价信息,不会创建预订。源示例包含最少入住晚数、付款计划和阻断相关字段,但没有提供 rental-rates 的已观测探测响应。源示例既不能证明实时库存,也不能保证最终总价或可预订报价。