Pricing

Rating

Developer

Actor stats

Categories

Share

CruiseMapper Cruises Scraper

Search CruiseMapper.com — the largest free public cruise database — by destination, ship, cruise line, length, type, and date. Returns one structured record per cruise with departure date, ship, duration, route, title, and starting price. HTTP-only — no proxy, no cookies, no API key.

What it does

You set any combination of filters; the actor:

1. Submits the search to cruisemapper.com/cruise-search with your filters mapped to the site's form params.
2. Walks paginated result pages (15 cruises per page) until maxResults is reached.
3. Parses each result row into a flat record with date, ship, duration, route type, title, price, and ship-detail URL.
4. Optionally narrows results by an endDate upper bound and cruiseLength bucket (client-side validation).

Empty fields are omitted (no nulls). Cruises without a published price still emit a record with priceFrom/currency absent.

Input

Example input

{
"departureFrom":"2026-06-01",
"endDate":"2026-09-30",
"cruiseLength":"6-10",
"destination":"alaska",
"cruiseType":"any",
"maxResults":100
}

Output

One record per cruise. Empty fields are omitted (no nulls).

{
"departureDate":"2026-06-15",
"departureDateText":"2026 Jun 15",
"daysUntilDeparture":14,
"shipName":"AmaLilia",
"shipUrl":"https://www.cruisemapper.com/ships/AmaLilia-1340",
"duration":11,
"routeType":"round-trip",
"title":"Secrets of Egypt the Nile",
"priceFrom":6334,
"currency":"USD",
"nights":11,
"pricePerNightUsd":575.82,
"shipDetails":{
"yearBuilt":2024,
"builder":"Maasara Shipyard (Cairo, Egypt)",
"shipClass":"Nile River cruiser",
"speed":"9 kn / 17 km/h / 10 mph",
"lengthMeters":72,
"beamMeters":13,
"passengerCapacity":68,
"crewCount":62,
"deckCount":5,
"cabinCount":34
},
"scrapedAt":"2024-12-16T14:23:11+00:00"
}

Output fields

• departureDate — ISO date YYYY-MM-DD of departure (parsed from the table's free-form text).
• departureDateText — original date string from the page (e.g. "2026 Apr 27") — useful for QA / verification.
• daysUntilDeparture — derived integer: days from now (UTC) to departureDate. Negative for departures in the past.
• shipName — vessel name as listed by CruiseMapper.
• shipUrl — direct link to the ship's CruiseMapper detail page (deck plans, photos, cabin info).
• duration — cruise length in days (parsed from "N days, ...").
• routeType — round-trip, one-way, open-jaw, or transatlantic when present in the title prefix.
• title — cruise itinerary title (e.g. "Secrets of Egypt the Nile", "Western Caribbean").
• priceFrom — starting USD price as integer; absent when CruiseMapper doesn't publish a price for the cruise.
• currency — USD / EUR / GBP; absent when priceFrom is absent.
• shipDetails — (only when enrichWithShipData: true) flat dict with yearBuilt, builder, shipClass, flagState, speed, lengthMeters, beamMeters, draftMeters, grossTonnage, passengerCapacity, crewCount, deckCount, cabinCount, decksWithCabins, engines, etc. Each ship is fetched once per run and cached.
• nights — derived integer: cruise length in nights (parsed from the duration string). Identical to duration for standard cruises.
• pricePerNightUsd — derived: priceFrom ÷ nights when both are available. Useful for comparing value across cruise lengths.
• scrapedAt — ISO-8601 UTC timestamp.

Use cases

• Travel-planning aggregation — feed your travel app with fresh CruiseMapper inventory.
• Price-monitoring — track starting-price trends for specific ships / cruise lines / destinations over time.
• Competitive research — see what competitors are pricing for the same routes.
• Content / editorial — generate weekly "Cruises departing this month from Miami" digests.
• Inventory enrichment — combine with a cruise-line site scraper to triangulate pricing across sources.

FAQ

Does it need a proxy or cookies? No. CruiseMapper search results are public and the actor connects directly with a Chrome-impersonated TLS fingerprint.

Why is priceFrom missing on some records? Roughly 30–40% of CruiseMapper listings don't publish a starting price (they require contacting the cruise line). The actor follows an omit-empty contract — fields not present on the source are simply absent from the record (no nulls).

Are the date / duration filters server-side or client-side? Mixed. departureFrom, cruiseLength, destination, cruiseType, shipName, cruiseLine, departurePort, portOfCall, and maxPrice are submitted as form params (server-side). endDate and the duration-bucket boundary check are applied client-side after parsing each result row, since CruiseMapper's form has no end-date field.

How many results can I get in one run? Up to maxResults (max 500). CruiseMapper paginates ~15 cruises per page; 500 records ≈ 34 pages × ~1.5s = under a minute on a clean run.

Can I scrape ship-detail pages too? This actor focuses on the search results table. Use the shipUrl field with a downstream actor (or a follow-up run) for ship deck plans, cabin layouts, and photos.

What if my filters return zero cruises? The run completes without fake rows and sets a status message explaining that no cruises matched the filters.

Why is the route type sometimes empty? CruiseMapper only embeds round-trip/one-way/open-jaw/transatlantic in the title for ~70% of cruises. When the title doesn't start with a known route-type prefix, the field is omitted.