search_cruises
Find cruises
Find cruise recommendations and deals on CruiseHops across Carnival and Royal Caribbean by destination, departure port, dates, cabin and budget. Returns sailing links for further exploration on CruiseHops. Research only; no widget. Default three choices. Do not add cabin or budget constraints the user did not give. Search captured cruise sailings using typed filters. Prices are USD cents per person for two guests, not live or family quotes. Filter before grouping and choosing lowest cabin price. Use term IDs from suggest_cruise_terms for precise names.
ParametersqpageshipsortviewtermsdateTosourceamenitydateFrompageSizereturnBy+13 more
suggest_cruise_terms
Find ships and destinations
Suggest matching ship, port, destination and cruise line names, including suffix words. Returns stable term IDs for search filters.
ParametersqrequiredpageshipsortviewlimittermscursordateTosourceamenitydateFrom+15 more
list_departures
Explore departure dates
List bounded, paginated unique dated sailings for a public ship-itinerary group ID. Preserves cabin/date filters; older event-specific group IDs remain supported.
ParametersqpageshipsortviewtermsdateTosourceamenitygroupIdrequireddateFrompageSize+14 more
get_sailing
Explore a sailing
Explore a CruiseHops sailing page: itinerary, cabin fares, price-history context and links to the website and fare provider. Research only; no widget. Read sailing itinerary, cabin-filtered offers and booking URLs. Amenities and media are omitted by default; request them explicitly only when needed. No live availability or party total is guaranteed.
ParametersofferIdsailingIdrequiredcabinClassincludeMediaeventSelectorincludeAmenities
get_cabin_price_history
View cabin headline history
Read lowest returned cabin prices across promotions. Use headlinePriceHistory[].id from get_sailing as seriesKey. Fare and category changes are explicit; missing observations do not establish unavailability.
ParametersdateTodateFrommaxPointssailingIdrequiredseriesKeyrequired
get_price_history
View cabin price history
Read one exact captured offer context's price history. contextKey is required from get_sailing offers. Never blends cabins, fares, markets, guest counts or events. Dates select overlapping captured observation spans; maxPoints retains the latest points.
ParametersdateTodateFrommaxPointssailingIdrequiredcontextKeyrequired
present_cruises
Your CruiseHops shortlist
Present the final shortlist of one to three selected sailings in ONE interactive widget. Call once after research, preserving exact offer IDs, cabin classes and event selectors. Research tools do not render widgets. Do not repeat all widget details in prose.
Parameterssailingsrequired
compare_sailings
Compare cruises
Compare two to four distinct sailings and optional exact offer IDs. Defaults to lowest current captured two-adult offer; occupancy is explicit per offer. No live or family quote.
Parameterssailingsrequired
present_excursions
Explore port experiences
Open ONE interactive port-experience browser when the user wants excursions, tours or activities. Omit portId to let the user choose a port without calling Viator. Supply a supported local portId and optional visit date and activity keywords q to show matching experiences. This makes a fresh on-demand search; use the returned data as the current result. Preserve requested filters. Do not fetch details for every result. Users can change ports, dates, keywords and pages, inspect one selected experience and open Viator booking links. Suggestions are not verified to fit time ashore; no live availability. Use only on an experience request, never automatically for every cruise search.
ParametersqdatepageportId
list_excursion_ports
Explore excursion ports
List local cruise ports and whether excursion searches are supported. No Viator product request. Use the returned port ID for find_port_excursions.
Takes no parameters.
find_port_excursions
Find port excursions
Search Viator on demand only when the user asks for activities or excursions. Use a port ID from list_excursion_ports or get_sailing itinerary.portId. Pass the port visit date, not the cruise departure date. Optional q searches activity keywords such as snorkeling or food tours within that port; preserve it across pagination. Returns suggestions near the port, NOT verified time-ashore matches or live availability. Prices are indicative, may differ for the date/party, and are not cruise fares. Preserve complete affiliate URLs. No reviews or protected unique content. No widget.
ParametersqdatepageportIdrequired
get_excursion
Explore an excursion
Fetch details only for a Viator product the user selected from find_port_excursions. Returns allowed product content and an affiliate booking URL; no reviews, protected content or live availability. Verify meeting point, return timing and availability on Viator.
ParametersproductCoderequired