# Priceline API: Search hotels > 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. Unofficial. Not affiliated with or endorsed by Priceline. - Page: https://fous.com/methods/priceline.com/search-hotels - Method: `priceline.com/search_hotels`, version 1 - Website: priceline.com - Returns: hotel name, stars, guest rating, reviews, neighbourhood, nightly and total price, cancellation, 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 - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | `"price_low_to_high"` | Order of 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 | | Number of adult guests, for example 2. Default 2. | | `check_in` | string | yes | `"2026-11-10"` | Arrival date (YYYY-MM-DD), for example 2026-10-20. | | `location` | string | yes | `"New York"` | Place to stay, for example Las Vegas. | | `check_out` | string | yes | `"2026-11-12"` | Departure date (YYYY-MM-DD), for example 2026-10-22. | | `min_stars` | integer | no | `4` | Minimum hotel star rating from 1 to 5, for example 4. Leave empty for any rating. | | `max_results` | integer | no | `35` | Maximum number of hotels, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "sort": "price_low_to_high", "check_in": "2026-11-10", "location": "New York", "check_out": "2026-11-12", "min_stars": 4, "max_results": 35 } ``` Its output: ```json { "hotels": [ { "name": "LIV Hotel Bronx GRAND OPENING", "stars": 4, "guest_rating": 7.3, "neighbourhood": "Bronx", "nightly_price": 161.1, "original_price": null, "priceline_link": "https://www.priceline.com/relax/at/600245880/from/20261110/to/20261112/rooms/1/adults/2", "free_cancellation": true, "number_of_reviews": 650, "priceline_hotel_id": "600245880", "total_including_taxes_and_fees": 376.72 }, { "name": "DoubleTree by Hilton Long Island City New York", "stars": 4, "guest_rating": 7, "neighbourhood": "Long Island City", "nightly_price": 163.19, "original_price": null, "priceline_link": "https://www.priceline.com/relax/at/229303104/from/20261110/to/20261112/rooms/1/adults/2", "free_cancellation": true, "number_of_reviews": 322, "priceline_hotel_id": "229303104", "total_including_taxes_and_fees": 381.56 }, { "name": "Wyndham Garden Brooklyn Sunset Park", "stars": 4, "guest_rating": 8, "neighbourhood": "Brooklyn South - Red Hook", "nightly_price": 175.95, "original_price": null, "priceline_link": "https://www.priceline.com/relax/at/42087304/from/20261110/to/20261112/rooms/1/adults/2", "free_cancellation": true, "number_of_reviews": 1014, "priceline_hotel_id": "42087304", "total_including_taxes_and_fees": 456.72 } ] } ``` ## 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":"priceline.com/search_hotels","input":{"sort":"price_low_to_high","check_in":"2026-11-10","location":"New York","check_out":"2026-11-12","min_stars":4,"max_results":35}}' ``` 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 Chicago from March 12 to March 15, 2026 for 2 adults, cheapest first, with nightly and total prices and whether they're refundable. - What 4-star or better hotels are on Priceline in Miami Beach for June 5–9, 2026? Sort by guest rating and show me the top 10. - Need 3 rooms for 6 adults in Nashville, checking in 2026-09-18 and out 2026-09-20. Show what's available and the cancellation policies. - Compare hotel prices on priceline.com for New Orleans, Feb 13 to Feb 17 2026, just me traveling solo, lowest price first, up to 30 results. - Which hotels in downtown Seattle have the best guest reviews for a couple staying Nov 3–6, 2026? Include neighborhood, star rating, and booking links. ## Input schema ```json { "type": "object", "required": [ "location", "check_in", "check_out" ], "properties": { "sort": { "enum": [ "recommended", "price_low_to_high", "guest_rating" ], "type": "string", "default": "recommended", "description": "Order of 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": 20, "minimum": 1, "description": "Number of adult guests, for example 2." }, "check_in": { "type": "string", "description": "Arrival date (YYYY-MM-DD), for example 2026-10-20." }, "location": { "type": "string", "description": "Place to stay, for example Las Vegas." }, "check_out": { "type": "string", "description": "Departure date (YYYY-MM-DD), for example 2026-10-22." }, "min_stars": { "type": "integer", "maximum": 5, "minimum": 1, "description": "Minimum hotel star rating from 1 to 5, for example 4. Leave empty for any rating." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of hotels, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "hotels" ], "properties": { "hotels": { "type": "array", "items": { "type": "object", "required": [ "name", "stars", "guest_rating", "number_of_reviews", "neighbourhood", "nightly_price", "total_including_taxes_and_fees", "original_price", "free_cancellation", "priceline_link", "priceline_hotel_id" ], "properties": { "name": { "type": "string", "description": "Hotel name." }, "stars": { "type": [ "number", "null" ], "description": "Hotel star rating." }, "guest_rating": { "type": [ "number", "null" ], "description": "Guest rating out of 10." }, "neighbourhood": { "type": [ "string", "null" ], "description": "Neighbourhood." }, "nightly_price": { "type": "number", "description": "Public nightly price in USD." }, "original_price": { "type": [ "number", "null" ], "description": "Original nightly price in USD when a discount is shown." }, "priceline_link": { "type": "string", "description": "Priceline hotel page for these dates." }, "free_cancellation": { "type": "boolean", "description": "Whether the listed rate advertises refundable cancellation." }, "number_of_reviews": { "type": [ "integer", "null" ], "description": "Number of guest reviews." }, "priceline_hotel_id": { "type": "string", "description": "Priceline hotel ID." }, "total_including_taxes_and_fees": { "type": "number", "description": "Total price including taxes and fees in USD." } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Priceline API: Search rental cars](https://fous.com/methods/priceline.com/search-rental-cars.md): Compares Priceline rental-car offers for a pick-up place and dates, cheapest first. Unpublished company, transmission or pick-up details are left blank; prices may change at checkout. - [Expedia API: Search hotels](https://fous.com/methods/expedia.com/search-hotels.md): 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. - [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 Priceline methods](https://fous.com/methods/priceline.com.md)