Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Fantasize cruise finder Get Cruise API
version: 1.0.0
description: Every sailing of 23 cruise lines, priced every night, with whether each fare is low, typical or high against its own usual price, and a link to book it. Free, no key. Also an MCP server at https://fantasize.net/mcp.
servers:
- url: https://fantasize.net
tags:
- name: Get Cruise
paths:
/api/v1/get_cruise:
get:
operationId: get_cruise
summary: One sailing in full
description: 'Everything about one sailing: day-by-day itinerary, current price of each cabin grade with the date it was read (and which have no price listed),each grade against its usual price, the fare''s own price history, the same itinerary on other dates with prices, the best thing to do at each port (verified seller and price where we have one, and its booking page), and book_url.'
parameters:
- name: sailing_id
in: query
required: false
description: A Fantasize sailing id, as returned in search results
schema:
type: string
- name: url
in: query
required: false
description: Or a fantasize.net /cruise/ link, or a Cruisebound sailing link
schema:
type: string
- name: cabin
in: query
required: false
description: Cabin grade to price. Omit to quote balcony where sold, else the next grade.
schema:
type: string
enum:
- inside
- oceanview
- balcony
- suite
responses:
'200':
description: JSON answer; every result carries book_url
'400':
description: A value we could not read; the message says which
'429':
description: Rate limited
tags:
- Get Cruise