Vrbo 上线要求
合作伙伴必须遵循上线要求,通过 Rapid API 集成 Vrbo 住宿。
概述
我们创建了一份启动要求清单,合作伙伴必须遵循这些要求才能通过 Rapid API 集成 Vrbo 房源。此外,还有一份必要的入住须知清单供您遵守,以及 Vrbo 和其他品牌的徽标供您在网站上使用。
注意:使用下面的箭头展开每个上线要求,查看更多详细信息。
搜索页面
SP1:限制对一晚住宿的搜索
对于 Vrbo 房东来说,较短的预订期限可能具有挑战性,并会导致较高的取消率。此外,VrboCare™ 不会为 1 晚住宿提供搬迁支持。合作伙伴必须限制 1 晚住宿对 Rapid 选购的调用。
搜索页面 2:将搜索限制为到达时间距离搜索时间大于等于 72 小时
Vrbo 房东通常需要额外的通知以便在住客抵达前做好准备,因此更有可能取消住客在抵达前 72 小时内进行的预订。这一限制有助于减少提供商取消和挪房的情况。合作伙伴必须限制 72 小时内的住宿对 Rapid 选购的调用。
搜索页面 3:限制需要可退款的损坏押金的住宿
适用于:向客户发送卡且不包含有可退款的损坏押金的住宿的合作伙伴。对于要求预付可退款的损坏押金的住宿,必须限制其展示和预订,因为这笔费用的金额通常很高,与合作伙伴记录商户不兼容,而且退款困难。
exclusion=refundable_damage_deposit
展示页面
展示页面 1:在展示内容旁显示 Vrbo(或本地对应品牌)徽标或文本名称(仅适用于欧盟/英国)
仅适用于欧盟/英国销售网站
Vrbo 住宿将仅在 Vrbo 个人资料上显示,您需要在内容 API 调用中发送 supply_source=VRBO 以识别 Vrbo 住宿。

API 示例:
| 对象 | 格式 | 说明 |
|---|---|---|
supply_source | 字符串 | 住宿的供应源。 |
展示页面 2:在搜索结果中显示住宿管理类型(仅适用于欧盟/英国)
仅适用于欧盟/英国销售网站
当住宿由私人房东打理时,根据销售网站显示正确的消息。
- 欧盟/英国 POSa -“Private host”
- 法国 POSa -“Annonce d'un particulier”
- 其他 POSa - 不需要
API 示例:
"vacation_rental_details": {
"private_host": true,
"property_manager":
"name":
}| 对象 | 格式 | 说明 |
|---|---|---|
private_host | 布尔型 | 表明住宿是否由私人房东打理。 |
住宿详细信息页面/房态页面
房态页面 1:显示 Vrbo(或本地对应品牌)徽标或文本名称(仅适用于欧盟/英国)
仅适用于欧盟/英国销售网站

