Get live hotel offers
Live, bookable offers for up to 15 hotels and one stay.
Every room in stay.rooms must have the same party: for different parties, call once per party. Each offer has the room, the meals included, price.total in USD for the whole stay and every room (what is charged), fees payable at the property, the cancellation terms with times in UTC and the hotel's time zone, the confirmation mode, and an offerId for book_hotel that expires at expiresAt. Hotels with nothing to offer are listed under unavailable with the reason. Up to limitPerHotel offers per hotel, default 10, chosen for a spread of choices in this order while room remains: the cheapest offer, the cheapest that can be cancelled free, the cheapest with breakfast, the cheapest of each other room, then the rest by price; listed cheapest first.
get_hotel_offers · Read-only · CLI: fortrip hotels offers
Input
hotelIdsstring[]requiredHotels to price, 1 to 15, no repeats.1–15 items · each matches ^htl_[0-9A-Za-z]{20}$
stayobjectrequiredDates and party. One party per call: every room must be the same.
stay.checkInstringrequiredCheck-in date in the hotel's calendar, yyyy-MM-dd.
stay.checkOutstringrequiredCheck-out date in the hotel's calendar, yyyy-MM-dd. Stays are 1 to 15 nights; a longer one answers stay_unsupported (max_nights), and past 30 nights invalid_request: ask the user whether to split it into consecutive stays.
stay.roomsobject[]requiredThe rooms wanted, 1 to 8, each with its party; offers and orders need every room the same.1–8 items
stay.rooms[].adultsintegerrequiredAdults in this room.1–8
stay.rooms[].childrenAgesinteger[]requiredAge of each child in this room, 0 to 17. An empty list means no children.≤ 4 items · each 0–17
filtersobjectFilters every offer must pass.
filters.requireBreakfastbooleanKeep only offers that include breakfast.
filters.requireFreeCancellationbooleanKeep only offers that can still be cancelled free of charge.
limitPerHotelintegerOffers per hotel, 1 to 20. Default 10.1–20 · default 10
locale"en" | "zh"Language for names and text in the response: en or zh.
displayCurrency"USD" | "CNY"Currency to show prices in, USD or CNY. It never changes what is charged: payment is in USD.
Output
structuredContent is the Offers result object. content[0] is the answer as compact text, and content[1] is the presentation hint: how to show hotels to the user. Errors are described in the overview.