Lodging Listings API
Guidance and examples for accessing the Lodging Listings API
The Lodging Listings API allows you to search Expedia lodging inventory by Location Keyword, Region ID, Lat/Long, or Hotel ID(s) and return up to 1,000 offers per response. It provides a deeplink to the Expedia site to book, or rate plan info to enable API booking.
Endpoint
| Method | Endpoint |
|---|---|
| GET | https://apim.expedia.com/hotels/listings |
Required Headers
| Key: | Expedia API key |
| Authorization: | More info on Authorization String Creation |
| Accept: | application/vnd.exp-hotel.v3+json |
| Partner-Transaction-Id: | Partner TransactionID String |
Optional Headers
| Accept-Encoding: | gzip [More info on gzip] |
|---|
Next Steps
- Get complete room pricing info for all rooms within a single hotel via the Lodging Details API.
- Deeplink customers to the Expedia website where they can book selected hotel.
Example Hotel Search Query
Search Request Types
Hotel ID Search Query
The Hotel ID Search is the best option for partners that would like to have full, granular control of which lodging properties are included/excluded from the search results.
https://apim.expedia.com/hotels/listings?checkIn=2022-09-01&checkOut=2022-09-05&ecomHotelIds=523223,9231567Location Keyword Search Query
The Location Keyword Search is the best option for partners that would like to query the API using the same language that users are entering into the search criteria on the partner's website. Note that using keywords as entered by the customer will most likely result in a high number of disambiguation responses (see example below) that will provide the partner with a list of possible locations from which the customer must choose the correct one.
https://apim.expedia.com/hotels/listings?checkIn=2022-09-01&checkOut=2022-09-05&locationKeyword=BangkokExpedia Region ID Search Query
The Expedia Region ID Search allows the API to be queried using the same extensive list of Region IDs that the Expedia websites use to catalog countries, cities, neighborhoods, transport centers, points of interest, etc. The value in using the Region IDs over the Location Keywords is that each Region ID is unambiguous. It maps to a single location with a single set of associated lodging properties.
You can get the complete list of Expedia Region IDs from Static Data Platform ALL_REGIONS file.
https://apim.expedia.com/hotels/listings?checkIn=2022-09-01&checkOut=2022-09-05®ionIds=3121Latitude and Longitude Search Query
The Latitude and Longitude Search is the best option for partners that would like to have geographic control of the API queries, especially in circumstances where the API query is being driven by a map view. Lat and Long are expressed by a comma-separated set of coordinates, along with parameters to describe a circle drawn around those coordinates.
https://apim.expedia.com/hotels/listings?checkIn=2022-09-01&checkOut=2022-09-05&geoLocation=47.6,-122.34&radius=50&unit=kmSearch Response with Medium Content Details
When you set the contentDetails=medium you can get a medium level of details for up to 200 lodging properties, 513 lines in the JSON example below.
Search Request
https://apim.expedia.com/hotels/listings?checkIn=2024-09-01&checkOut=2024-09-05&ecomHotelIds=523223&contentDetails=mediumSearch Response
{
"Count": 1,
"TotalHotelCount": 1,
"TransactionId": "9f5da0a7-dfc9-4621-8630-8e335d3996ee",
"StayDates": {
"CheckInDate": "2024-09-01",
"CheckOutDate": "2024-09-05"
},
"LengthOfStay": 4,
"NumberOfRooms": 1,
"Occupants": [
{
"Adults": 2
}
],
"Hotels": [
{
"Id": "523223",
"Name": "The Bailey's Hotel London Kensington",
"PropertyType": {
"Id": 1,
"Name": "Hotel"
},
"LocalCurrencyCode": "GBP",
"Location": {
"Address": {
"Address1": "140 Gloucester Road",
"City": "London",
"Province": "England",
"Country": "GBR",
"PostalCode": "SW7 4QH"
},
"GeoLocation": {
"Latitude": "51.49413",
"Longitude": "-0.182548",
"Obfuscated": false
},
"Neighborhood": {
"Id": "6195474",
"Name": "London City Centre"
}
},
"Description": {
"LocationTeaser": "Located in London City Centre, this hotel is within a 10-minute walk of Natural History Museum and Imperial College London. Kensington High Street and Victoria and Albert Museum are also within 15 minutes. Gloucester Road Underground Station is only a 2-minute walk and South Kensington Underground Station is 8 minutes. ",
"HotelTeaser": "Along with 2 restaurants, this smoke-free hotel has a fitness center and a bar/lounge. WiFi in public areas is free. Other amenities include a snack bar/deli, a 24-hour business center, and self parking. ",
"RoomTeaser": "Housekeeping is available on request. "
},
"Status": "AVAILABLE",
"ChainAndBrandInfo": {
"ChainId": -10,
"ChainName": "Millennium",
"BrandId": 263,
"BrandName": "Millennium Hotels"
},
"ThumbnailUrl": "https://images.trvl-media.com/lodging/1000000/530000/523300/523223/1d32493c_t.jpg",
"StarRating": "4.0",
"GuestRating": "4.5",
"GuestReviewCount": 1638,
"PetFriendly": false,
"LgbtqiaFriendly": true,
"Links": {
"WebSearchResult": {
"Method": "GET",
"Href": "https://www.expedia.com/Hotel-Search?regionId=6195474&selected=523223&startDate=2024-09-01&endDate=2024-09-05&adults=2&chid=9f5da0a7-dfc9-4621-8630-8e335d3996ee&tpid=1&eapid=0¤cy=USD&mctc=0&rateplanid=203042207&mpa=1039.95&mpb=207.99&mpd=USD&mpe=1719288451&mpm=24&mpn=200632687&locale=en_US"
}
},
"HotelAmenities": [
{
"Id": "2177",
"Name": "Express check-in"
},
{
"Id": "2050",
"Name": "Pets not allowed"
},
{
"Id": "1073743877",
"Name": "Water dispenser"
},
{
"Id": "8",
"Name": "Elevator"
},
{
"Id": "1073745288",
"Name": "Locally-owned & organized tours & activities"
},
{
"Id": "9",
"Name": "Fitness facilities"
},
{
"Id": "1073745293",
"Name": "Locally-sourced food on site (80% or more)"
},
{
"Id": "2063",
"Name": "24-hour front desk"
},
{
"Id": "1073745295",
"Name": "At least 80% of all lighting comes from LEDs"
},
{
"Id": "1073745296",
"Name": "All property's electricity comes from renewable sources"
},
{
"Id": "2065",
"Name": "Business center"
},
{
"Id": "2066",
"Name": "Porter/bellhop"
},
{
"Id": "1073745298",
"Name": "Vegan menu options available"
},
{
"Id": "2067",
"Name": "Express check-out"
},
{
"Id": "1073745299",
"Name": "Vegetarian menu options available"
},
{
"Id": "1073745301",
"Name": "Bulk dispenser for toiletries"
},
{
"Id": "2070",
"Name": "Dry cleaning/laundry service"
},
{
"Id": "3862",
"Name": "Self parking (surcharge)"
},
{
"Id": "1073745302",
"Name": "No single-use plastic soda bottles"
},
{
"Id": "1073745303",
"Name": "No single-use plastic stirrers"
},
{
"Id": "1073745304",
"Name": "Biodegradable/compostable stirrers"
},
{
"Id": "1073745305",
"Name": "No single-use plastic straws"
},
{
"Id": "1073745307",
"Name": "No single-use plastic water bottles"
},
{
"Id": "1073745308",
"Name": "Reusable cups only"
},
{
"Id": "1073745309",
"Name": "Reusable tableware only"
},
{
"Id": "1073745311",
"Name": "Water-efficient toilets only"
},
{
"Id": "4003",
"Name": "Luggage storage"
},
{
"Id": "43",
"Name": "Concierge services"
},
{
"Id": "3500",
"Name": "Snack bar/deli"
},
{
"Id": "3761",
"Name": "Parking (limited spaces)"
},
{
"Id": "52",
"Name": "Total number of rooms - 212"
},
{
"Id": "54",
"Name": "Number of floors - 5"
},
{
"Id": "56",
"Name": "Airport transportation (surcharge)"
},
{
"Id": "5058",
"Name": "Service animals are allowed"
},
{
"Id": "5059",
"Name": "Service animals are exempt from fees/restrictions"
},
{
"Id": "3913",
"Name": "Number of bars/lounges - 1"
},
{
"Id": "81",
"Name": "Conference space"
},
{
"Id": "2131",
"Name": "Meeting rooms"
},
{
"Id": "2387",
"Name": "Tours/ticket assistance"
},
{
"Id": "2515",
"Name": "Year Built - 1876"
},
{
"Id": "2390",
"Name": "Free WiFi"
},
{
"Id": "2392",
"Name": "Free wired internet"
},
{
"Id": "2137",
"Name": "Smoke-free property"
},
{
"Id": "2016",
"Name": "Safe-deposit box at front desk"
},
{
"Id": "1073744099",
"Name": "Proposal/romance packages available"
},
{
"Id": "1073744740",
"Name": "Wheelchair accessible – no"
},
{
"Id": "361",
"Name": "Breakfast available (surcharge)"
},
{
"Id": "2537",
"Name": "Number of restaurants - 2"
},
{
"Id": "2538",
"Name": "24-hour business center"
},
{
"Id": "369",
"Name": "Laundry facilities"
},
{
"Id": "1073745265",
"Name": "Vegetarian breakfast available"
},
{
"Id": "1073744245",
"Name": "Living plant wall"
},
{
"Id": "2043",
"Name": "Multilingual staff"
},
{
"Id": "1073744255",
"Name": "Eco-friendly cleaning products used"
}
],
"RoomAmenities": [
{
"Id": "1073744706",
"Name": "Wardrobe or closet"
},
{
"Id": "132",
"Name": "Coffee/tea maker"
},
{
"Id": "4420",
"Name": "Connecting/adjoining rooms available"
},
{
"Id": "133",
"Name": "Daily housekeeping"
},
{
"Id": "2054",
"Name": "Soundproofed rooms"
},
{
"Id": "135",
"Name": "Hypo-allergenic bedding available"
},
{
"Id": "2567",
"Name": "Individually furnished"
},
{
"Id": "136",
"Name": "Phone"
},
{
"Id": "2568",
"Name": "Individually decorated"
},
{
"Id": "1073743370",
"Name": "Towels provided"
},
{
"Id": "1073743371",
"Name": "Bedsheets provided"
},
{
"Id": "2572",
"Name": "Pillow menu"
},
{
"Id": "141",
"Name": "Private bathroom"
},
{
"Id": "1073745166",
"Name": "Desk chair"
},
{
"Id": "1073745294",
"Name": "Energy-saving switches"
},
{
"Id": "143",
"Name": "Free toiletries"
},
{
"Id": "2575",
"Name": "LCD TV"
},
{
"Id": "144",
"Name": "Hair dryer"
},
{
"Id": "146",
"Name": "In-room safe"
},
{
"Id": "3858",
"Name": "Bathtub or shower"
},
{
"Id": "147",
"Name": "Fireplace"
},
{
"Id": "1073743379",
"Name": "Number of bathrooms - 1"
},
{
"Id": "2580",
"Name": "TV size measurement: inch"
},
{
"Id": "1073745364",
"Name": "High pile carpet in room"
},
{
"Id": "1073745366",
"Name": "Area rug/s in room"
},
{
"Id": "1073744215",
"Name": "Window screens"
},
{
"Id": "1073744217",
"Name": "Electrical adapters/chargers"
},
{
"Id": "26",
"Name": "Television"
},
{
"Id": "2396",
"Name": "Satellite TV service"
},
{
"Id": "2015",
"Name": "Room service (24 hours)"
},
{
"Id": "1073742816",
"Name": "Rollaway/extra beds (surcharge)"
},
{
"Id": "2403",
"Name": "Free WiFi"
},
{
"Id": "2148",
"Name": "Access via exterior corridors"
},
{
"Id": "2405",
"Name": "Free wired internet"
},
{
"Id": "2150",
"Name": "Blackout drapes/curtains"
},
{
"Id": "2026",
"Name": "Desk"
},
{
"Id": "1073744237",
"Name": "Laptop-friendly workspace"
},
{
"Id": "2030",
"Name": "In-room climate control (air conditioning)"
},
{
"Id": "1073744239",
"Name": "Composting"
},
{
"Id": "1073744240",
"Name": "Eco-friendly cleaning products provided"
},
{
"Id": "1073744241",
"Name": "Eco-friendly toiletries"
},
{
"Id": "1073744242",
"Name": "LED light bulbs"
},
{
"Id": "1073744243",
"Name": "Recycling"
},
{
"Id": "1073744244",
"Name": "Reusable coffee/tea filters"
},
{
"Id": "1073743926",
"Name": "Housekeeping on request"
},
{
"Id": "123",
"Name": "Cable/satellite TV service"
},
{
"Id": "1073744828",
"Name": "Change of towels (on request)"
},
{
"Id": "1073744574",
"Name": "Heated floors"
}
],
"RoomTypes": [
{
"Description": "Classic Double Room",
"RoomKey": "CgY1MjMyMjMSNAoJMjAwNjMyNjg3EgkyMDMwNDIyMDcaAjI0IAEqCjIwMjQtMDktMDEyCjIwMjQtMDktMDUqAwoBMkoBMFIKCODTAhDg0wIYAVIKCLGtAhCxrQIYAVIKCK_XARCv1wEYAloCVVNyAQE",
"OfferId": "CgY1MjMyMjMSNAoJMjAwNjMyNjg3EgkyMDMwNDIyMDcaAjI0IAEqCjIwMjQtMDktMDEyCjIwMjQtMDktMDUqAwoBMkoBMFIKCODTAhDg0wIYAVIKCLGtAhCxrQIYAVIKCK_XARCv1wEYAloCVVNyAQE",
"RatePlanType": "standalone",
"RatePlans": [
{
"RoomTypeId": "200632687",
"RatePlanId": "203042207",
"RateRuleId": "205104966",
"InventorySourceId": "24",
"InventorySourceCode": "Expedia",
"StayDates": {
"CheckInDate": "2024-09-01",
"CheckOutDate": "2024-09-05"
},
"RemainingCount": 36,
"Price": {
"BaseRate": {
"Value": "1039.95",
"Currency": "USD"
},
"TaxesAndFees": {
"Value": "207.99",
"Currency": "USD"
},
"TotalPrice": {
"Value": "1247.94",
"Currency": "USD"
},
"AvgNightlyRate": {
"Value": "259.99",
"Currency": "USD"
},
"NightlyRates": [
{
"StayDate": "2024-09-01",
"BaseRate": {
"Value": "272.67",
"Currency": "USD"
}
},
{
"StayDate": "2024-09-02",
"BaseRate": {
"Value": "247.30",
"Currency": "USD"
}
},
{
"StayDate": "2024-09-03",
"BaseRate": {
"Value": "259.99",
"Currency": "USD"
}
},
{
"StayDate": "2024-09-04",
"BaseRate": {
"Value": "259.99",
"Currency": "USD"
}
}
],
"TaxesAndFeesDetails": [
{
"CategoryCode": "412",
"Amount": {
"Value": "207.99",
"Currency": "USD"
}
}
]
},
"PaymentMethod": "Hotel",
"PaymentTime": "PayLater",
"FreeInternet": true,
"FreeWiFi": true,
"FreeInternetDetails": [
"Free WiFi",
"Free wired internet"
],
"FreeParking": false,
"FreeBreakfast": false,
"CancellationPolicy": {
"Refundable": true,
"FreeCancellation": true,
"FreeCancellationEndDateTime": "2024-08-31T14:00:00+01:00",
"CancellationPenaltyRules": [
{
"PenaltyNightCount": 1,
"PenaltyStartDateTime": "2024-08-31T14:00:00+01:00",
"PenaltyEndDateTime": "2024-09-01T14:00:00+01:00"
}
],
"CancelPolicyDescription": "There is no charge for cancellations made before 14:00 (property local time) on August 31, 2024.Cancellations or changes made after 14:00 (property local time) on August 31, 2024 or no-shows are subject to a property fee equal to the first nights rate plus taxes and fees."
}
}
],
"Price": {
"BaseRate": {
"Value": "1039.95",
"Currency": "USD"
},
"TaxesAndFees": {
"Value": "207.99",
"Currency": "USD"
},
"TotalPrice": {
"Value": "1247.94",
"Currency": "USD"
},
"AvgNightlyRate": {
"Value": "259.99",
"Currency": "USD"
},
"AvgNightlyRateWithFees": {
"Value": "259.99",
"Currency": "USD"
},
"TotalPriceWithHotelFees": {
"Value": "1247.94",
"Currency": "USD"
}
},
"Links": {
"WebDetails": {
"Method": "GET",
"Href": "https://www.expedia.com/Hotel.h523223.Hotel-Information?mpd=USD&tpid=1&mpe=1719288451&chkin=2024-09-01&mpm=24&chid=9f5da0a7-dfc9-4621-8630-8e335d3996ee&eapid=0&chkout=2024-09-05®ionId=6195474&mctc=0¤cy=USD&rateplanid=203042207&rm1=a2&langid=1033&mpb=207.99&mpa=1039.95"
}
},
"Amenities": [
{
"Id": "4097",
"Name": "Number of living rooms 0"
},
{
"Id": "4209",
"Name": "Iron/ironing board (on request)"
},
{
"Id": "4164",
"Name": "Egyptian-cotton sheets"
},
{
"Id": "4948",
"Name": "Free cribs/infant beds"
},
{
"Id": "4231",
"Name": "Premium bedding"
},
{
"Id": "4953",
"Name": "Number of bedrooms - 0"
},
{
"Id": "4138",
"Name": "Free bottled water"
},
{
"Id": "4347",
"Name": "Free WiFi"
},
{
"Id": "4092",
"Name": "Square meters - 25"
},
{
"Id": "4093",
"Name": "Square feet - 269"
},
{
"Id": "1073744318",
"Name": "Ping - 7.56"
}
]
}
]
}
]
}Search Response with High Content Details
When you set the contentDetails=high you can get a high level of detail, but your search results will be limited to no more than 5 lodging properties, 1046 lines in the JSON example below with redundant list elements removed.
Search Request
https://apim.expedia.com/hotels/listings?checkIn=2024-09-01&checkOut=2024-09-05&ecomHotelIds=523223&contentDetails=highSearch Response
{
"Count": 1,
"TotalHotelCount": 1,
"TransactionId": "dcff937e-3c26-4a1b-8763-fce27186794d",
"StayDates": {
"CheckInDate": "2024-09-01",
"CheckOutDate": "2024-09-05"
},
"LengthOfStay": 4,
"NumberOfRooms": 1,
"Occupants": [
{
"Adults": 2
}
],
"Hotels": [
{
"Id": "523223",
"Name": "The Bailey's Hotel London Kensington",
"PropertyType": {
"Id": 1,
"Name": "Hotel"
},
"LocalCurrencyCode": "GBP",
"Location": {
"Address": {
"Address1": "140 Gloucester Road",
"City": "London",
"Province": "England",
"Country": "GBR",
"PostalCode": "SW7 4QH"
},
"GeoLocation": {
"Latitude": "51.49413",
"Longitude": "-0.182548",
"Obfuscated": false
},
"Neighborhood": {
"Id": "6195474",
"Name": "London City Centre"
}
},
"Description": {
"LocationTeaser": "Located in London City Centre, this hotel is within a 10-minute walk of Natural History Museum and Imperial College London. Kensington High Street and Victoria and Albert Museum are also within 15 minutes. Gloucester Road Underground Station is only a 2-minute walk and South Kensington Underground Station is 8 minutes. ",
"HotelTeaser": "Along with 2 restaurants, this smoke-free hotel has a fitness center and a bar/lounge. WiFi in public areas is free. Other amenities include a snack bar/deli, a 24-hour business center, and self parking. ",
"RoomTeaser": "Housekeeping is available on request. "
},
"Status": "AVAILABLE",
"ChainAndBrandInfo": {
"ChainId": -10,
"ChainName": "Millennium",
"BrandId": 263,
"BrandName": "Millennium Hotels"
},
"ThumbnailUrl": "https://images.trvl-media.com/lodging/1000000/530000/523300/523223/1d32493c_t.jpg",
"StarRating": "4.0",
"GuestRating": "4.5",
"GuestReviewCount": 1638,
"PetFriendly": false,
"LgbtqiaFriendly": true,
"Links": {
"WebSearchResult": {
"Method": "GET",
"Href": "https://www.expedia.com/Hotel-Search?regionId=6195474&selected=523223&startDate=2024-09-01&endDate=2024-09-05&adults=2&chid=dcff937e-3c26-4a1b-8763-fce27186794d&tpid=1&eapid=0¤cy=USD&mctc=0&rateplanid=203042207&mpa=1039.95&mpb=207.99&mpd=USD&mpe=1719288510&mpm=24&mpn=200632687&locale=en_US"
}
},
"Policies": {
"CheckInStartTime": "3:00 PM",
"CheckInEndTime": "midnight",
"SpecialCheckInInstructions": [
"This property offers transfers from the airport (surcharges may apply). Guests must contact the property with arrival details before travel, using the contact information on the booking confirmation. Front desk staff will greet guests on arrival. For more details, please contact the property using the information on the booking confirmation. ",
"The credit card used to book the reservation must be presented by the cardholder at check-in along with matching photo identification. "
],
"CheckOutTime": "noon",
"PetPolicies": [
"Pets not allowed (service animals welcome)"
],
"ChildrenAndExtraBedsPolicies": [
"Children are welcome.",
"Kids stay free! One child 2 years old or younger stays free when using existing bedding. ",
"Rollaway/extra beds are available for GBP 36.0 per day."
]
},
"OptionalExtras": [
"<ul> <li>Fee for English breakfast: approximately GBP 22.50 for adults and GBP 11.25 for children</li><li>Airport shuttle fee: GBP 60 per vehicle (one-way, maximum occupancy 4)</li><li>Self parking fee: GBP 50 per day</li><li>Early check-in fee: GBP 25 (subject to availability)</li><li>Late check-out fee: GBP 20 (subject to availability)</li><li>Rollaway bed fee: GBP 36.0 per day</li></ul>",
"<p>The above list may not be comprehensive. Fees and deposits may not include tax and are subject to change. </p>"
],
"Media": [
...
{
"Type": "1",
"Title": "Exterior",
"Size": "t",
"Url": "https://images.trvl-media.com/lodging/1000000/530000/523300/523223/d5c633ac_t.jpg"
}
],
"HotelAmenities": [
...
{
"Id": "1073744255",
"Name": "Eco-friendly cleaning products used"
}
],
"RoomAmenities": [
...
{
"Id": "1073744574",
"Name": "Heated floors"
}
],
"Accessibility": [
"Visual alarms in hallways",
"Sign language-capable staff",
"Handrails in hallways",
"Handrails in stairways",
"Wheelchairs available on site",
"Braille or raised signage"
],
"RoomTypes": [
{
"Description": "Classic Double Room",
"RoomKey": "CgY1MjMyMjMSNAoJMjAwNjMyNjg3EgkyMDMwNDIyMDcaAjI0IAEqCjIwMjQtMDktMDEyCjIwMjQtMDktMDUqAwoBMkoBMFIKCODTAhDg0wIYAVIKCLGtAhCxrQIYAVIKCK_XARCv1wEYAloCVVNyAQE",
"OfferId": "CgY1MjMyMjMSNAoJMjAwNjMyNjg3EgkyMDMwNDIyMDcaAjI0IAEqCjIwMjQtMDktMDEyCjIwMjQtMDktMDUqAwoBMkoBMFIKCODTAhDg0wIYAVIKCLGtAhCxrQIYAVIKCK_XARCv1wEYAloCVVNyAQE",
"RatePlanType": "standalone",
"RatePlans": [
{
"RoomTypeId": "200632687",
"RatePlanId": "203042207",
"RateRuleId": "205104966",
"InventorySourceId": "24",
"InventorySourceCode": "Expedia",
"StayDates": {
"CheckInDate": "2024-09-01",
"CheckOutDate": "2024-09-05"
},
"RemainingCount": 36,
"Price": {
"BaseRate": {
"Value": "1039.95",
"Currency": "USD"
},
"TaxesAndFees": {
"Value": "207.99",
"Currency": "USD"
},
"TotalPrice": {
"Value": "1247.94",
"Currency": "USD"
},
"AvgNightlyRate": {
"Value": "259.99",
"Currency": "USD"
},
"NightlyRates": [
{
"StayDate": "2024-09-01",
"BaseRate": {
"Value": "272.67",
"Currency": "USD"
}
},
{
"StayDate": "2024-09-02",
"BaseRate": {
"Value": "247.30",
"Currency": "USD"
}
},
{
"StayDate": "2024-09-03",
"BaseRate": {
"Value": "259.99",
"Currency": "USD"
}
},
{
"StayDate": "2024-09-04",
"BaseRate": {
"Value": "259.99",
"Currency": "USD"
}
}
],
"TaxesAndFeesDetails": [
{
"CategoryCode": "412",
"Amount": {
"Value": "207.99",
"Currency": "USD"
}
}
]
},
"PaymentMethod": "Hotel",
"PaymentTime": "PayLater",
"FreeInternet": true,
"FreeWiFi": true,
"FreeInternetDetails": [
"Free WiFi",
"Free wired internet"
],
"FreeParking": false,
"FreeBreakfast": false,
"CancellationPolicy": {
"Refundable": true,
"FreeCancellation": true,
"FreeCancellationEndDateTime": "2024-08-31T14:00:00+01:00",
"CancellationPenaltyRules": [
{
"PenaltyNightCount": 1,
"PenaltyStartDateTime": "2024-08-31T14:00:00+01:00",
"PenaltyEndDateTime": "2024-09-01T14:00:00+01:00"
}
],
"CancelPolicyDescription": "There is no charge for cancellations made before 14:00 (property local time) on August 31, 2024.Cancellations or changes made after 14:00 (property local time) on August 31, 2024 or no-shows are subject to a property fee equal to the first nights rate plus taxes and fees."
}
}
],
"Price": {
"BaseRate": {
"Value": "1039.95",
"Currency": "USD"
},
"TaxesAndFees": {
"Value": "207.99",
"Currency": "USD"
},
"TotalPrice": {
"Value": "1247.94",
"Currency": "USD"
},
"AvgNightlyRate": {
"Value": "259.99",
"Currency": "USD"
},
"AvgNightlyRateWithFees": {
"Value": "259.99",
"Currency": "USD"
},
"TotalPriceWithHotelFees": {
"Value": "1247.94",
"Currency": "USD"
}
},
"Links": {
"WebDetails": {
"Method": "GET",
"Href": "https://www.expedia.com/Hotel.h523223.Hotel-Information?mpd=USD&tpid=1&mpe=1719288510&chkin=2024-09-01&mpm=24&chid=dcff937e-3c26-4a1b-8763-fce27186794d&eapid=0&chkout=2024-09-05®ionId=6195474&mctc=0¤cy=USD&rateplanid=203042207&rm1=a2&langid=1033&mpb=207.99&mpa=1039.95"
}
},
"SmokingOption": "NonSmoking",
"BedTypeOptions": [
{
"Id": "37310",
"Description": "1 Queen Bed"
}
],
"RoomOccupancyPolicy": {
"MaxGuestCount": 3,
"MinCheckInAge": 18,
"AgeClassRestrictions": [
{
"AgeClass": "Adult",
"AgeMinimum": 3,
"MaxGuestCount": 2
},
{
"AgeClass": "Child",
"AgeMinimum": 0,
"AgeMaximum": 2,
"MaxGuestCount": 1
}
]
},
"Amenities": [
...
{
"Id": "1073744318",
"Name": "Ping - 7.56"
}
],
"Media": [
...
{
"Type": "1",
"Title": "Bathroom",
"Size": "t",
"Url": "https://images.trvl-media.com/lodging/1000000/530000/523300/523223/43e68029_t.jpg"
}
]
}
]
}
]
}Vacation Rental Search and Response
Expedia inventory includes both conventional lodging (hotels, etc.) and vacation rental lodging (private homes, etc.). You can include or exclude vacation rental inventory through querying using the PropertyTypeId value.
All Expedia Group Vacation Rental Properties
Partners who would like to only return vacation rental properties should use the IncludePropertyTypeIDs parameter. A complete list of supported Expedia Property Types can be found in Lodging Property Types.
https://apim.expedia.com/hotels/listings?checkIn=2022-09-01&checkOut=2022-09-05&locationKeyword=dusseldorf&includedPropertyTypeIds=7,9,10,11,14,16,17,18,22,23,24,33&availOnly=trueOnly Vrbo Vacation Rental Properties
Partners who are searching via API to land the customer on a Vrbo website should use the InventorySourceID parameter to return only Vrbo properties.
https://apim.expedia.com/hotels/listings?checkIn=2022-09-01&checkOut=2022-09-05&locationKeyword=dusseldorf&includedInventorySourceIds=83,103&availOnly=trueSearch Response
We have included the availOnly=true parameter in the example request, as many vacation rental properties are only available for a certain portion of the year. This request parameter will only return properties that have availability during the requested dates.
Vacation rental properties include a PropertyDetails section to contain data elements that are specific to a vacation rental listing.
{
"Count": 48,
"TotalHotelCount": 321,
"TransactionId": "fe695f99-759e-4c5a-a385-1783690a61f2",
"StayDates": {
"CheckInDate": "2022-09-01",
"CheckOutDate": "2022-09-05"
},
"LengthOfStay": 4,
"NumberOfRooms": 1,
"Occupants": [{
"Adults": 2
}],
"Hotels": [{
"Id": "14904894",
"Name": "Appartement quiet, nice view Haan",
"PropertyType": {
"Id": 16,
"Name": "Apartment"
},
"PropertyDetails": {
"HostLanguages": [
"English",
"German"
],
"MaxOccupancy": 2,
"NumberOfBedrooms": 1,
"NumberOfBathrooms": 1,
"SquareFeet": "592"
},
"LocalCurrencyCode": "EUR",
"Location": {
"Address": {
"Address1": "Flemingstrasse 19",
"City": "Haan",
"Country": "DEU",
"PostalCode": "42781"
},
"GeoLocation": {
"Latitude": "35.997377",
"Longitude": "-115.127719"
},
"Neighborhood": {
"Id": "800045",
"Name": "Quartier Las Vegas Strip"
}
},
"Distance": {
"Value": "16.93",
"Unit": "km",
"Direction": "E"
},
"Description": {
"LocationTeaser": "Located in Düsseldorf Government Region, this apartment building is within 9 mi (15 km) of Wuppertal Zoo, Neanderthal Museum, and Historic City Hall. Von der Heydt-Museum and Muengsten Bridge Park are also within 9 mi (15 km). Haan Station is 27 minutes by foot. ",
"HotelTeaser": "This smoke-free apartment building features free WiFi in public areas. ",
"RoomTeaser": "The apartment features a kitchen with a refrigerator and a microwave, plus free WiFi and a TV with cable channels. A balcony, a rainfall shower, and a hair dryer are among the other amenities available to guests. "
},
"Status": "AVAILABLE",
"ThumbnailUrl": "https://images.trvl-media.com/hotels/15000000/14910000/14904900/14904894/7fde3b54_t.jpg",
"StarRating": "3.0",
"Links": {
"WebSearchResult": {
"Method": "GET",
"Href": "https://www.expedia.de/go/hotel/search/pinned/14904894/2022-09-01/2022-09-05?tpid=6&NumAdult1=2&mrp=0&chid=fe695f99-759e-4c5a-a385-1783690a61f2&eapid=13784&NumRoom=1&rateplanid=207490097_24¤cy=EUR&langid=1033&NumNights=4"
}
}
...
}]
}Dateless Hotel Search
You can query the API without dates of stay to receive a dateless search response in return but be advised that dateless search response prices are NOT bookable prices, they are for comparison only.
Search Request
https://apim.expedia.com/hotels/listings?ecomHotelIds=9231567Search Response
{
"Count": 1,
"TotalHotelCount": 1,
"TransactionId": "99993347-3393-4cf0-89f3-662255824e0a",
"NumberOfRooms": 1,
"Occupants": [
{
"Adults": 2
}
],
"Hotels": [
{
"Id": "9231567",
"Name": "Embassy Suites Oklahoma City Downtown/Medical Center",
"PropertyType": {
"Id": 1,
"Name": "Hotel"
},
"Location": {
"Address": {
"Address1": "741 North Phillips Avenue",
"City": "Oklahoma City",
"Province": "OK",
"Country": "USA",
"PostalCode": "73104"
},
"GeoLocation": {
"Latitude": "35.47489",
"Longitude": "-97.498955",
"Obfuscated": false
},
"Neighborhood": {
"Id": "553248635976470866",
"Name": "Central Oklahoma City"
}
},
"Description": {
"LocationTeaser": "Located in Central Oklahoma City, this hotel is within a 10-minute walk of OU Medical Center and OU Children's Hospital. Oklahoma City VA Health Care System and 89'er Museum Park are also within 15 minutes. Santa Fe Depot is 28 minutes by foot. ",
"HotelTeaser": "An indoor pool, a restaurant, and a 24-hour fitness center are available at this smoke-free hotel. Free cooked-to-order breakfast, free WiFi in public areas, and a free manager's reception are also provided. Other amenities include a bar/lounge, a 24-hour business center, and self parking. "
},
"ChainAndBrandInfo": {
"ChainId": -5,
"ChainName": "Hilton Worldwide",
"BrandId": 38,
"BrandName": "Embassy Suites"
},
"ThumbnailUrl": "https://images.trvl-media.com/lodging/10000000/9240000/9231600/9231567/9cd9737c_t.jpg",
"StarRating": "3.5",
"GuestRating": "4.6",
"GuestReviewCount": 1002,
"PetFriendly": true,
"LgbtqiaFriendly": true,
"Links": {
"WebSearchResult": {
"Method": "GET",
"Href": "https://www.expedia.com/Hotel-Search?regionId=553248635976470866&selected=9231567&adults=2&chid=99993347-3393-4cf0-89f3-662255824e0a&tpid=1&eapid=0¤cy=USD&mctc=0&mpa=139.92&mpd=USD&mpe=1719288650&locale=en_US"
}
},
"RoomTypes": [
{
"Description": "1 Room Suite, 1 King Bed",
"Price": {
"TotalPrice": {
"Value": "139.92",
"Currency": "USD"
},
"TotalPriceWithHotelFees": {
"Value": "159.69",
"Currency": "USD"
}
},
"Links": {
"WebDetails": {
"Method": "GET",
"Href": "https://www.expedia.com/Hotel.h9231567.Hotel-Information?mpd=USD&tpid=1&mpe=1719288650&chkin=2024-07-01&chid=99993347-3393-4cf0-89f3-662255824e0a&eapid=0&chkout=2024-07-02®ionId=553248635976470866&mctc=0¤cy=USD&rm1=a2&langid=1033&mpa=139.92"
}
}
}
]
}
]
}Disambiguation Response
When you search for a locationKeyword that could refer to one of several global locations, the API will ask you to clarify which of those locations you'd like to search:
{
"Errors": [
{
"Code": "AMBIGUOUS_LOCATION",
"DetailCode": "MULTIPLE_AMBIGUOUS_LOCATION",
"Description": "More than one location found",
"LocationKeyword": "dublin",
"LocationOptions": [
{
"Type": "MULTICITY",
"RegionId": "178256",
"ShortName": "Dublin (and vicinity)",
"AirportCode": "DUB",
"Address": "Dublin (and vicinity), Ireland",
"Country": {
"Name": "Ireland",
"IsoCode2": "IE",
"IsoCode3": "IRL"
},
"GeoLocation": {
"Latitude": "53.34402",
"Longitude": "-6.26146"
}
},
...
{
"Type": "POI",
"RegionId": "553248621563220238",
"ShortName": "Market On Madison",
"AirportCode": "MCN",
"Address": "Market On Madison, Dublin, Georgia, United States of America",
"Country": {
"Name": "United States of America",
"IsoCode2": "US",
"IsoCode3": "USA"
},
"GeoLocation": {
"Latitude": "32.539313",
"Longitude": "-82.902537"
}
}
]
}
],
"TransactionId": "cc026998-5e61-4613-a086-7c725def7eea"
}Error Codes
API details
Here, you can explore the endpoint definitions for this API, then go to the API Explorer to try out all the XAP endpoints, download OpenAPI specs, or download our Postman collections. Testing with one or all of these options will give you an understanding of how the examples and schema definitions compare to the actual output.