# Carnival Cruises Scraper - Itineraries & Prices (`vulnv/carnival-cruises-scraper`) Actor

Scrape Carnival Cruise Line itineraries by destination, departure port, ship, date and duration. Extract day-by-day schedules, every sailing date and the full stateroom price grid (Interior, Ocean View, Balcony, Suite). Export to JSON, CSV or Excel.

- **URL**: https://apify.com/vulnv/carnival-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

## Carnival Cruises Scraper

Scrape **Carnival Cruise Line** data at scale: itineraries, ships, day-by-day schedules,
every sailing date and the complete **stateroom price grid** (Interior, Ocean View, Balcony,
Suite) - exported as clean, structured JSON, CSV or Excel.

This Carnival cruise scraper mirrors the filters on carnival.com (destination, departure port,
ship, 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, departure date range,
  number of nights, max price, special collections, guest count and discount rates.
- 🚢 **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 (Interior,
  Ocean View, Balcony, Suite) across all sailings, plus per-sailing pricing for each room type.
- 🗓️ **Day-by-day schedule** - the lead sailing's full schedule with port, arrival and
  departure times for each day.
- 🔗 **Detail page URL & image** - a ready-to-open link to each cruise on carnival.com.
- 🌍 **Any market** - defaults to the US market (USD); the currency and locality 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), `BH` (Bahamas), `A` (Alaska). |
| `departurePorts` | array | Embarkation port codes, e.g. `MIA`, `GAL`, `PCV`. |
| `ships` | array | Ship codes, e.g. `MD` (Mardi Gras), `CB` (Celebration), `VS` (Vista). |
| `minNights` / `maxNights` | integer | Cruise duration range, in nights (2-23). |
| `departureDateFrom` / `departureDateTo` | string (YYYY-MM-DD) | Keep cruises departing in this range (filtered by month). |
| `maxPrice` | integer | Keep cruises with a lead price at or below this value. |
| `specials` | array | Curated collections, e.g. `J` (Carnival Journeys). |
| `numAdults` | integer | Adults the prices are calculated for (default `2`, 1-4). |
| `military` / `senior` / `pastGuest` | boolean | Apply military / senior / past-guest (VIFP) rates. |
| `sort` | string | `fromprice` (lowest price) or `recommended`. |
| `includeSailings` | boolean | Embed the day-by-day schedule and every sailing + price grid (default `true`). |
| `maxResults` | integer | Maximum number of itineraries to store (default `100`). |
| `currency`, `locality` | string | Market overrides. Defaults target `USD` / `1` (US). |
| `proxyConfiguration` | object | Optional proxy for outbound requests. |

#### Example input

