Expedia Hotels API
The Expedia Hotels API returns Expedia's hotels and other stays for a place and dates, up to 50 per page in the order asked for. Each property carries its guest rating and review count, area, coordinates, amenities and badges, its nightly price and the stay's total with taxes and fees, and whether it is fully refundable or VIP Access. Filter by stars, rating, property type, amenities, nightly price or free cancellation, sort by price or stars, and page through the results.
API Parameters
Search Query
-
- Name
-
q - Required
- Required
- Description
-
Parameter defines where to search: a city, region, neighborhood, landmark, airport or hotel name, such as
Paris,Eiffel TowerorJFK, up to 100 characters. The search runs on the place Expedia suggests for it, named insearch_information.destination, and a hotel name searches that hotel's city.
Dates and Guests
-
- Name
-
check_in_date - Required
- Required
- Description
-
Parameter defines the check-in date in
YYYY-MM-DDformat, from today.
-
- Name
-
check_out_date - Required
- Required
- Description
-
Parameter defines the check-out date in
YYYY-MM-DDformat, aftercheck_in_dateand up to 500 days ahead.
-
- Name
-
adults - Required
- Optional
- Description
-
Parameter defines the number of adults, at least one per room. It defaults to
2.
-
- Name
-
children_ages - Required
- Optional
- Description
-
Parameter defines the ages of the children as a comma-separated list, such as
5,10, each from 0 to 17.
-
- Name
-
rooms - Required
- Optional
- Description
-
Parameter defines the number of rooms, from 1 to 8. It defaults to
1, and the guests are spread over the rooms. Prices cover every room and night.
Filters
-
- Name
-
sort_by - Required
- Optional
- Description
-
Parameter defines the order of the properties. It can be set to
relevance,lowest_price,highest_priceorhighest_class, and defaults torelevance.
-
- Name
-
hotel_class - Required
- Optional
- Description
-
Parameter keeps only the properties with these star ratings, as a comma-separated list from 1 to 5, such as
4,5.
-
- Name
-
rating - Required
- Optional
- Description
-
Parameter keeps only the properties with at least this guest rating out of 10. It can be set to
7,8or9.
-
- Name
-
property_types - Required
- Optional
- Description
-
Parameter keeps only these types of property, as a comma-separated list of
hotel,hostel,aparthotel,bed_and_breakfast,resort,guest_house,apartment,house,villa,cabin,cottage,chalet,lodge,residence,palace,country_house,farm_stay,houseboat,boat,rvorcruise.
-
- Name
-
amenities - Required
- Optional
- Description
-
Parameter keeps only the properties with every one of these amenities, as a comma-separated list of
breakfast_included,all_inclusive,pay_later,vip_access,free_airport_shuttle,wifi,fitness_center,air_conditioning,pool,spa,hot_tub,kitchen,washer_dryer,restaurant,pet_friendly,crib,outdoor_space,ev_chargerorparking.
-
- Name
-
free_cancellation - Required
- Optional
- Description
-
Parameter keeps only fully refundable properties when set to
true.
-
- Name
-
price_min - Required
- Optional
- Description
-
Parameter keeps only the properties with a nightly price of at least this many US dollars.
-
- Name
-
price_max - Required
- Optional
- Description
-
Parameter keeps only the properties with a nightly price of at most this many US dollars, above
price_min.
Pagination
-
- Name
-
page - Required
- Optional
- Description
-
Parameter defines the page of results, with up to 50 properties per page, from 1 to 40. It defaults to
1, andpagination.nextis the next page while there is one.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
expedia_hotels.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Full Response
https://www.searchapi.io/api/v1/search?check_in_date=2026-12-13&check_out_date=2026-12-15&engine=expedia_hotels&q=New+York
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "expedia_hotels",
"q": "New York",
"check_in_date": "2026-12-13",
"check_out_date": "2026-12-15"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_6QNVPZBKo24jcW4Ep8y471M9",
"status": "Success",
"created_at": "2026-11-12T09:51:25Z",
"request_time_taken": 11.48,
"parsing_time_taken": 0.01,
"total_time_taken": 11.49,
"request_url": "https://www.expedia.com/Hotel-Search?destination=New+York&startDate=2026-12-12&endDate=2026-12-14&adults=2&sort=RECOMMENDED",
"html_url": "https://www.searchapi.io/api/v1/searches/search_6QNVPZBKo24jcW4Ep8y471M9.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_6QNVPZBKo24jcW4Ep8y471M9"
},
"search_parameters": {
"engine": "expedia_hotels",
"q": "New York",
"check_in_date": "2026-12-12",
"check_out_date": "2026-12-14",
"sort_by": "relevance"
},
"search_information": {
"total_results": 469,
"destination": "New York, New York, United States of America",
"destination_type": "city",
"check_in_date": "2026-12-12",
"check_out_date": "2026-12-14",
"nights": 2,
"currency": "USD"
},
"properties": [
{
"position": 1,
"property_id": "17117062",
"title": "PUBLIC, an Ian Schrager hotel",
"link": "https://www.expedia.com/New-York-Hotels-PUBLIC.h17117062.Hotel-Information",
"location": "New York",
"gps_coordinates": {
"latitude": 40.723087,
"longitude": -73.992066
},
"rating": 8.8,
"max_rating": 10,
"rating_word": "Excellent",
"reviews": 4099,
"badges": [
"VIP Access",
"Member Price available"
],
"amenities": [
"Bar and lounge",
"Rooftop terrace",
"Coffee shop"
],
"price_per_night": {
"price": "$673",
"extracted_price": 673
},
"total_price": {
"price": "$1,654",
"extracted_price": 1654
},
"is_free_cancellation": false,
"is_vip_access": true,
"images": [
{
"thumbnail": "https://images.trvl-media.com/lodging/18000000/17120000/17117100/17117062/33210c6e.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/18000000/17120000/17117100/17117062/33210c6e.jpg",
"description": "A rooftop terrace with a city skyline view at sunset, featuring a sofa, a coffee table, and potted plants."
},
{
"thumbnail": "https://images.trvl-media.com/lodging/18000000/17120000/17117100/17117062/3bc6f538.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/18000000/17120000/17117100/17117062/3bc6f538.jpg",
"description": "A restaurant with round tables, cushioned seating, and a bar area with shelves of bottles."
}
]
},
{
"position": 2,
"property_id": "19681371",
"title": "Pod Times Square",
"link": "https://www.expedia.com/New-York-Hotels-Pod-Times-Square.h19681371.Hotel-Information",
"location": "New York",
"gps_coordinates": {
"latitude": 40.758428,
"longitude": -73.99316
},
"rating": 9.2,
"max_rating": 10,
"rating_word": "Wonderful",
"reviews": 6315,
"badges": [
"$203 off"
],
"amenities": [
"Bar and lounge",
"Restaurant",
"Breakfast for a fee"
],
"price_per_night": {
"price": "$344",
"extracted_price": 344
},
"total_price": {
"price": "$855",
"extracted_price": 855,
"original_price": "$1,058",
"extracted_original_price": 1058
},
"is_free_cancellation": false,
"is_vip_access": false,
"images": [
{
"thumbnail": "https://images.trvl-media.com/lodging/20000000/19690000/19681400/19681371/448cd4c3.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/20000000/19690000/19681400/19681371/448cd4c3.jpg",
"description": "An outdoor seating area with wicker chairs and tables, surrounded by large windows and a backdrop of tall buildings."
},
{
"thumbnail": "https://images.trvl-media.com/lodging/20000000/19690000/19681400/19681371/2f750c59.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/20000000/19690000/19681400/19681371/2f750c59.jpg",
"description": "A bar area with shelves of liquor bottles, a disco ball, and a long bar counter with stools."
}
]
},
{
"position": 3,
"property_id": "48669360",
"title": "Arlo Midtown",
"link": "https://www.expedia.com/New-York-Hotels-Arlo-Midtown.h48669360.Hotel-Information",
"location": "New York",
"gps_coordinates": {
"latitude": 40.755761,
"longitude": -73.99386
},
"rating": 9.4,
"max_rating": 10,
"rating_word": "Exceptional",
"reviews": 6206,
"badges": [
"VIP Access",
"Member Price available"
],
"amenities": [
"Bar and lounge",
"Rooftop terrace",
"Coffee shop"
],
"price_per_night": {
"price": "$553",
"extracted_price": 553
},
"total_price": {
"price": "$1,363",
"extracted_price": 1363,
"original_price": "$1,468",
"extracted_original_price": 1468
},
"is_free_cancellation": true,
"is_vip_access": true,
"images": [
{
"thumbnail": "https://images.trvl-media.com/lodging/49000000/48670000/48669400/48669360/e2438218.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/49000000/48670000/48669400/48669360/e2438218.jpg",
"description": "A restaurant with a long dining table, cushioned seating, and a glass ceiling."
},
{
"thumbnail": "https://images.trvl-media.com/lodging/49000000/48670000/48669400/48669360/cd4be96d.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/49000000/48670000/48669400/48669360/cd4be96d.jpg",
"description": "An outdoor dining area with brick walls, wooden flooring, and wicker chairs."
}
]
}
],
"pagination": {
"current": 1,
"total_pages": 10,
"next": 2
}
}
Four and Five Stars Near a Landmark, Fully Refundable, Cheapest First
https://www.searchapi.io/api/v1/search?check_in_date=2026-12-28&check_out_date=2026-12-31&engine=expedia_hotels&free_cancellation=true&hotel_class=4%2C5&q=Eiffel+Tower&sort_by=lowest_price
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "expedia_hotels",
"q": "Eiffel Tower",
"check_in_date": "2026-12-28",
"check_out_date": "2026-12-31",
"hotel_class": "4,5",
"free_cancellation": true,
"sort_by": "lowest_price"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_KaMw9PG4o4X1SOwXokEzRrvY",
"status": "Success",
"created_at": "2026-11-12T09:44:53Z",
"request_time_taken": 2.44,
"parsing_time_taken": 0.12,
"total_time_taken": 2.56,
"request_url": "https://www.expedia.com/Hotel-Search?destination=Eiffel+Tower&startDate=2026-12-27&endDate=2026-12-30&adults=2&sort=PRICE_LOW_TO_HIGH",
"html_url": "https://www.searchapi.io/api/v1/searches/search_KaMw9PG4o4X1SOwXokEzRrvY.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_KaMw9PG4o4X1SOwXokEzRrvY"
},
"search_parameters": {
"engine": "expedia_hotels",
"q": "Eiffel Tower",
"check_in_date": "2026-12-27",
"check_out_date": "2026-12-30",
"sort_by": "lowest_price",
"hotel_class": "4,5",
"free_cancellation": true
},
"search_information": {
"total_results": 361,
"destination": "Eiffel Tower, Paris, France",
"destination_type": "poi",
"check_in_date": "2026-12-27",
"check_out_date": "2026-12-30",
"nights": 3,
"currency": "USD"
},
"properties": [
{
"position": 1,
"property_id": "18023637",
"title": "OKKO Hotels Paris Porte de Versailles",
"link": "https://www.expedia.com/Paris-Hotels-OKKO-Hotels-Paris-Porte-De-Versailles.h18023637.Hotel-Information",
"extracted_hotel_class": 4,
"location": "Paris",
"gps_coordinates": {
"latitude": 48.832649,
"longitude": 2.2781
},
"rating": 8.8,
"max_rating": 10,
"rating_word": "Excellent",
"reviews": 1000,
"badges": [
"$138 off"
],
"amenities": [
"Restaurant",
"Bar and lounge",
"Fitness center"
],
"price_per_night": {
"price": "$118",
"extracted_price": 118
},
"total_price": {
"price": "$446",
"extracted_price": 446,
"original_price": "$584",
"extracted_original_price": 584
},
"is_free_cancellation": true,
"is_vip_access": false,
"images": [
{
"thumbnail": "https://images.trvl-media.com/lodging/19000000/18030000/18023700/18023637/41e3d4ab.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/19000000/18030000/18023700/18023637/41e3d4ab.jpg",
"description": "A modern dining area with a long table set for six, surrounded by six stools."
},
{
"thumbnail": "https://images.trvl-media.com/lodging/19000000/18030000/18023700/18023637/60f916c3.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/19000000/18030000/18023700/18023637/60f916c3.jpg",
"description": "A modern building facade with a mesh-like window design and signage for \"OKKO HOTELS\"."
}
]
},
{
"position": 2,
"property_id": "53541",
"title": "Mercure Paris Montparnasse Pasteur",
"link": "https://www.expedia.com/Paris-Hotels-Mercure-Paris-Montparnasse-Pasteur.h53541.Hotel-Information",
"extracted_hotel_class": 4,
"location": "Paris",
"gps_coordinates": {
"latitude": 48.83763,
"longitude": 2.306367
},
"rating": 8.4,
"max_rating": 10,
"rating_word": "Very Good",
"reviews": 215,
"badges": [
"$153 off"
],
"amenities": [
"Bar and lounge",
"Veggie options",
"Public WiFi"
],
"price_per_night": {
"price": "$139",
"extracted_price": 139
},
"total_price": {
"price": "$516",
"extracted_price": 516,
"original_price": "$670",
"extracted_original_price": 670
},
"is_free_cancellation": true,
"is_vip_access": false,
"images": [
{
"thumbnail": "https://images.trvl-media.com/lodging/1000000/60000/53600/53541/4858cf06.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/1000000/60000/53600/53541/4858cf06.jpg",
"description": "A table set for two with a dessert display, two glasses of champagne, and a view of the Eiffel Tower."
},
{
"thumbnail": "https://images.trvl-media.com/lodging/1000000/60000/53600/53541/02dd6cbf.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/1000000/60000/53600/53541/02dd6cbf.jpg",
"description": "A modern interior with a curved green sofa, a round coffee table, and various potted plants."
}
]
},
{
"position": 3,
"property_id": "90248595",
"title": "Kopster Hotel Paris Porte de Versailles",
"link": "https://www.expedia.com/Paris-Hotels-Kopster-Hotel-Porte-De-Versailles.h90248595.Hotel-Information",
"extracted_hotel_class": 4,
"location": "Paris",
"gps_coordinates": {
"latitude": 48.836655,
"longitude": 2.276706
},
"rating": 9.0,
"max_rating": 10,
"rating_word": "Wonderful",
"reviews": 260,
"badges": [
"$83 off"
],
"amenities": [
"Bar and lounge",
"Veggie options",
"Water park for a fee"
],
"price_per_night": {
"price": "$142",
"extracted_price": 142
},
"total_price": {
"price": "$525",
"extracted_price": 525,
"original_price": "$607",
"extracted_original_price": 607
},
"is_free_cancellation": true,
"is_vip_access": false,
"images": [
{
"thumbnail": "https://images.trvl-media.com/lodging/91000000/90250000/90248600/90248595/f0145579.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/91000000/90250000/90248600/90248595/f0145579.jpg",
"description": "The exterior of the Kopster hotel with a prominent neon sign, outdoor seating area, and large windows."
},
{
"thumbnail": "https://images.trvl-media.com/lodging/91000000/90250000/90248600/90248595/e16a01af.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455",
"original": "https://images.trvl-media.com/lodging/91000000/90250000/90248600/90248595/e16a01af.jpg",
"description": "A modern living room with a hanging chair, a sofa, a television, and a bookshelf."
}
]
}
],
"pagination": {
"current": 1,
"total_pages": 8,
"next": 2
}
}