# CruiseMapper cruises: `POST /v1/cruisemapper/cruises`

Cost: 2 credits (2 per page (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/cruisemapper-cruises

One page (15) of scheduled cruises, earliest departure first.

Each cruise carries its id, departure date, ship, cruise line, nights,
departure and arrival port, round-trip flag and lowest listed price per
person in USD. Filter by destination region, cruise theme, departure
port, port of call, ship, line, length, month and maximum price; ports,
ships and lines can be given by name, CruiseMapper URL or id. With
include_itinerary each cruise also gets its day-by-day ports with
arrival and departure times and the route distance. An empty page is
not charged.

Request body (JSON):

- `region` (string | integer | null; optional): Destination region, by name or id, e.g. 'Bahamas - Caribbean - Bermuda' (8), 'Alaska' (22), 'Mediterranean - Black Sea' (4), 'Europe Rivers' (14). A unique part of the name is enough ('caribbean').
- `cruise_type` (string | integer | null; optional): Cruise theme, by name or id, e.g. 'Christmas', 'New Year', 'Transatlantic', 'Panama Canal', 'Reposition Spring', 'Mini', 'World'.
- `departure_port` (string | integer | null; optional): Port the cruise leaves from: a port name ('Miami'), a CruiseMapper port URL or a port id.
- `port_of_call` (string | integer | null; optional): A port the cruise visits: name, CruiseMapper port URL or port id.
- `ship` (string | integer | null; optional): Ship name ('Wonder Of The Seas'), CruiseMapper ship URL or ship id.
- `line` (string | integer | null; optional): Cruise line name ('Royal Caribbean'), CruiseMapper cruise-line URL or line id.
- `nights` (string; optional; default any; one of any, 1-2, 3-5, 6-10, 11-14, 15+): Cruise length in nights.
- `month` (string | null; optional; pattern ^\d{4}-(0[1-9]|1[0-2])$): YYYY-MM. Lists cruises departing on or after the first day of this month (results are sorted by departure date, so the first pages hold this month). Default: from today.
- `max_price_usd` (integer | null; optional; min 1, max 10000): Highest price per person in USD (up to 10000). Cruises with no listed price are still included, with price_usd null.
- `page` (integer; optional; default 1; min 1, max 10000): Result page, 15 cruises per page.
- `include_itinerary` (boolean; optional; default false): Also return each cruise's day-by-day itinerary (ports, dates, arrival and departure times), route distance in nautical miles and theme.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
