# MSC Cruises scraper - Complete Cruise Data Extractor (`sercul/msc-cruises-scraper`) Actor Why Choose This Scraper? ✅ Extract from 5 MSC markets (US, UK, IT, DE, AT) ✅ Complete cruise data with multi-cabin pricing (Interior, Oceanview, Balcony, Suite, Yacht Club) ✅ Filter by 25 destination regions ✅ Three API strategies for maximum coverage ✅ Apify/custom proxy support - **URL**: https://apify.com/sercul/msc-cruises-scraper.md - **Developed by:** [Jeremy G](https://apify.com/sercul) (community) - **Categories:** Travel, Other, E-commerce - **Stats:** 25 total users, 6 monthly users, 75.9% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## MSC Cruises Scraper — Complete Cruise Data Extractor Extract **cruise listings, itineraries, and per-cabin pricing** from MSC Cruises across 7 regional markets. Built for travel agencies, price comparison sites, affiliate marketers, and cruise-industry analysts. ### Updates - **2026-06-13** — Much broader European coverage: UK, Italy, Germany, Austria, France & Spain now return **all departure dates** for each itinerary (previously only one representative sailing) — roughly 4–5× more cruises per market. - **2026-06-11** — New markets added: France (`fr_FR`, EUR), Spain (`es_ES`, EUR). ### Why Choose This Scraper? - ✅ Extract from **7 MSC markets** (US, UK, IT, DE, AT, FR, ES) with local-currency pricing - ✅ Complete cruise data with **multi-cabin pricing tiers** (Interior, Oceanview, Balcony, Suite, Yacht Club) - ✅ Filter by **25 destination regions** (Mediterranean, Caribbean, Northern Europe, Dubai, Asia, and more) - ✅ **Full forward catalog** — every available sailing across the booking window - ✅ **Direct booking/source URLs** + itinerary images on every sailing - ✅ Apify + custom proxy support with geo-matched country codes ### Use Cases - **European travel agencies** — MSC's biggest strength is Mediterranean and Northern Europe routes - **Affiliate/comparison sites** — deep-linkable booking URLs + images - **Yacht Club / premium travel affiliates** — rich luxury tier pricing - **Cruise analysts** — compare MSC's aggressive EU pricing vs. Royal Caribbean / Costa ### Supported Markets | Region | Domain | Currency | |--------|--------|----------| | `en_US` | msccruisesusa.com | USD | | `en_GB` | msccruises.co.uk | GBP | | `it_IT` | msccrociere.it | EUR | | `de_DE` | msccruises.de | EUR | | `de_AT` | msccruises.at | EUR | | `fr_FR` | msccroisieres.fr | EUR | | `es_ES` | msccruceros.es | EUR | ### Input | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | `region`* | string | Market to scrape | `en_US` | | `maxRows` | number | Maximum unique cruise results (1-10000) | `500` | | `destinations` | string[] | Filter by destination code | All | | `maxRequestRetries` | number | Retries for failed requests | `5` | | `requestHandlerTimeoutSecs` | number | Request timeout (seconds) | `30` | | `useApifyProxy` | boolean | Use Apify Residential proxy | `true` | | `apifyProxyCountryCode` | string | Override proxy country | Auto | | `apifyProxyGroups` | string | Proxy tier | `RESIDENTIAL` | | `proxyUrl` | string | Custom proxy URL | — | **Proxy:** the `en_US` market **requires** a RESIDENTIAL proxy (`useApifyProxy: true`); other markets also accept a custom `proxyUrl`. Use geo-matched country codes. ### Destination Codes | Code | Destination | Code | Destination | |------|-------------|------|-------------| | `MED` | Mediterranean | `CAR` | Caribbean | | `WEE` | Western Mediterranean | `SOC` | Southern Caribbean | | `EME` | Eastern Mediterranean | `NCA` | Northern Caribbean | | `MEW` | Mediterranean West | `BHM` | Bahamas | | `FIO` | Northern Europe & Fjords | `ALA` | Alaska | | `NOR` | Northern Europe | `EMW` | Dubai & Middle East (US) | | `CUK` | Cruises from UK | `DUB` | Middle East & Dubai (EU) | | `BAC` | British Isles & Atlantic Coast | `SOA` | South America | | `TRA` | Transatlantic | `ASI` | Asia | | `WOR` | World Cruise | `FAE` | Far East Asia | | `PAN` | Panama Canal | `AFR` | Africa | | `POS` | Grand Voyages | `INW` | Indian Ocean | | `NOA` | North America | | | ### Cabin Codes | Code | Cabin Type | |------|------------| | `INTERIOR` | Interior / Inside | | `OCEANVIEW` | Ocean View | | `BALCONY` | Balcony | | `SUITE` | Suite | | `YACHT_CLUB` | MSC Yacht Club (premium, ship-within-a-ship) | ### Output Each record is a single unique cruise (deduped by `cruise_id`) with: - Cruise and itinerary identifiers (`cruise_id`, `itinerary_id`) - Ship name, departure/arrival ports, sailing dates, duration - Lowest available price with currency - Ports of call - `pricing_tiers` object with per-cabin breakdown (EU/UK/IT markets) - `itineraryImage` — sailing thumbnail URL - Service charges and port charges (where applicable) - `source_url` — direct booking link - `platform`, `company`, `locale`, `destinationIds` #### Sample Output ```json { "cruise_id": "MSC_SEASCAPE_2026-08-15", "itinerary_id": "MSC_7N_MEDITERRANEAN", "company": "msc", "locale": "it_IT", "platform": "msc-it_IT", "title": "7 Nights Western Mediterranean", "ship_name": "MSC Seascape", "departure_date": "2026-08-15", "duration": 7, "price": 849, "currency": "EUR", "pricing_tiers": { "INTERIOR": { "amount": 849, "currency": "EUR" }, "OCEANVIEW": { "amount": 999, "currency": "EUR" }, "BALCONY": { "amount": 1299, "currency": "EUR" }, "SUITE": { "amount": 2199, "currency": "EUR" }, "YACHT_CLUB": { "amount": 3499, "currency": "EUR" } }, "destinations": ["MED", "WEE"], "ports_list": ["Genoa", "Civitavecchia", "Palermo", "Valletta", "Barcelona", "Marseille", "Genoa"], "itineraryImage": "https://www.msccrociere.it/...", "source_url": "https://www.msccrociere.it/..." } ```` Every record carries the full per-cabin `pricing_tiers` breakdown where MSC publishes it. ### Runtime & Cost - **Typical run:** ~2-4 minutes for 500 rows - **Full EU/UK/IT market sweep:** ~1 minute for 1,500+ cruises - **Full US market sweep:** ~10-15 minutes for 4,000 cruises - **Memory:** 1 GB default (2 GB recommended for the full US sweep) - **Proxy:** US requires residential; other markets work with residential or a custom proxy ### Usage ```json { "region": "it_IT", "maxRows": 500, "destinations": ["MED", "WEE"], "useApifyProxy": true, "apifyProxyGroups": "RESIDENTIAL" } ``` ### Notes - Prices in `pricing_tiers` follow a consistent `{amount, currency}` shape - `maxRows` counts **unique cruises** (deduped by `cruise_id`) - Results stream to the dataset as they are collected, so partial results remain available if a run is stopped early ### Related Actors Looking to build a full cruise pricing dataset? Pair this with: - **Costa Cruises Scraper** — MSC's closest EU competitor - **Royal Caribbean Scraper** — premium tier comparison - **Celebrity Cruises Scraper** — 6 markets - **NCL / Princess / Disney / Holland America / Carnival Scrapers** — full coverage ### Support Issues or custom requests? Email **support@track.cruises**. # Actor input Schema ## `region` (type: `string`): MSC market to scrape. Each region uses different currency and pricing. ## `maxRows` (type: `integer`): Maximum number of unique cruises to fetch (global cap, after cross-window dedup). BFF enumerates 36 monthly date windows; full US catalog is ~6,200 cruises. EU markets return multiple hits per cruise for cabin variants. ## `destinations` (type: `array`): Filter by destination areas. Leave empty to scrape all destinations. ## `maxRequestRetries` (type: `integer`): Maximum retries for failed requests ## `useApifyProxy` (type: `boolean`): Use Apify RESIDENTIAL proxy with country matching the selected region. Required for the default (en\_US) run — MSC's host is Akamai-protected and 403s without a proxy. Set false only when supplying a custom proxyUrl. ## `apifyProxyCountryCode` (type: `string`): Override proxy country (e.g., GB, US, IT, DE). Leave empty to auto-match from region. ## `proxyUrl` (type: `string`): Custom proxy URL (only when Apify Proxy is disabled). Format: http\[s]://user:pass@host:port ## Actor input object example ```json { "region": "en_US", "maxRows": 500, "maxRequestRetries": 5, "useApifyProxy": true } ``` # Actor output Schema ## `cruises` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "useApifyProxy": true }; // Run the Actor and wait for it to finish const run = await client.actor("sercul/msc-cruises-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "useApifyProxy": True } # Run the Actor and wait for it to finish run = client.actor("sercul/msc-cruises-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "useApifyProxy": true }' | apify call sercul/msc-cruises-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sercul/msc-cruises-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "MSC Cruises scraper - Complete Cruise Data Extractor", "description": "Why Choose This Scraper?\n ✅ Extract from 5 MSC markets (US, UK, IT, DE, AT)\n ✅ Complete cruise data with multi-cabin pricing (Interior, Oceanview, Balcony, Suite, Yacht Club)\n ✅ Filter by 25 destination regions\n ✅ Three API strategies for maximum coverage\n ✅ Apify/custom proxy support", "version": "0.0", "x-build-id": "5W2VGZL8cl8EGMxQf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sercul~msc-cruises-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sercul-msc-cruises-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sercul~msc-cruises-scraper/runs": { "post": { "operationId": "runs-sync-sercul-msc-cruises-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sercul~msc-cruises-scraper/run-sync": { "post": { "operationId": "run-sync-sercul-msc-cruises-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "region" ], "properties": { "region": { "title": "Region", "enum": [ "en_US", "en_GB", "it_IT", "de_DE", "de_AT", "fr_FR", "es_ES" ], "type": "string", "description": "MSC market to scrape. Each region uses different currency and pricing.", "default": "en_US" }, "maxRows": { "title": "Maximum Cruises", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of unique cruises to fetch (global cap, after cross-window dedup). BFF enumerates 36 monthly date windows; full US catalog is ~6,200 cruises. EU markets return multiple hits per cruise for cabin variants.", "default": 500 }, "destinations": { "title": "Destinations", "type": "array", "description": "Filter by destination areas. Leave empty to scrape all destinations.", "items": { "type": "string", "enum": [ "MED", "WEE", "EME", "MEW", "FIO", "NOR", "CUK", "BAC", "CAR", "SOC", "NCA", "BHM", "ALA", "EMW", "DUB", "SOA", "TRA", "ASI", "FAE", "AFR", "WOR", "PAN", "POS", "INW", "NOA" ], "enumTitles": [ "Mediterranean", "Western Mediterranean", "Eastern Mediterranean", "Mediterranean West", "Northern Europe & Fjords", "Northern Europe", "Cruises from UK", "British Isles & Atlantic Coast", "Caribbean", "Southern Caribbean", "Northern Caribbean", "Bahamas", "Alaska", "Dubai & Middle East (US)", "Middle East & Dubai (EU)", "South America", "Transatlantic", "Asia", "Far East Asia", "Africa", "World Cruise", "Panama Canal", "Grand Voyages", "Indian Ocean", "North America" ] } }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum retries for failed requests", "default": 5 }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Use Apify RESIDENTIAL proxy with country matching the selected region. Required for the default (en_US) run — MSC's host is Akamai-protected and 403s without a proxy. Set false only when supplying a custom proxyUrl.", "default": true }, "apifyProxyCountryCode": { "title": "Apify Proxy Country Code", "type": "string", "description": "Override proxy country (e.g., GB, US, IT, DE). Leave empty to auto-match from region." }, "proxyUrl": { "title": "Custom Proxy URL", "type": "string", "description": "Custom proxy URL (only when Apify Proxy is disabled). Format: http[s]://user:pass@host:port" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```