Lodging Vacation Rental Properties

Vacation rental properties offer you customers more flexibility when choosing their perfect stay

Important Note on Vacation Rental Properties:

Expedia vacation rental properties are available automatically via the Lodging Search API.
Vrbo vacation rental properties are only available to partners via a request to their Account Manager.

What is a vacation rental?

There are two kinds of properties in Expedia inventory:

Conventional Lodging — Refers to businesses that operate for the purpose of providing lodging for hire, such as hotels.
Vacation Rentals — Refers to private residences that are offered for rent by their owners, such as apartments or houses.

Within Expedia's lodging inventory, a vacation rental is defined as any property with a property type id of:
7, 9, 10, 11, 14, 16, 17, 18, 22, 23, 24, or 33.

(Full list of Expedia Property Types supported by XAP Lodging)

Vacation rentals in Expedia inventory

When searching for vacation rental inventory via the Lodging Search API, partners will encounter an additional data object in the API response named propertyDetails. This section provides information about vacation rental properties that is different from the data returned for a conventional lodging property.

screenshot from the XAP Lodging Search API documentation

Properties within the Lodging Search API response can be divided into two different types:

Conventional Lodging Properties which do not return a PropertyDetails object in API response.
Vacation Rental Properties which do return a PropertyDetails object in API response.

Vacation rental properties can then be divided into two different types:

Vrbo Properties which return all information in PropertyDetails object.
Expedia Vacation Rental Properties which return all information in PropertyDetails except the PropertyManager object.

Vacation rental use cases

The following section outlines the various methods of accessing different types of Expedia lodging inventory.

Use Case 1: Search by Vrbo Property ID

Description

End user sends a Lodging Search request with a Vrbo Property ID to return PropertyDetails object and other info.

Sample Request

https://apim.expedia.com/hotels/listings?checkIn=2021-06-11&checkOut=2021-06-15&ecomHotelIds=19007777

Sample Header

(Same for all examples.)

Accept:application/vnd.exp-hotel.v3+json
Partner-Transaction-Id:BestTravel-1234567
Key:X99X9X9-99XX-9XX9-X999-99XX99X9X999X
Authorization:Basic UGFydG5lcktleUdvZXNIZXJlOl=

Property Details Section

"PropertyDetails": {
                "HostLanguages": [
                    "English",
                    "French"
                ],
                "MaxOccupancy": 4,
                "NumberOfBedrooms": 2,
                "NumberOfBathrooms": 1,
                "SquareFeet": "1200",
                "PropertyManager": {
                    "Name": "William",
                    "CalendarLastUpdated": "2021-08-28",
                    "PhotoUrl": "https://imagesus-ssl.homeaway.com/mda01/ff30bc14-157c-43fc-ad8c-d2ce36bc7e83.4.1"
                }

Sample Website Deeplink from Response

https://www.expedia.com/mobile/deeplink/Seattle-Hotels-Amazing-2BR-Penthouse-Apt-Sun-Deck-City-Views-Walk-to-Shops-Cafes.h19007777.Hotel-Information?chkout=6/15/2021&mctc=5&chkin=6/11/2021&rateplanid=000446c69bcd817e4f34a0c273f3de26806c_83&mrp=0&rm1=a2&langid=1033&chid=992d8bc8-5407-4bb7-b709-c942738aacd2

Use Case 2: Search by Expedia Vacation Rental Property ID

Description

End user sends a Lodging Search request with a Property ID that maps to Expedia vacation rental property.
The Lodging Search API returns PropertyDetails object without PropertyManager info.
(PropertyManager only provided for Vrbo inventory.)

Sample Request

https://apim.expedia.com/hotels/listings?checkIn=2021-06-11&checkOut=2021-06-15&ecomHotelIds=26591688&allRoomTypes=true

Property Details Section

"PropertyDetails": {
                "HostLanguages": [
                    "English"
                ],
                "MaxOccupancy": 8,
                "NumberOfBedrooms": 3,
                "NumberOfBathrooms": 3,
                "SquareFeet": "1800"
            },

Sample Website Deeplink from Response

https://www.expedia.com/mobile/deeplink/Seattle-Hotels-Comfort-and-Grace-on-Queen-Anne-Hill.h26591688.Hotel-Information?chkout=6/15/2021&mctc=5&chkin=6/11/2021&rateplanid=254046345_24&mrp=0&rm1=a2&langid=1033&chid=edbcd6d0-84a3-4a63-a05a-1de424fa5ab1

Use Case 3: Search by Location Keyword

Description

End user sends a Lodging Search request with a keyword including Expedia vacation rental properties and/or Vrbo properties along with conventional lodging properties.
The Lodging Search API returns PropertyDetails object only for Expedia vacation rental properties and Vrbo vacation rental properties.
The response structure for Expedia conventional lodging properties remains the same.

Sample Request

https://apim.expedia.com/hotels/listings?checkIn=2021-06-11&checkOut=2021-06-15&locationKeyword=seattle

Use Case 4: Search by Location Keyword with Included Property Types

Description

End user sends a Lodging Search request with a keyword that includes Expedia vacation rental properties and/or Vrbo vacation rental properties, along with conventionallodging properties.
The request also includes includedPropertyTypeIds=7,9,10,11,14,16,17,18,22,23,24,33.
The Lodging Search API will only return properties with a PropertyType ID of 7,9,10,11,14,16,17,18,22,23,24, or 33.

Sample Request

https://apim.expedia.com/hotels/listings?checkIn=2021-06-11&checkOut=2021-06-15&locationKeyword=seattle&includedPropertyTypeIds=7,9,10,11,14,16,17,18,22,23,24,33

Use Case 5: Search by Region ID with Included Property Types

Description

End user sends a Lodging Search request with a Region ID that searches for accommodation for 10 people among all available Expedia vacation rental properties or Vrbo vacation rental properties by including all Property Type IDs that map to vacation rental inventory.

Sample Request

https://apim.expedia.com/hotels/listings?checkIn=2021-06-11&checkOut=2021-06-15&regionIds=3121&includedPropertyTypeIds=7,9,10,11,14,16,17,18,22,23,24,33&room1.adults=10&availOnly=true