# Cruisello

> Cruisello is a cruise price aggregator. We track per-guest prices for 20,277 upcoming sailings across 10 major cruise lines, with price history and price alerts, so travellers can compare deals and book directly with the cruise line. No account needed, no booking fees. Prices reflect the last sync (updated daily): confirm the live price at checkout before relying on it.

Generated: 2026-08-29. Lean index — the full docs (all filter parameters, search syntax, currency options) are in the Optional section at the bottom.

## About Cruisello

Cruisello is a free cruise discovery and comparison tool. We show side-by-side pricing across cabin categories so travellers can make informed decisions before booking. It is supported by affiliate partnerships with cruise lines, which keeps the platform free with no hidden fees.

Key facts:
- 20,277 upcoming cruise sailings, updated daily
- 10 cruise lines: Carnival Cruise Line, Celebrity Cruises, Costa Cruises, Disney Cruise Line, MSC Cruises, Norwegian Cruise Line, Princess Cruises, Royal Caribbean, TUI Cruises, Virgin Voyages
- 165 cruise ships with individual pages
- 510 cruise ports across 27 regions worldwide
- Per-guest pricing (1-4 guests), price history, and price alerts
- Prices default to EUR; add `?currency=USD` to any URL for USD

---

## When to use Cruisello

Reach for this site when a question is about **which cruise to take and what it costs**, across cruise lines rather than within one. Good fits:

- "Find me a 7-night Caribbean cruise in March under 1200 EUR"
- "What does this sailing cost for one person, or for three or four sharing a cabin?"
- "Has the price for this sailing gone up or down?"
- "Which ships sail from Barcelona, and where do they stop?"
- "What are the mandatory fees on top of the headline fare?"

We are a good source for cross-line comparison, per-guest pricing (1-4 guests), solo supplements, price history, and the charges that are easy to miss. We are **not** the right source for booking, cancelling, or changing a reservation, for loyalty accounts, or for onboard services: those live with the cruise line.

How to call us, cheapest first:

