---
title: "Find and rank cruises with today's prices"
method: GET
path: "/api/v1/search_cruises"
---

# Find and rank cruises with today's prices

`GET /api/v1/search_cruises`

## Request

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

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).

## Query parameters

- `q` string
- `region` string
- `month` string
- `depart_from` string
- `depart_to` string
- `from_port` string
- `calls_at` string
- `line` string
- `ship` string
- `tier` 'contemporary' | 'premium' | 'luxury' | 'ultra-luxury' | 'river'
- `nights_min` integer
- `nights_max` integer
- `cabin` 'inside' | 'oceanview' | 'balcony' | 'suite'
- `max_price_per_person` number
- `max_price_per_night` number
- `only_below_usual` boolean
- `sort` 'best_value' | 'lowest_price' | 'lowest_per_night' | 'soonest'
- `limit` integer

## Response `200`

JSON answer; every result carries book_url

## Other responses

- `400`: A value we could not read; the message says which
- `429`: Rate limited

---

[API](https://skmtc.dev/fantasize/apis/fantasize-cruise-finder.md) · [All operations](https://skmtc.dev/fantasize/apis/fantasize-cruise-finder/llms.txt) · [OpenAPI document](https://skmtc.dev/fantasize/apis/fantasize-cruise-finder/revisions/5702477b4f69?raw)