Hotel Search Tool
hotel_searchFull Description
Use ONLY when the user is finding or comparing hotels (new lodging) for a destination and dates. Put the user's wording in inputQuery; convert relative dates (e.g. 'next weekend') to YYYY-MM-DD. When you can infer optional filters or stay fields, set them per the tool input schema. If dates are missing, default check-in to today and stay length to 2 nights. Brands: only chains the user named—do not add sibling sub-brands unless they said them. Results show in the map widget (POIs when returned); users continue on Priceline from there. Preserve destination and dates on follow-up searches. Out of scope: existing reservations, changes or refunds, account or payment support, flights/cars/packages without new lodging, and generic policy Q&A. Not for checkout or one-property room boards (use hotel_prepare_checkout, hotel_detail, hotel_room_options). If error is set or hotels is empty, say the search failed and offer to adjust destination, dates, filters, or occupancy. When summarizing, never show hotel IDs, hotelDetailsURL, thumbnailUrl, or lat/lng—names only; point users to the widget for detail or checkout.
Parameters (3 required, 26 optional)
checkInstringCheck-in date (YYYY-MM-DD). Must be today or later; omit to default to today.
checkOutstringCheck-out date (YYYY-MM-DD). Must be after check-in and today or later; omit to default relative to check-in.
inputQuerystringThe natural language query to search for hotels. Generate this from user's current query and conversation history. Include all necessary information if provided such as: city, check-in date, check-out date, number of rooms, number of adults as well as any additional preferences.
adultsintegerNumber of adults to accommodate in those rooms.
2allInclusivebooleanTrue when the user wants an all-inclusive property (meals/rates included at the hotel).
amenityCodesarrayOptional amenity filter codes: HANDFAC, FPRKING, FINTRNT, SPOOL, PETALLOW, RESTRNT, FBRKFST, FITSPA, HOTTUB, SPA, BUSCNTR, SPOOLOUT, KITCHEN, BCHFRNT, CASINO, FAIRSHUTTL, AIRSHUTTL, ADULTONLY, INCLUSIVE.
bedCountsstringBed needs for the stay. One number (e.g. "2") or comma-separated options (e.g. "3,4").
brandsarrayHotel brand names to filter by. Each value must exactly match a known brand display name (e.g. "Hilton", "Hyatt", "Courtyard by Marriott") — pass only chains the user named, not sibling sub-brands. An unrecognized value returns no results with an explanatory error rather than failing the call.
childOccstringComma-separated child occupancy segments as count-age (e.g. "1-10,1-2" for one child age 10 and one age 2; use age 0 for infants).
cityNamestringCity for the stay when known (e.g. "New York", "Los Angeles").
countryNamestringCountry code for the destination (e.g. "US", "CA", "UK").
UShotelNamestringProperty or chain name when the user is searching for one hotel.
hotelThemestringHotel theme or environment. Supported values: FAMILY, LUXURY, COMFORT, BUSINESS, SPA. Only one theme per search.
FAMILYLUXURYCOMFORTBUSINESSSPAisExpressDealbooleanTrue to restrict results to Express Deal (opaque-rate) listings only.
isFreeCancellationHotelbooleanTrue when the user wants free cancellation.
isFullyRefundableHotelbooleanTrue when the user wants fully refundable rates.
isSearchingResortbooleanTrue when the user is looking for a resort stay.
maxPricenumber/stringMaximum price per night for the hotel (budget upper bound).
minGuestRatingstringMinimum guest rating filter when applicable; typically a value from 1 to 9.
minPricenumber/stringMinimum price per night for the hotel (budget lower bound).
needCheapestHotelbooleanTrue when the user wants cheapest or price-sorted results.
needPayLaterRateHotelbooleanTrue when the user wants pay-at-hotel or pay-later rates.
neighborhoodsNamesstringComma-separated neighborhood, area, landmark, or street hints within the city (e.g. "airport,soho").
propertyTypesarrayProperty types to include. Supported values: Apartments, Hostels, Hotels, Motels, Resorts, Residence, Farm stays, Holiday parks, Bungalows, Villas, Campsites, Boat/cruises, Inns, Aparthotels, Holiday homes, Lodges, Homestays, Tents, Capsule hotels, Love hotels, Traditional stays, Guesthouses, Student accommodations. Prefer this over isSearchingResort for resort-only searches.
roomsintegerNumber of rooms to accommodate.
1shouldSortByProximitybooleanTrue when the user wants results sorted by distance to a landmark or area. Use with neighborhoodsNames (e.g. "Times Square", "airport").
shouldSortByReviewScorebooleanTrue when the user wants results sorted by guest rating or review score.
starRatingsstringComma-separated star levels to include, e.g. 3,4,5 or 3,3.5,4,4.5,5.
statestringUS state as two-letter abbreviation when applicable (e.g. "NY", "CA").