Find bookable cruises
find_cruisesSearches the provider's LIVE, bookable sea and river cruise offers for a destination, a travel period and a travel party. Use it whenever the user asks about cruise offers, prices, dates or availability, wants to see, compare or book cruises: prices and availability change several times a day and this tool has the live availability for the traveller's party. Requires adults, period (or from_date/to_date) and destination — if any is missing, unusable or not a region this provider can search, the result lists a question for it and no search runs; ask the user, then call again with the same handle. For river cruises pass cruise_type='river' (a river name such as 'Danube' is recognised too). Sea cruises are shown WITHOUT a flight package by default; pass flight='with' to get the flight packages instead. Returns a summary plus up to 10 offers with cruise_id, ship, cruise line, dates, nights, price with currency (per person; for families the cabin total for the whole party where the provider computes it) and the booking link. Where the provider supports it, availability is checked LIVE for the top offers and each says whether it is confirmed; sold-out ones are removed. The list is a SAMPLE of the provider's matches: the result says how many exist and which cruise lines have sailings -- never conclude that a line is not offered because it is not listed; pass cruise_line to look for it. It does NOT show anything to the user, book, hold or price cabins, know availability beyond what it returns, or search by price alone. If you are recommending cruises, call show_offers ONCE afterward with the cruise_id values of your recommendation (3-5). Never invent offers that are not in the result.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many offers to return as data (3-10, default 10). The result also carries `total` and `links.all` (every match on the provider's search page). | |
| ports | No | Ports, islands or countries that must ALL be on the route (start, a stop or the end), e.g. ['Barbados', 'St. Lucia'] or the port cities ['Bridgetown', 'Castries'] -- an island/country entry matches any of its ports on the route. Names are matched in English; a translated name may find nothing, try the English or the specific port city instead. | |
| adults | No | Number of adults travelling. | |
| flight | No | 'without' (default): cruise only. 'with': the provider's flight packages. | |
| handle | No | Consultation handle returned by a previous call (structuredContent.handle). Pass it on every call so wishes are remembered; omit it on the very first call. | |
| period | No | Travel period as free text, e.g. 'summer 2027', 'October 2027', '2027-06-01 to 2027-06-30'. | |
| to_date | No | Latest departure, ISO date. Alternative to period. | |
| language | No | Language of the answer. Defaults to the provider's language. | |
| from_date | No | Earliest departure, ISO date. Alternative to period. | |
| nights_max | No | Maximum nights. Only if the user names a trip length; below 4 nights asks for short cruises first. | |
| nights_min | No | Minimum nights. Only if the user names a trip length. | |
| cruise_line | No | Cruise line(s) by name, e.g. 'MSC' or 'MSC, AIDA' (comma-separated). The search is filtered AT THE PROVIDER, so use it to look for a line the default list does not show. | |
| cruise_type | No | 'ocean': sea cruises. 'river': river cruises (Danube, Rhine, Moselle, Nile, ...). Omit it to derive it from the destination. | |
| destination | No | Region, country, sea or river in any language, e.g. 'Mediterranean', 'Norwegian fjords', 'Caribbean', 'Danube'. For a river cruise on any river pass 'river cruise'. | |
| children_ages | No | Age of each child at travel time. A child without an age is not searched for. | |
| departure_port | No | A single port that must be on the route (start, stop or end), e.g. 'Barcelona'. For several required ports use `ports` instead. |