Find and rank cruises with today's prices

Accepts the request in plain words (q) or as fields. Searches every sailing Fantasize tracks (23 cruise lines, ~30,000 sailings, priced every night) by region, dates, departure port, ports visited, line, length, cabin and budget. Returns up to 25 sailings with the price per person (taxes and port fees in), per night and for a cabin of two, every cabin grade's price, whether the fare is low, typical or high against that sailing's usual price, the ports of call, and book_url - a link the person opens to book that exact sailing. Default ranking is best_value (furthest below its usual price).

get/api/v1/search_cruises

Request

  • Base URL: https://fantasize.net
  • URL: https://fantasize.net/api/v1/search_cruises
  • Auth: none declared

Query parameters

qstring

The person's request in plain words, e.g. "alaska in july from seattle, balcony, under $3000 for two". Read by fixed rules; the answer says how it was understood and which words were not. Any other argument given overrides what q says.

regionstring

Where the cruise goes: a region (caribbean, bahamas, alaska, mexico, mediterranean, northern-europe, european-rivers, asia, repositioning, more) or a named place it calls at (greek-islands, norwegian-fjords, canada-new-england, canary-islands, british-isles, baltic, iceland, adriatic, japan, hawaii, panama-canal, bermuda, galapagos, tahiti, arctic, antarctica, danube, rhine, douro), or any port, island, country or state we sail to ("Santorini", "Maui", "Greece", "Juneau"). cruise_options lists the regions and named places with counts.

monthstring

Departure month, YYYY-MM

depart_fromstring

Earliest departure date, YYYY-MM-DD

depart_tostring

Latest departure date, YYYY-MM-DD

from_portstring

Departure port, e.g. "Seattle" or "Barcelona"; several comma-separated: "Miami,Fort Lauderdale"

calls_atstring

A port the ship must visit, e.g. "Juneau", "Santorini", "Cozumel"

linestring

Cruise line, e.g. "Royal Caribbean", "NCL", "Princess", "Viking"

shipstring

Ship name or part of it

tier'contemporary' | 'premium' | 'luxury' | 'ultra-luxury' | 'river'

luxury includes ultra-luxury; ultra-luxury is the top of the market only: Regent, Silversea, Seabourn, Explora Journeys (all-suite, all-inclusive)

nights_mininteger
nights_maxinteger
cabin'inside' | 'oceanview' | 'balcony' | 'suite'

Cabin grade to price. Omit to quote balcony where sold, else the next grade.

max_price_per_personnumber

Budget per person for the whole cruise, USD

max_price_per_nightnumber

Budget per person per night, USD

only_below_usualboolean

Only fares measurably below their usual price

sort'best_value' | 'lowest_price' | 'lowest_per_night' | 'soonest'
limitinteger

Response

JSON answer; every result carries book_url

Changes

No recorded changes to this operation across all 1 revision of this API.