API 示例:
| 对象 | 格式 | 说明 |
|---|---|---|
supply_source | 字符串 | 住宿的供应源。 |
房态页面 2:在住宿详细信息页面上显示住宿管理类型(仅适用于欧盟/英国)
仅适用于欧盟/英国销售网站
私人房东住宿
当表明一个住宿由私人房东打理时,根据销售网站显示正确的消息。
- 欧盟/英国 POSa:“This property is managed by a private host. Private hosts do not rent properties as a trade, business, or profession. 欧盟/英国有关专业房东的消费者法律可能不适用,但是VrboCare™,私人房东制定的取消政策将涵盖您的预订。
- 法国 POSa:“Cette propriété est celle d'un particulier. La fourniture de logements n’est pas liée à son commerce, entreprise ou profession. Le droit de la consommation de l'Union Européenne peut ne pas s'appliquer, toutefois la Garantie Réservation en tout Confiance et les conditions d'annulation définies par l'hôte particulier couvriront votre réservation."
上述粗体文本为可选项。如果合作伙伴在 VrboCare 上提供指向 #check-out 的链接,他们可以在房产详情页中包含此参考信息。
专业房东住宿
当表明一个住宿由专业房东管理时,根据销售网站显示正确的消息。
- 欧盟/英国 POSa:“Information about cancellation rights. If you cancel your booking, you'll be subject to the host's cancellation policy. In accordance with EU/UK regulations about consumer rights, property booking services are not subject to the right of withdrawal.”
- 法国 POSa:“Informations sur le droit de rétractation. Informations sur le droit de rétractation - Bien que les vacanciers réservant auprès d’un consommateur ou d’un non professionnel ne disposent pas du droit de rétractation, au sens de l’article L. 221-18 du Code de la consommation, ils peuvent bénéficier de la politique d’annulation du propriétaire. Les vacanciers et propriétaires sont soumis au droit des obligations et de responsabilité civile applicables à la relation contractuelle, prévues aux articles 1100 à 1386-1 du code civil.”
如何识别住宿管理类型
"vacation_rental_details": {
"private_host": true,
"property_manager":
"name":
}| 对象 | 格式 | 说明 |
|---|---|---|
private_host | 布尔型 | 表明住宿是否由私人房东打理。 |
房态页面 3:显示自由文本住宿介绍
房东通常会详细描述住宿、服务设施和周边地区。确保在 API 返回时显示自由文本介绍。
示例:
"free_text": "City ID#1837<br><br>If you want ELEGANCE, the Dream Home is for YOU! YOU will create MEMORIES that will last a LIFETIME and experience the history of Palm Springs, all in this 800 sq. ft STUNNING home with clerestory windows, exposed-beam ceilings, the latest home TECHNOLOGY, a large kitchenette, granite counters, full walk-in shower, and a PRIVATE POOL & SPA! This home is UNBELIEVABLY GORGEOUS, with a privacy fence, gated parking, a barbecue area, BREATHTAKING MOUNTAIN VIEWS! You simply DESERVE IT! You will be AMAZED at this home so close to downtown! You will never want to leave this stunning piece of Palm Springs!<br><br>You will also have your very own remote control gate to park your car next to your home behind a self-closing gate. You are welcome to invite friends over for a small party or cookout on your grill. All the kitchen utensils are provided. You just bring the food and start grilling!<br><br>The home is FULL of TECHNOLOGY from Alexa, to a Nest thermostat and even control the temperature of the spa directly from a wireless tablet in the home!<br><br>The home has amazing ambiance overlooking a heated pool and spa.<br><br>The home has a queen bed with a memory foam mattress and bamboo pillows. It also has a couch in the same room that could be used for a child or an adult. The home is full of beautiful MODERN furniture to give you the true Palm Springs Experience. The Dream Home is completely surrounded by a privacy fence which gives you complete privacy during stay! <br><br>**Pool heating is charged during the months of November - December - January - February - March - April and May 15 (see ADDITIONAL RULES for details). Payment request is sent at least 2 weeks in advance.<br><br>POOL HEAT FEES <br>There is a $50 per day pool charge for the following months;<br>(Aug 15 - November - December - January - February - March-April-May 15) to 80 degrees the following fee will be applied;<br>* Pool Heat Charges tracked by Pentair Software program during your stay.<br>* Pool heat invoice charges will be emailed the week before check-in.<br>* Payment must be made before check-in."
},
房态页面 4:显示价格明细的所有元素
每当列出房价详细信息明细时,都会显示旅客服务费和房东费用。
a) 旅客服务费
您必须逐字显示示例文本:
所有欧盟/英国销售网站均要求使用“含增值税”字样。 在向住客显示时必须解释旅客服务费(可以采用鼠标悬停/点击旅客服务费名称的方式)。
示例:
旅客服务费说明:旅客服务费(含增值税):33.32 欧元
合作伙伴可以在说明中使用“traveler service fee”或仅“service fee”字样。
- “[品牌] 对使用其平台上提供的在线工具、服务和功能收取服务费,使住客能够与展示住宿的房东互动。”
您可在本页面底部找到 Vrbo 品牌对照列表。
b) 房东费用
每当根据 Rapid 选购定价明细中的 property_fee 列出价格明细时,都会显示房东费用。
(可选)包括鼠标悬停说明,例如,“房东费用包括:清洁费、加人费、管理费和其他费用。”
示例:
房东费用:$4.00
"occupancy_pricing": {
"2": {
"nightly": [
[
{
"type": "tax_and_service_fee",
"value": "13.64",
"currency": "USD"
},
{
"type": "property_fee",
"value": "4.00",
"currency": "USD"
},
{
"type": "traveler_service_fee",
"value": "13.20",
"currency": "USD"
},
{
"type": "base_rate",
"value": "99.00",
"currency": "USD"
}
],房态页面 5:显示优化的租房规定
优化的租房规定的完整内容必须包含在住宿详细信息页面上(例如禁止举办派对、吸烟规定)。显示从 API 返回的 additional_information 对象的完整内容。
租房规定可确保旅客在完成预订前了解房东的所有要求。该对象中返回的值特定于 Vrbo 住宿,并且比 API 内容文件中返回的值更重要。
UI 示例:

API 示例:
"enhanced_house_rules":
"Children": {
"rule": "Children allowed",
"additional_information": [
"Children allowed ages 13-17",
"Three children are possible if one is in a cot",
]
},
"Pets": {
"rule": "Pets allowed",
"additional_information": [
"Pets must be no larger than 1lbs.",
]
}房态页面 6:显示住宿登记号。
可以在 Rapid 内容响应中找到住宿登记号。
只要内容中出现价值,就应在合作伙伴的 PDP 网站上显示。
UI 示例:
许可证号:RHL-0000954
API 示例:
"vacation_rental_details": {
"registry_number": "RHL-0000954",
"private_host": true
}房态页面 7:显示单元配置
包含卧室和浴室的数量。客房面积详细信息为选填内容。该信息可以在 statistics 数组中找到。
UI 示例:

API 示例:
"statistics": {
"1073743380": {
"id": "1073743380",
"name": "Max occupancy - 5",
"value": "5"
},
"1073743378": {
"id": "1073743378",
"name": "Nunmber of bedrooms - 1",
"value": "1"
},
"1073743379": {
"id": "1073743379",
"name": "Number of bathrooms - 1",
"value": "1"
},
"52": {
"id": "52",
"name": "Total number of rooms - 1",
"value": "1"
},
"1073743538": {
"id": "1073743538",
"name": "Property floor area (square meters) - 75",
"value": "75"
},
"1073743537": {
"id": "1073743537",
"name": "Property floor area (square feet) - 807",
"value": "807"
}房态页面 8:显示物业经理信息。
包括房东姓名。
可选:包括使用的语言和图像。

API 示例:
"vacation_rental_details": {
"registry_number": "Property Registration Number SCIA 19367",
"private_host": true,
"property_manager": {
"name": "Rent Home in Rome, It"
},"spoken_languages": {
"de": {
"id": "de",
"name": "German"
},
"en": {
"id": "en",
"name": "English"
},
"nl": {
"id": "nl",
"name": "Dutch"
}
}付款页面/预订页面
预订页面 1:显示留存卡限制的金额和说明。
- 这需要用 Rapid 房态 API 响应提供的数值填充(如果显示)。