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

Cost: 2 credits (2 per started 10 ships (a ship with no position and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/cruisemapper-positions

Latest reported position of every tracked cruise ship (about 1,100
world-wide), optionally for one cruise line and/or inside a lat/lon box.

Each ship carries name, IMO, MMSI, flag, cruise line and operating
brand, latitude and longitude, speed in knots, course, heading,
reported destination and report time (UTC). Course and heading are null
when the ship does not report them. An empty result is not charged.

Request body (JSON):

- `line` (string | integer | null; optional): Only ships of this cruise line (name or id), or of this operating brand (e.g. 'MOBY LINES').
- `min_lat` (number | null; optional; min -90, max 90): Box south edge.
- `max_lat` (number | null; optional; min -90, max 90): Box north edge.
- `min_lon` (number | null; optional; min -180, max 180): Box west edge.
- `max_lon` (number | null; optional; min -180, max 180): Box east edge (must be greater than min_lon).

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)
