Accor best offer tool
get_best_hotel_ratesFull Description
Retrieves best available rates for Accor hotels within a geographical area.
WHEN TO USE
Use this tool when users searching/looking for hotels. Call the tool every time the user wants to filter out (price/date/stars/offer type (price rating)) or refine hotel search.
OUTPUT
Presents a map with a list of hotels to the user.
Parameters
checkInstringCheck-in date in the format yyyy-MM-dd (UTC). IMPORTANT: send {Current day + 7} by default
checkOutstringCheck-out date in the format yyyy-MM-dd (UTC). IMPORTANT: ONLY Send {Check-in date + 1} IF NOT SPECIFIED BY USER
countryMarketstringUser's country of residence in ISO 3166-1 alpha-2 format (e.g., 'FR', 'US', 'CA', 'DE', 'GB'). IMPORTANT: If not known, send FR
currencystringUser currency for pricing (e.g., 'EUR', 'USD'). IMPORTANT: If not known, send EUR
destinationarrayBounding box coordinates in WGS84 format [min_lon, min_lat, max_lon, max_lat]. max_lon has to be strictly superior to min_lon. max_lat has to be strictly superior to min_lat. Example for Paris city center: [2.224122, 48.815575, 2.469760, 48.902156]. Allow only coordinates at the level of city districts, cities, or regions within a country (e.g., Alsace, Massachusetts), and reject any broader coordinates such as countries or world regions.
locationstringThe user's destination city and country (e.g., Paris, France)
maxStarsintegerMaximum number of stars for hotels to display, send 5 by default
minStarsintegerMinimum number of stars for hotels to display, send 0 by default
offerTypestringIMPORTANT: Send 'PUBLIC' by default. Determines which rates to fetch: 'PUBLIC' shows publicly available rates, 'MEMBER' restricts to ALL member-only offers
PUBLICMEMBERuserLanguagestringMandatory: SEND known User discussion language code in ISO 639-1 format (2 characters: 'en', 'fr', 'es', 'de', 'it', 'ja', etc.). Special case: use 'pt-br' for Brazilian Portuguese.
adultsCountintegerNumber of adults staying (defaults to 1). IMPORTANT: X People/Person DOES NOT MEAN X Adults. Please check with user
1brandsarrayFilter by hotel brands (brand codes). Generic codes auto-expand to related specialized brands (e.g., NOV -> SUI, NOL; IBH -> IBB, IBS; MER -> BME, MEI, MEL; SOF -> SOL, SO; ADG -> ADA, ADP; SWI -> SWL; MOV -> MOL).
childrenAgesarrayList of children’s ages. This field contains the list of children’s ages and must only include ages explicitly provided by the user. The assistant must never infer or assume ages. If the user mentions having children but does not specify each child’s age, the assistant must ask for the missing ages before calling the tool. If no children are mentioned, this field must be an empty array. Each child must have exactly one integer age between 0 and 17
[]maxStayPriceintegerFilter hotels by MAXIMUM price PER STAY (not night) of hotels to display. If the price is "around X" make it deviation of 25% more
minStayPriceintegerFilter hotels by MINIMUM price PER STAY (not night) of hotels to display. If the price is "around X" make it deviation of 25% less
pageintegerPage number for pagination (defaults to 0)
userExperiencesstringNatural language description of desired hotel characteristics and amenities (e.g., "with spa", "rooftop pool", "city view", "near attractions"). MUST be in English only. DO NOT include booking details like dates, guest counts, or location/destination information - these are specified in separate parameters. Focus only on property features, amenities, atmosphere, or nearby points of interest. Examples: romantic hotel with spa, family-friendly near beach, business hotel with conference rooms,...