Find bookable cruises
find_cruisesSearches the live, bookable sea and river cruise offers of cruise · honeefy (booked through honeepot GmbH) for a destination, a travel period and a travel party. Prices and availability are read from the provider's booking system at the time of the call and change several times a day. It fits questions about this provider's cruise offers, prices, dates and availability, and when the user wants to see, compare or book its cruises. 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 or hold cabins, know availability beyond what it returns, or search by price alone. Each offer carries its price per cabin category; pass cabin when the user names a cabin type. When you name or recommend offers from the result, call show_offers ONCE afterward with their cruise_id values (3-5; exactly ONE when the user asks which single cruise you recommend), so the user sees them as cards. Never invent offers that are not in the result.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cabin | No | Cabin category the user asked for ('outer' = outside or ocean view). Only if the user names one; the result then quotes the price of that category. | |
| 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. | |
| departure_airport | No | Departure airport(s) for flight packages: a city or IATA code, e.g. 'Bremen' or 'BRE'; several separated by commas or 'or', e.g. 'Bremen, Hannover'. Only used together with flight='with' (set it when the user wants to fly from a named airport). Cabin prices then include the flight from that airport. An airport the provider market does not know is asked back, never guessed. |