# Expedia API: Search hotels > Finds Expedia hotels in a destination for given dates, with public USD prices, reviews, property class, refund status and links. Nightly prices are per room; totals include all requested rooms, taxes and fees. Unofficial. Not affiliated with or endorsed by Expedia. - Page: https://fous.com/methods/expedia.com/search-hotels - Method: `expedia.com/search_hotels`, version 1 - Website: expedia.com - Returns: name, star rating, guest rating, reviews, neighbourhood, nightly and total price, refundability, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | `"guest_rating"` | Order results, for example price_low_to_high. One of "recommended", "price_low_to_high", "guest_rating". Default "recommended". | | `rooms` | integer | no | | Number of rooms, for example 1. Default 1. | | `adults` | integer | no | | Adults traveling, for example 2. Default 2. | | `check_in` | string | yes | `"2026-11-12"` | Arrival date (YYYY-MM-DD), for example 2026-11-12. | | `check_out` | string | yes | `"2026-11-15"` | Departure date (YYYY-MM-DD), for example 2026-11-15. | | `destination` | string | yes | `"Orlando"` | City or area to search, for example Orlando. | | `max_results` | integer | no | `25` | Maximum hotels to return, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "sort": "guest_rating", "check_in": "2026-11-12", "check_out": "2026-11-15", "destination": "Orlando", "max_results": 25 } ``` Its output: ```json { "hotels": [ { "name": "The Village, Homes by Villatel", "currency": "USD", "star_rating": null, "total_price": 1898, "expedia_link": "https://www.expedia.com/Orlando-Hotels-Villatel-Village-At-Solterra-Resort.h91027365.Hotel-Information?chkin=2026-11-12&chkout=2026-11-15&x_pwa=1&rfrr=HSR&pwa_ts=1790684768846&referrerUrl=aHR0cHM6Ly93d3cuZXhwZWRpYS5jb20vSG90ZWwtU2VhcmNo&useRewards=false&rm1=a2®ionId=6139113&destination=Orlando%2C…", "guest_rating": 10, "review_count": 7, "neighbourhood": "Solterra Resort", "nightly_price": 316, "fully_refundable": false, "guest_rating_label": "Exceptional", "expedia_property_id": "91027365" }, { "name": "Lake Nona Wave Hotel", "currency": "USD", "star_rating": 4, "total_price": 933, "expedia_link": "https://www.expedia.com/Orlando-Hotels-Lake-Nona-Wave-Hotel.h71681962.Hotel-Information?chkin=2026-11-12&chkout=2026-11-15&x_pwa=1&rfrr=HSR&pwa_ts=1790684768808&referrerUrl=aHR0cHM6Ly93d3cuZXhwZWRpYS5jb20vSG90ZWwtU2VhcmNo&useRewards=false&rm1=a2®ionId=6139113&destination=Orlando%2C+FL%2C+United+S…", "guest_rating": 9.8, "review_count": 1371, "neighbourhood": "Orlando", "nightly_price": 274, "fully_refundable": false, "guest_rating_label": "Exceptional", "expedia_property_id": "71681962" }, { "name": "Comfort Inn & Suites Orlando Sanford Airport", "currency": "USD", "star_rating": 2.5, "total_price": 542, "expedia_link": "https://www.expedia.com/Sanford-Hotels-Comfort-Inn-Suites-Orlando-Sanford-Airport.h122062640.Hotel-Information?chkin=2026-11-12&chkout=2026-11-15&x_pwa=1&rfrr=HSR&pwa_ts=1790684768812&referrerUrl=aHR0cHM6Ly93d3cuZXhwZWRpYS5jb20vSG90ZWwtU2VhcmNo&useRewards=false&rm1=a2®ionId=6139113&destination=Or…", "guest_rating": 9.8, "review_count": 208, "neighbourhood": "Sanford", "nightly_price": 160, "fully_refundable": false, "guest_rating_label": "Exceptional", "expedia_property_id": "122062640" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"expedia.com/search_hotels","input":{"sort":"guest_rating","check_in":"2026-11-12","check_out":"2026-11-15","destination":"Orlando","max_results":25}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find me hotels in Lisbon from 2026-09-03 to 2026-09-07 for 2 adults, cheapest first, with nightly and total prices and whether they're refundable. - On Expedia, what are the best-rated hotels in Kyoto for March 20–24, 2026? Just one adult, show me the top 10 by guest rating. - Need 3 rooms for 6 adults in Nashville, checking in Oct 9 2026 and out Oct 11 2026. List options with star class, neighbourhood and the full cost including taxes. - Pull up to 40 Expedia hotel listings for Cancun, Dec 27 2026 through Jan 2 2027, two adults, sorted by recommended, with review counts and booking links. - Looking for a budget place to stay in Chicago for 1 adult, 2026-05-14 to 2026-05-16 — lowest price first, and flag which ones have free cancellation. ## Input schema ```json { "type": "object", "required": [ "destination", "check_in", "check_out" ], "properties": { "sort": { "enum": [ "recommended", "price_low_to_high", "guest_rating" ], "type": "string", "default": "recommended", "description": "Order results, for example price_low_to_high." }, "rooms": { "type": "integer", "default": 1, "maximum": 8, "minimum": 1, "description": "Number of rooms, for example 1." }, "adults": { "type": "integer", "default": 2, "maximum": 10, "minimum": 1, "description": "Adults traveling, for example 2." }, "check_in": { "type": "string", "description": "Arrival date (YYYY-MM-DD), for example 2026-11-12." }, "check_out": { "type": "string", "description": "Departure date (YYYY-MM-DD), for example 2026-11-15." }, "destination": { "type": "string", "description": "City or area to search, for example Orlando." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum hotels to return, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "hotels" ], "properties": { "hotels": { "type": "array", "items": { "type": "object", "required": [ "name", "star_rating", "guest_rating", "guest_rating_label", "review_count", "neighbourhood", "nightly_price", "total_price", "currency", "fully_refundable", "expedia_link", "expedia_property_id" ], "properties": { "name": { "type": "string" }, "currency": { "enum": [ "USD" ], "type": "string" }, "star_rating": { "type": [ "number", "null" ] }, "total_price": { "type": [ "number", "null" ] }, "expedia_link": { "type": "string" }, "guest_rating": { "type": [ "number", "null" ] }, "review_count": { "type": [ "integer", "null" ] }, "neighbourhood": { "type": [ "string", "null" ] }, "nightly_price": { "type": [ "number", "null" ] }, "fully_refundable": { "type": "boolean" }, "guest_rating_label": { "type": [ "string", "null" ] }, "expedia_property_id": { "type": [ "string", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Expedia API: Search flights](https://fous.com/methods/expedia.com/search-flights.md): Finds Expedia flights between cities or airports on selected dates, with per-traveler USD prices. Round trips combine outbound and return choices; for round trips only the cheapest outbound choices are paired with their returns. - [Priceline API: Search hotels](https://fous.com/methods/priceline.com/search-hotels.md): Find publicly priced Priceline hotels in a place for your travel dates, with guest ratings, nightly and total USD prices, and cancellation information. Excludes hotels hidden behind anonymous deals and sign-in-only prices. - [Kayak API: Search hotels](https://fous.com/methods/kayak.com/search-hotels.md): Compares Kayak hotel nightly rates across booking sites for a city or neighborhood and stay dates (two adults, one room). - [Trip.com API: Search hotels](https://fous.com/methods/trip.com/search-hotels.md): Finds hotels in a city on Trip.com for given dates, with prices, guest ratings, reviews and booking links. Only the initial public listing is read, so large limits may return fewer hotels. - [Agoda API: Search hotels](https://fous.com/methods/agoda.com/search-hotels.md): Finds available Agoda stays in a city for your dates, with prices before taxes and fees, star and guest ratings, and free-cancellation status. - [Google API: Search Google Hotels](https://fous.com/methods/google.com/search-hotels.md): Finds places to stay in a city or area for given dates on Google Hotels, with nightly and total prices, hotel class, guest ratings, amenities, address and cheapest booking site. Optional filters for price, stars and rating; vacation rentals are left out. Prices and availability can change. - [Booking.com API: Search stays](https://fous.com/methods/booking.com/search-stays.md): Searches Booking.com stays by destination and dates, with guest counts, price, review, cancellation, sorting and paging. Displayed prices generally exclude some taxes and fees; children are searched as age 8. - [Agoda API: Get room prices](https://fous.com/methods/agoda.com/get-room-prices.md): Finds room offers and nightly prices for one Agoda hotel on selected dates. Totals are calculated from displayed nightly prices before taxes and fees; final checkout totals may differ. - [All Expedia methods](https://fous.com/methods/expedia.com.md)