# Princess Cruises Scraper - Itineraries & Prices (`vulnv/princess-cruises-scraper`) Actor Scrape Princess Cruises itineraries by destination, departure port, ship, date and duration. Extract ports of call, every sailing date and the full stateroom price grid (Inside, Oceanview, Balcony, Mini-Suite, Suite). Export to JSON, CSV or Excel. - **URL**: https://apify.com/vulnv/princess-cruises-scraper.md - **Developed by:** [VulnV](https://apify.com/vulnv) (community) - **Categories:** Travel, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Princess Cruises Scraper Scrape **Princess Cruises** data at scale: itineraries, ships, ports of call, every sailing date and the complete **stateroom price grid** (Inside, Oceanview, Balcony, Mini-Suite, Suite) - exported as clean, structured JSON, CSV or Excel. This Princess cruise scraper mirrors the filters on princess.com (destination, departure port, ship, ports of call, dates, duration, price) and returns one record per itinerary, with every sailing date and its prices included. No login or browser needed - it reads the official cruise search data directly, so runs are fast and cheap. ### 🚀 How to use 1. Click **Try for free** / **Start**. 2. Pick your filters - destination, departure port, ship, dates, duration (or leave them empty to scrape all available cruises). 3. Run the Actor and download the results as **JSON, CSV, Excel, HTML or via API**. ### ✨ Features - 🔎 **Full search filtering** - destination, departure port, ship, ports of call, departure date range, number of nights, max price and guest count. - 🚢 **Rich per-itinerary data** - ship, embarkation port, ordered ports of call, duration, destination region and every sailing date. - 💵 **Complete stateroom pricing** - lowest available price per cabin category (Inside, Oceanview, Balcony, Mini-Suite, Suite) across all sailings, plus per-sailing pricing. - 🗓️ **Every sailing date** - each itinerary lists all of its voyages with their own prices. - 🔗 **Detail page URL** - a ready-to-open link to each cruise on princess.com. - 🌍 **Any market** - defaults to the US market (USD); the currency and country are configurable. ### 🧭 Input All fields are optional. Run with no input to scrape all available cruises. | Field | Type | Description | |-------|------|-------------| | `destinations` | array | Destination region codes, e.g. `C` (Caribbean), `E` (Europe), `A` (Alaska). | | `departurePorts` | array | Embarkation port codes, e.g. `FLL`, `SOU`, `LAX`. | | `ships` | array | Ship codes, e.g. `SU` (Sun), `MJ` (Majestic), `RP` (Royal). | | `portsOfCall` | array | Keep cruises that visit these port codes (any stop). | | `minNights` / `maxNights` | integer | Cruise duration range, in nights. | | `departureDateFrom` / `departureDateTo` | string (YYYY-MM-DD) | Keep cruises sailing in this range. | | `maxPrice` | integer | Keep cruises with a stateroom at or below this price (per guest). | | `guests` | integer | Guests the prices are calculated for (default `2`, 1-4). | | `includeSailings` | boolean | Embed every sailing date with its ports and price grid (default `true`). | | `maxResults` | integer | Maximum number of itineraries to store (default `100`). | | `currency`, `agencyCountry` | string | Market overrides. Defaults target `USD` / `US`. | | `proxyConfiguration` | object | Optional proxy for outbound requests. | #### Example input ```json { "destinations": ["E"], "departurePorts": ["SOU"], "minNights": 7, "maxNights": 14, "departureDateFrom": "2026-06-01", "departureDateTo": "2026-09-30", "maxResults": 50 } ```` ### 📦 Output Each dataset item is one itinerary. Abridged example: ```json { "id": "ESR10B", "name": "European Capitals", "shipCode": "MJ", "shipName": "Majestic Princess", "nights": 10, "destinationCodes": ["E"], "destinations": ["Europe"], "departurePortCode": "SOU", "departurePort": "Southampton (for London), England", "portsOfCall": ["Southampton (for London), England", "Zeebrugge (for Brussels/Bruges), Belgium", "Rotterdam, The Netherlands", "Copenhagen, Denmark", "Aarhus, Denmark", "Hamburg, Germany (for Berlin)", "Le Havre (for Paris/Normandy), France", "Southampton (for London), England"], "portsOfCallText": "Southampton -> Zeebrugge -> Rotterdam -> Copenhagen -> Aarhus -> Hamburg -> Le Havre -> Southampton", "sailingsCount": 2, "firstSailDate": "2026-06-29", "lastSailDate": "2027-07-02", "lowestPrice": 1784, "priceFromInside": 1784, "priceFromOceanview": 2489, "priceFromBalcony": 2389, "priceFromMiniSuite": 3403, "priceFromSuite": 9160, "currency": "USD", "detailUrl": "https://www.princess.com/cruise-search/details/?voyageCode=8621", "cruiseDetails": { "sailings": [ { "voyageId": "8725", "sailDate": "2027-07-02", "duration": 10, "departurePortCode": "SOU", "ports": ["SOU", "ZE1", "AMS"], "prices": { "I": 1784, "O": 2489, "B": 2389, "M": 3403, "S": 9160 }, "detailUrl": "https://www.princess.com/cruise-search/details/?voyageCode=8725" } ] } } ``` The most useful facts (ship, ports, per-cabin "from" prices, sailing dates) are flattened to the **top level** so they appear directly in the dataset table; every sailing with its full price grid lives under `cruiseDetails`. The dataset has two views: **Overview** (flat table) and **Cruise details** (full nested object). ### 💡 Use cases - Monitor Princess cruise prices and deals for specific routes or ships. - Build a cruise comparison or price-alerting tool. - Analyse itineraries, ports of call and sailing durations across a season. - Feed structured cruise data into a travel agency or affiliate site. ### 💳 Pricing This Actor is monetized on a **pay-per-result + usage** basis: you pay a small fee per itinerary result, plus the Apify platform usage your run consumes. Runs are lightweight - direct API calls with no headless browser - so usage stays low. New users can try it on the Apify free tier (capped sample). See the **Pricing** tab for the current rate. ### ❓ FAQ **Is scraping Princess Cruises data legal?** The Actor collects only publicly available information shown on the Princess Cruises website. Use the data responsibly and in line with applicable laws and the site's terms. **Which market is scraped?** It defaults to the US market (USD). The `currency` and `agencyCountry` inputs let you target other markets. **Can I get all cabin prices and every sailing date?** Yes - keep `includeSailings` enabled (the default). Each itinerary then includes every sailing with its complete stateroom price grid. ### 🛠️ Our Other Scrapers Explore our full suite of scraping tools to power your data needs: - **[Royal Caribbean Cruises Scraper](https://apify.com/vulnv/royal-caribbean-cruises-scraper)** - Scrape Royal Caribbean itineraries, cabin prices and deals. - **[Celebrity Cruises Scraper](https://apify.com/vulnv/celebrity-cruises-scraper)** - Scrape Celebrity Cruises itineraries, cabin prices and deals. - **[Carnival Cruises Scraper](https://apify.com/vulnv/carnival-cruises-scraper)** - Scrape Carnival Cruise Line itineraries, cabin prices and deals. - **[NCL Cruises Scraper](https://apify.com/vulnv/ncl-cruises-scraper)** - Scrape Norwegian Cruise Line itineraries, cabin prices and deals. 📬 **Need help or have a feature request?** Contact us at or visit our [Apify profile](https://apify.com/vulnv). # Actor input Schema ## `destinations` (type: `array`): Filter by destination region. Leave empty for all destinations. ## `ships` (type: `array`): Filter by Princess ship. Leave empty for all ships. ## `departurePorts` (type: `array`): Filter by embarkation port (code). Leave empty for all ports. ## `portsOfCall` (type: `array`): Only keep cruises that visit these ports (port codes). Different from departure ports - these can be any stop on the itinerary. ## `minNights` (type: `integer`): Only include cruises with at least this many nights. ## `maxNights` (type: `integer`): Only include cruises with at most this many nights. ## `departureDateFrom` (type: `string`): Only include cruises with a sailing departing on or after this date (YYYY-MM-DD). ## `departureDateTo` (type: `string`): Only include cruises with a sailing departing on or before this date (YYYY-MM-DD). ## `maxPrice` (type: `integer`): Only include cruises with an available stateroom at or below this price (lowest cabin price per guest, in the chosen currency). ## `guests` (type: `integer`): Number of guests the prices are calculated for. ## `includeSailings` (type: `boolean`): Embed every sailing date with its ports and complete stateroom price grid under `cruiseDetails`. Disable for a leaner, flatter output. ## `maxResults` (type: `integer`): Maximum number of itineraries to store. ## `currency` (type: `string`): Pricing currency, e.g. USD, GBP, AUD, CAD, EUR. ## `agencyCountry` (type: `string`): Two-letter market country code, e.g. US, GB, AU, CA. ## `apiBase` (type: `string`): Princess API gateway base. Advanced; leave as default. ## `proxyConfiguration` (type: `object`): Optional proxy used for all outbound requests. Apify Proxy (datacenter) is usually sufficient. ## Actor input object example ```json { "guests": 2, "includeSailings": true, "maxResults": 50, "currency": "USD", "agencyCountry": "US", "apiBase": "https://gw.api.princess.com/pcl-web/internal", "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("vulnv/princess-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 = { "maxResults": 50, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("vulnv/princess-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 '{ "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true } }' | apify call vulnv/princess-cruises-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=vulnv/princess-cruises-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Princess Cruises Scraper - Itineraries & Prices", "description": "Scrape Princess Cruises itineraries by destination, departure port, ship, date and duration. Extract ports of call, every sailing date and the full stateroom price grid (Inside, Oceanview, Balcony, Mini-Suite, Suite). Export to JSON, CSV or Excel.", "version": "1.0", "x-build-id": "bKT7ARLQ56Ev8Pup9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vulnv~princess-cruises-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vulnv-princess-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/vulnv~princess-cruises-scraper/runs": { "post": { "operationId": "runs-sync-vulnv-princess-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/vulnv~princess-cruises-scraper/run-sync": { "post": { "operationId": "run-sync-vulnv-princess-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", "properties": { "destinations": { "title": "Destinations", "type": "array", "description": "Filter by destination region. Leave empty for all destinations.", "items": { "type": "string", "enum": [ "C", "E", "R", "A", "M", "H", "O", "J", "U", "Z", "I", "P", "B", "N", "L", "T", "S", "Q", "F", "V", "W" ], "enumTitles": [ "Caribbean", "Europe", "Europe - Northern", "Alaska", "Mexico", "Hawaii", "Asia", "Japan", "Australia", "Australia & New Zealand", "South Pacific", "Tahiti & South Pacific", "Bermuda", "Canada & New England", "California Coast", "Panama Canal", "South America & Antarctica", "Cuba", "Transatlantic", "Grand Voyages", "World Cruises" ] } }, "ships": { "title": "Ships", "type": "array", "description": "Filter by Princess ship. Leave empty for all ships.", "items": { "type": "string", "enum": [ "SU", "ST", "XP", "EX", "YP", "MJ", "RP", "RU", "EP", "KP", "CB", "AP", "DI", "SA", "IP", "CO", "RO" ], "enumTitles": [ "Sun Princess", "Star Princess", "Discovery Princess", "Enchanted Princess", "Sky Princess", "Majestic Princess", "Royal Princess", "Ruby Princess", "Emerald Princess", "Crown Princess", "Caribbean Princess", "Grand Princess", "Diamond Princess", "Sapphire Princess", "Island Princess", "Coral Princess", "Regal Princess" ] } }, "departurePorts": { "title": "Departure ports", "type": "array", "description": "Filter by embarkation port (code). Leave empty for all ports.", "items": { "type": "string", "enum": [ "FLL", "PCV", "MIA", "NYC", "SJU", "LAX", "SFO", "SEA", "YVR", "WH1", "BOS", "SOU", "ROM", "ATH", "BCN", "CPH", "TRS", "REK", "HEL", "TYO", "YOK", "SIN", "SYD", "BNE", "MEL", "AKL", "BGI", "BUE" ], "enumTitles": [ "Ft. Lauderdale, Florida", "Port Canaveral (Orlando), Florida", "Miami, Florida", "New York City, New York", "San Juan, Puerto Rico", "Los Angeles, California", "San Francisco, California", "Seattle, Washington", "Vancouver, Canada", "Anchorage (Whittier), Alaska", "Boston, Massachusetts", "Southampton (London), England", "Civitavecchia (Rome), Italy", "Athens (Piraeus), Greece", "Barcelona, Spain", "Copenhagen, Denmark", "Trieste (Venice), Italy", "Reykjavik, Iceland", "Helsinki, Finland", "Tokyo, Japan", "Tokyo (Yokohama), Japan", "Singapore", "Sydney, Australia", "Brisbane, Australia", "Melbourne, Australia", "Auckland, New Zealand", "Barbados", "Buenos Aires, Argentina" ] } }, "portsOfCall": { "title": "Ports of call", "type": "array", "description": "Only keep cruises that visit these ports (port codes). Different from departure ports - these can be any stop on the itinerary.", "items": { "type": "string" } }, "minNights": { "title": "Minimum nights", "minimum": 1, "type": "integer", "description": "Only include cruises with at least this many nights." }, "maxNights": { "title": "Maximum nights", "minimum": 1, "type": "integer", "description": "Only include cruises with at most this many nights." }, "departureDateFrom": { "title": "Departure date from", "type": "string", "description": "Only include cruises with a sailing departing on or after this date (YYYY-MM-DD)." }, "departureDateTo": { "title": "Departure date to", "type": "string", "description": "Only include cruises with a sailing departing on or before this date (YYYY-MM-DD)." }, "maxPrice": { "title": "Maximum price", "minimum": 1, "type": "integer", "description": "Only include cruises with an available stateroom at or below this price (lowest cabin price per guest, in the chosen currency)." }, "guests": { "title": "Guests", "minimum": 1, "maximum": 4, "type": "integer", "description": "Number of guests the prices are calculated for.", "default": 2 }, "includeSailings": { "title": "Include full sailing details", "type": "boolean", "description": "Embed every sailing date with its ports and complete stateroom price grid under `cruiseDetails`. Disable for a leaner, flatter output.", "default": true }, "maxResults": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Maximum number of itineraries to store.", "default": 100 }, "currency": { "title": "Currency", "type": "string", "description": "Pricing currency, e.g. USD, GBP, AUD, CAD, EUR.", "default": "USD" }, "agencyCountry": { "title": "Agency country", "type": "string", "description": "Two-letter market country code, e.g. US, GB, AU, CA.", "default": "US" }, "apiBase": { "title": "API base URL", "type": "string", "description": "Princess API gateway base. Advanced; leave as default.", "default": "https://gw.api.princess.com/pcl-web/internal" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy used for all outbound requests. Apify Proxy (datacenter) is usually sufficient.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```