```json
{
  "destinations": ["C"],
  "departurePorts": ["MIA"],
  "minNights": 6,
  "maxNights": 8,
  "departureDateFrom": "2026-11-01",
  "departureDateTo": "2027-03-31",
  "sort": "fromprice",
  "maxResults": 50
}
````

### 📦 Output

Each dataset item is one itinerary. Abridged example:

```json
{
  "id": "WSI_MIA_CB_7_Sun",
  "code": "WSI",
  "title": "7-Day Western Caribbean from Miami, FL",
  "shipCode": "CB",
  "shipName": "Carnival Celebration",
  "nights": 7,
  "destinationCode": "WC",
  "destination": "Western Caribbean",
  "departurePortCode": "MIA",
  "departurePort": "Miami, FL",
  "roundtrip": true,
  "portsOfCall": ["Miami", "Isla Tropicale, Roatan", "Cozumel", "Celebration Key™"],
  "portsOfCallText": "Miami -> Isla Tropicale, Roatan -> Cozumel -> Celebration Key™",
  "sailingsCount": 5,
  "firstDeparture": "2026-11-29",
  "lastDeparture": "2027-05-16",
  "lowestPrice": 446,
  "priceFromInterior": 446,
  "priceFromOceanview": 506,
  "priceFromBalcony": 691,
  "priceFromSuite": 1030,
  "currency": "USD",
  "taxesAndFees": 0,
  "imageUrl": "https://www.carnival.com/-/media/Images/.../isla-tropicale-roatan.jpg",
  "detailUrl": "https://www.carnival.com/itinerary/7-day-western-caribbean-cruise/miami/celebration/7-days/wsi",
  "cruiseDetails": {
    "leadSailing": {
      "fromPrice": 446,
      "departureDate": "2026-11-29T00:00:00.000Z",
      "schedule": [ { "day": 1, "port": "Miami", "portCode": "MIA", "depart": "2026-11-29T15:30:00+00:00" } ]
    },
    "stateroomMetaInformation": [ { "metacode": "IS", "title": "Interior", "isAvailable": true } ],
    "sailings": [ { "departureDate": "2026-11-29T00:00:00.000Z", "rooms": { "interior": { "price": 446, "priceCurrency": "USD", "soldOut": false } } } ]
  }
}
```

The most useful facts (ship, ports, per-cabin "from" prices, departure dates) are flattened to
the **top level** so they appear directly in the dataset table; the full schedule and per-sailing
pricing live under `cruiseDetails`. The dataset has two views: **Overview** (flat table) and
**Cruise details** (full nested object).

### 💡 Use cases

- Monitor Carnival 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 Carnival data legal?**
The Actor collects only publicly available information shown on the Carnival 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 `locality` 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 the full
day-by-day schedule and 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.
- **[NCL Cruises Scraper](https://apify.com/vulnv/ncl-cruises-scraper)** - Scrape Norwegian Cruise Line itineraries, cabin prices and deals.
- **[MSC Cruises Scraper](https://apify.com/vulnv/msc-cruises-scraper)** - Scrape MSC Cruises itineraries, cabin prices and deals.
- **[Yelp Business Scraper](https://apify.com/vulnv/yelp-scraper)** - Scrape Yelp business listings, ratings and contact details.

📬 **Need help or have a feature request?** Contact us at <support@vulnv.com> 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 Carnival ship. Leave empty for all ships.

## `departurePorts` (type: `array`):

Filter by embarkation port. Leave empty for all ports.

## `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 departing on or after this date (YYYY-MM-DD). Carnival filters by month.

## `departureDateTo` (type: `string`):

Only include cruises departing on or before this date (YYYY-MM-DD). Carnival filters by month.

## `specials` (type: `array`):

Filter by a curated Carnival collection.

## `maxPrice` (type: `integer`):

Only include cruises with a lead price at or below this value (per person, in the chosen currency).

## `numAdults` (type: `integer`):

Number of adults the prices are calculated for.

## `military` (type: `boolean`):

Apply military rates where available.

## `senior` (type: `boolean`):

Apply senior (55+) rates where available.

## `pastGuest` (type: `boolean`):

Apply past-guest (VIFP) rates where available.

## `sort` (type: `string`):

Order the results returned by the Carnival search.

## `includeSailings` (type: `boolean`):

Embed the lead sailing's day-by-day schedule and every sailing date with its 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.

## `locality` (type: `string`):

Carnival market locality code (1 = US). Advanced; usually leave as default.

## `baseUrl` (type: `string`):

Storefront base URL.

## `proxyConfiguration` (type: `object`):

Optional proxy used for all outbound requests. Apify Proxy (datacenter) is usually sufficient.

## Actor input object example

