按入住日期与人数获取民宿房价

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

入住与离店区间的房价 将 startDate 与 endDate 以 YYYY-MM-DD 字符串传入,并配合完整的 rentalId,请求某个特定入住时段的价格信息。
成人数与货币输入 必填数值型 adults,并可按需附带可选的 currencyCode。USD 是文档示例,并非已确认的默认值,也不保证货币换算。
分项价格证据 未经验证的源示例把 rapData 中的房价、费用与税费字段分开列出,并在 rapRate.details 中提供含金额、货币、optional 与 refundable 标记的条目。
住宿规则与付款计划 示例中的 rapRate 字段包含 minStay 与 paymentSchedule,view 则含 stayLength 与阻断标识。展示预订相关信息前,请先确认其实际取值。

在线 API 演示

GET /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>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

民宿房价请求需要哪些必填输入?

需要提供完整的 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 的已观测探测响应。源示例既不能证明实时库存,也不能保证最终总价或可预订报价。

相关接口

相关指南

查看订阅方案 →