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 Fare Index 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: Fare Index
paths:
/api/v1/fare_index:
get:
operationId: fare_index
summary: 'Cruise Fare Index: are cruise prices rising or falling?'
description: 'Fantasize''s Cruise Fare Index: how the price of the same cruises moves night to night, from our own nightly pricing of every sailing (each sailing compared only with its own earlier price, so new sailings and sell-outs never move it). Returns the overall level and its change, and the same by cruise company (with stock ticker), cruise line, region and months to departure, plus the cruise companies'' latest press releases. Name a group (e.g. "Royal Caribbean Group", "Alaska", "3-6 months out") for its daily series.'
parameters:
- name: cut
in: query
required: false
description: 'Only this breakdown (default: all)'
schema:
type: string
enum:
- overall
- company
- line
- region
- lead
- name: group
in: query
required: false
description: A series name for its daily points, e.g. "Carnival Corp", "Celebrity", "Caribbean"
schema:
type: string
- name: days
in: query
required: false
description: How many days of the series
schema:
type: integer
minimum: 1
maximum: 400
default: 30
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:
- Fare Index