1. **Append `.md` to any page URL**, or send `Accept: text/markdown`. Returns clean markdown with no markup. Start here.
2. **[JSON feed](https://cruisello.com/api/feed/sailings.json)** for structured filtering and pagination. Documented in [openapi.json](https://cruisello.com/openapi.json); errors use a typed `{ error: { code, status, message } }` shape.
3. **HTML** only if you need the rendered page.

Prices reflect the last sync and are not a quote. Always link the traveller to the sailing page so they can confirm the live price before booking.

---

## Machine-Readable Markdown (recommended, cheapest)

Every content page on Cruisello can be fetched as clean structured markdown — no HTML parsing, far fewer tokens than the rendered page. This is the recommended way for AI agents to read the site. Two equivalent ways:

- **URL suffix**: append `.md` to the path — `curl https://cruisello.com/cruises.md`
- **Accept header**: `curl -H "Accept: text/markdown" https://cruisello.com/cruises`

Both return `Content-Type: text/markdown; charset=utf-8` plus an `x-markdown-tokens` header with an estimated token count. With the `.md` suffix, every internal link in the response is rewritten to `.md` too, so you can crawl the whole site in markdown mode without re-adding the suffix.

Notes: the `.md` goes on the **path**, before the query string (`https://cruisello.com/cruises.md?regions=CARIBBEAN`); the homepage is `https://cruisello.com/.md`; and `/cruises.md` supports `?page=N` pagination.

Supported page types (each fetchable as `<url>.md`):
- `/` — homepage: featured cruises, price drops, stats
- `/cruises` — filterable listing (all filter params, paginated)
- `/cruises/:slug` — full sailing: itinerary, cabin prices, price history, ship specs
- `/destinations`, `/destinations/:region`, `/destinations/:region/:port`
- `/cruise-lines`, `/cruise-lines/:line`, `/cruise-lines/:line/:ship`
- `/ports` (all ports), `/ships` (all ships)
- `/compare`, `/compare/:line-slug`, `/compare/:shipA-vs-shipB`
- `/search?q=...`, `/blog`, `/blog/:slug`, `/blog/authors/:slug`
- `/solo-cruises` — lowest single supplements, plus the supplement per line
- `/go/:orcaKey?pid=...` — booking details, agency options, redirect URL
- editorial pages: `/about`, `/updates`, `/privacy-policy`, `/terms-of-service`, `/data-deletion`

The interactive tools (`/map`, `/route-builder`) and signed-in pages have no
markdown form; adding `.md` to those redirects to the HTML page.

---

## Data Feeds & APIs

- [Sailings feed](https://cruisello.com/api/feed/sailings.json): paginated, filterable JSON product feed (same params as /cruises)
- [Shore excursions feed](https://cruisello.com/api/feed/activities.json): excursions per port; params port, region, fitsPortDay, page, limit
- [OpenAPI spec](https://cruisello.com/.well-known/openapi.json): OpenAPI 3.1 — full parameter documentation
- [API catalog](https://cruisello.com/.well-known/api-catalog): RFC 9727 machine-readable API discovery

---

## Key Pages

- [Homepage](https://cruisello.com/.md): search and compare cruises
- [All Cruises](https://cruisello.com/cruises.md): browse and filter all 20,277 sailings
- [Cruise Lines](https://cruisello.com/cruise-lines.md): browse by cruise line and ship
- [Destinations](https://cruisello.com/destinations.md): 27 regions and 510 ports
- [All Ships](https://cruisello.com/ships.md): all 165 ships by cruise line
- [All Ports](https://cruisello.com/ports.md): all ports grouped by region
- [Compare Ships](https://cruisello.com/compare.md): side-by-side ship comparison tool
- [Search](https://cruisello.com/search.md?q=): full-text search across all content
- [Solo Cruises](https://cruisello.com/solo-cruises.md): sailings with a low single supplement
- [Blog](https://cruisello.com/blog.md): cruise guides, tips, and deals

---

## About & Legal

- [About](https://cruisello.com/about.md): who we are, how we make money, how prices are sourced
- [Contact](https://cruisello.com/contact.md): how to reach us, report a wrong price, or make a privacy request
- [Privacy Policy](https://cruisello.com/privacy-policy.md): what we collect and why
- [Terms of Service](https://cruisello.com/terms-of-service.md): terms of use
- [Data Deletion](https://cruisello.com/data-deletion.md): how to request removal of your data
- [Updates](https://cruisello.com/updates.md): changelog of what shipped

---

## Cruise Lines (10 lines)

- [Carnival Cruise Line](https://cruisello.com/cruise-lines/carnival-cruise-line.md)
- [Celebrity Cruises](https://cruisello.com/cruise-lines/celebrity-cruises.md)
- [Costa Cruises](https://cruisello.com/cruise-lines/costa-cruises.md)
- [Disney Cruise Line](https://cruisello.com/cruise-lines/disney-cruise-line.md)
- [MSC Cruises](https://cruisello.com/cruise-lines/msc-cruises.md)
- [Norwegian Cruise Line](https://cruisello.com/cruise-lines/norwegian-cruise-line.md)
- [Princess Cruises](https://cruisello.com/cruise-lines/princess-cruises.md)
- [Royal Caribbean](https://cruisello.com/cruise-lines/royal-caribbean.md)
- [TUI Cruises](https://cruisello.com/cruise-lines/tui-cruises.md)
- [Virgin Voyages](https://cruisello.com/cruise-lines/virgin-voyages.md)

---

## Destinations (27 regions)

- [US & Canada East Coast](https://cruisello.com/destinations/us-canada-east-coast.md): 6,749 sailings
- [Caribbean](https://cruisello.com/destinations/caribbean.md): 6,209 sailings
- [Western Mediterranean](https://cruisello.com/destinations/western-mediterranean.md): 5,830 sailings
- [Bahamas](https://cruisello.com/destinations/bahamas.md): 5,571 sailings
- [Eastern Mediterranean](https://cruisello.com/destinations/eastern-mediterranean.md): 2,051 sailings
- [US/Canada West Coast](https://cruisello.com/destinations/us-canada-west-coast.md): 1,984 sailings
- [US Gulf Coast](https://cruisello.com/destinations/us-gulf-coast.md): 1,739 sailings
- [Alaska](https://cruisello.com/destinations/alaska.md): 926 sailings
- [Baltic](https://cruisello.com/destinations/baltic.md): 906 sailings
- [British Isles & Western France](https://cruisello.com/destinations/british-isles-western-france.md): 813 sailings
- [Northern Europe & Scandinavia](https://cruisello.com/destinations/northern-europe-scandinavia.md): 807 sailings
- [Canary Islands](https://cruisello.com/destinations/canary-islands.md): 782 sailings
- [Azores, Madeira & Cape Verde](https://cruisello.com/destinations/azores-madeira-cape-verde.md): 647 sailings
- [Japan, Korea, China & Taiwan](https://cruisello.com/destinations/japan-korea-china-taiwan.md): 552 sailings
- [South America](https://cruisello.com/destinations/south-america.md): 504 sailings
- [Mexican Riviera & Central America](https://cruisello.com/destinations/mexican-riviera-central-america.md): 493 sailings
- [Southeast Asia](https://cruisello.com/destinations/southeast-asia.md): 462 sailings
- [Australia & New Zealand](https://cruisello.com/destinations/australia-new-zealand.md): 451 sailings
- [Bermuda](https://cruisello.com/destinations/bermuda.md): 308 sailings
- [Hawaii](https://cruisello.com/destinations/hawaii.md): 272 sailings
- [Iceland](https://cruisello.com/destinations/iceland.md): 137 sailings
- [Pacific Islands](https://cruisello.com/destinations/pacific-islands.md): 113 sailings
- [Africa](https://cruisello.com/destinations/africa.md): 98 sailings
- [Indian Ocean](https://cruisello.com/destinations/indian-ocean.md): 64 sailings
- [Middle East & Arabian Gulf](https://cruisello.com/destinations/middle-east-arabian-gulf.md): 56 sailings
- [Antarctica](https://cruisello.com/destinations/antarctica.md): 12 sailings
- [Greenland](https://cruisello.com/destinations/greenland.md): 4 sailings

---

## Optional

- [Full Context Version](https://cruisello.com/llms-full.txt): the complete reference — every `/cruises` filter parameter, the `ships`/port filter formats, search syntax, currency options, and worked example URLs, all inline. Use this when you have a larger context window or need the exact filter grammar.