```json
{
  "numAdults": 2,
  "military": false,
  "senior": false,
  "pastGuest": false,
  "sort": "fromprice",
  "includeSailings": true,
  "maxResults": 50,
  "currency": "USD",
  "locality": "1",
  "baseUrl": "https://www.carnival.com",
  "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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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/carnival-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxResults": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("vulnv/carnival-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/carnival-cruises-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=vulnv/carnival-cruises-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Carnival Cruises Scraper - Itineraries & Prices",
        "description": "Scrape Carnival Cruise Line itineraries by destination, departure port, ship, date and duration. Extract day-by-day schedules, every sailing date and the full stateroom price grid (Interior, Ocean View, Balcony, Suite). Export to JSON, CSV or Excel.",
        "version": "1.0",
        "x-build-id": "vObsKzf3JU96W9Vpr"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/vulnv~carnival-cruises-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-vulnv-carnival-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~carnival-cruises-scraper/runs": {
            "post": {
                "operationId": "runs-sync-vulnv-carnival-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~carnival-cruises-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-vulnv-carnival-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",
                                "BH",
                                "M",
                                "A",
                                "E",
                                "BM",
                                "NN",
                                "H",
                                "T",
                                "S",
                                "ET",
                                "TP",
                                "X",
                                "U",
                                "NZ",
                                "O",
                                "GC",
                                "CBK",
                                "RTB",
                                "HMD"
                            ],
                            "enumTitles": [
                                "Caribbean",
                                "The Bahamas",
                                "Mexico",
                                "Alaska",
                                "Europe",
                                "Bermuda",
                                "Canada & New England",
                                "Hawaii",
                                "Panama Canal",
                                "South America",
                                "Transatlantic",
                                "Transpacific",
                                "Asia",
                                "Australia",
                                "New Zealand",
                                "South Pacific",
                                "Greenland & Canada",
                                "Celebration Key",
                                "Isla Tropicale, Roatan",
                                "RelaxAway, Half Moon Cay"
                            ]
                        }
                    },
                    "ships": {
                        "title": "Ships",
                        "type": "array",
                        "description": "Filter by Carnival ship. Leave empty for all ships.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "MD",
                                "CB",
                                "JB",
                                "VS",
                                "PO",
                                "HZ",
                                "MC",
                                "PR",
                                "RD",
                                "FD",
                                "VA",
                                "GL",
                                "LI",
                                "SL",
                                "DR",
                                "BR",
                                "SN",
                                "SH",
                                "VX",
                                "FN",
                                "LM",
                                "MI",
                                "LE",
                                "SP",
                                "EL",
                                "PA",
                                "AQ",
                                "EQ",
                                "CQ",
                                "FT"
                            ],
                            "enumTitles": [
                                "Mardi Gras",
                                "Carnival Celebration",
                                "Carnival Jubilee",
                                "Carnival Vista",
                                "Carnival Panorama",
                                "Carnival Horizon",
                                "Carnival Magic",
                                "Carnival Pride",
                                "Carnival Radiance",
                                "Carnival Freedom",
                                "Carnival Valor",
                                "Carnival Glory",
                                "Carnival Liberty",
                                "Carnival Splendor",
                                "Carnival Dream",
                                "Carnival Breeze",
                                "Carnival Sunrise",
                                "Carnival Sunshine",
                                "Carnival Venezia",
                                "Carnival Firenze",
                                "Carnival Luminosa",
                                "Carnival Miracle",
                                "Carnival Legend",
                                "Carnival Spirit",
                                "Carnival Elation",
                                "Carnival Paradise",
                                "Carnival Adventure",
                                "Carnival Encounter",
                                "Carnival Conquest",
                                "Carnival Festivale"
                            ]
                        }
                    },
                    "departurePorts": {
                        "title": "Departure ports",
                        "type": "array",
                        "description": "Filter by embarkation port. Leave empty for all ports.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "MIA",
                                "PCV",
                                "GAL",
                                "TPA",
                                "MSY",
                                "JAX",
                                "MOB",
                                "NYC",
                                "BWI",
                                "ORF",
                                "LAX",
                                "SFO",
                                "SEA",
                                "BCN",
                                "CIV",
                                "LIS",
                                "LON",
                                "SIN",
                                "HKG",
                                "SYD",
                                "MEL",
                                "BNE",
                                "ADL",
                                "AKL",
                                "SAI"
                            ],
                            "enumTitles": [
                                "Miami, FL",
                                "Port Canaveral (Orlando), FL",
                                "Galveston, TX",
                                "Tampa, FL",
                                "New Orleans, LA",
                                "Jacksonville, FL",
                                "Mobile, AL",
                                "Manhattan, New York City, NY",
                                "Baltimore, MD",
                                "Norfolk, VA",
                                "Los Angeles, CA",
                                "San Francisco, CA",
                                "Seattle, WA",
                                "Barcelona, Spain",
                                "Civitavecchia (Rome), Italy",
                                "Lisbon, Portugal",
                                "London, England",
                                "Singapore",
                                "Hong Kong",
                                "Sydney, Australia",
                                "Melbourne, Australia",
                                "Brisbane, Australia",
                                "Adelaide, Australia",
                                "Auckland, New Zealand",
                                "San Antonio (Santiago), Chile"
                            ]
                        }
                    },
                    "minNights": {
                        "title": "Minimum nights",
                        "minimum": 2,
                        "maximum": 23,
                        "type": "integer",
                        "description": "Only include cruises with at least this many nights."
                    },
                    "maxNights": {
                        "title": "Maximum nights",
                        "minimum": 2,
                        "maximum": 23,
                        "type": "integer",
                        "description": "Only include cruises with at most this many nights."
                    },
                    "departureDateFrom": {
                        "title": "Departure date from",
                        "type": "string",
                        "description": "Only include cruises departing on or after this date (YYYY-MM-DD). Carnival filters by month."
                    },
                    "departureDateTo": {
                        "title": "Departure date to",
                        "type": "string",
                        "description": "Only include cruises departing on or before this date (YYYY-MM-DD). Carnival filters by month."
                    },
                    "specials": {
                        "title": "Special collections",
                        "type": "array",
                        "description": "Filter by a curated Carnival collection.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "J",
                                "CARNAVAL",
                                "CARNIVAL55",
                                "ECLIPSE"
                            ],
                            "enumTitles": [
                                "Carnival Journeys",
                                "Caribbean Carnaval",
                                "Carnival's 55th Birthday",
                                "Solar Eclipse Cruising"
                            ]
                        }
                    },
                    "maxPrice": {
                        "title": "Maximum price",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Only include cruises with a lead price at or below this value (per person, in the chosen currency)."
                    },
                    "numAdults": {
                        "title": "Adults",
                        "minimum": 1,
                        "maximum": 4,
                        "type": "integer",
                        "description": "Number of adults the prices are calculated for.",
                        "default": 2
                    },
                    "military": {
                        "title": "Military rates",
                        "type": "boolean",
                        "description": "Apply military rates where available.",
                        "default": false
                    },
                    "senior": {
                        "title": "Senior rates",
                        "type": "boolean",
                        "description": "Apply senior (55+) rates where available.",
                        "default": false
                    },
                    "pastGuest": {
                        "title": "Past guest (VIFP) rates",
                        "type": "boolean",
                        "description": "Apply past-guest (VIFP) rates where available.",
                        "default": false
                    },
                    "sort": {
                        "title": "Sort by",
                        "enum": [
                            "fromprice",
                            "recommended"
                        ],
                        "type": "string",
                        "description": "Order the results returned by the Carnival search.",
                        "default": "fromprice"
                    },
                    "includeSailings": {
                        "title": "Include full sailing & schedule details",
                        "type": "boolean",
                        "description": "Embed the lead sailing's day-by-day schedule and every sailing date with its 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"
                    },
                    "locality": {
                        "title": "Locality",
                        "type": "string",
                        "description": "Carnival market locality code (1 = US). Advanced; usually leave as default.",
                        "default": "1"
                    },
                    "baseUrl": {
                        "title": "Base URL",
                        "type": "string",
                        "description": "Storefront base URL.",
                        "default": "https://www.carnival.com"
                    },
                    "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
