| Filter by destination, departure port, ship, port of call, length, and sail dates, add senior, military, police/firefighter, or state-resident rates, and get one clean row per dated sailing with Interior, Ocean View, Balcony, and Suite prices side by side. |
PCC (Perfect Day at CocoCay), NAS (Nassau), CZM (Cozumel). Codes appear in the portCode field of rcPortsDetailedInfo.
## `minNights` (type: `integer`):
Only sailings of at least this many nights.
## `maxNights` (type: `integer`):
Only sailings of at most this many nights.
## `sailDateFrom` (type: `string`):
Only sailings departing on or after this date (YYYY-MM-DD).
## `sailDateTo` (type: `string`):
Only sailings departing on or before this date (YYYY-MM-DD).
## `sortBy` (type: `string`):
Order of cruise groups, as on Royal Caribbean's search page. Sailings of one cruise group stay together.
## `seniorRate` (type: `boolean`):
Show prices with senior (55+) rates applied, like ticking that box on Royal Caribbean's cruise search.
## `militaryRate` (type: `boolean`):
Show prices with military rates applied.
## `policeRate` (type: `boolean`):
Show prices with police and firefighter rates applied.
## `residentState` (type: `string`):
Show prices with resident rates for a US state, like the state-of-residence option on Royal Caribbean's US site.
## `nameLanguage` (type: `string`):
English keeps port and destination names identical in every market (e.g. 'Athens (Piraeus)'). Market language keeps the names Royal Caribbean shows in that market (e.g. 'Athen (PirΓ€us)' in Germany). Port codes are always included.
## `maxRequestRetries` (type: `integer`):
Retries for a failed request.
## `minConcurrency` (type: `integer`):
Parallel requests to start with. Grows toward Max concurrency while requests succeed.
## `maxConcurrency` (type: `integer`):
Upper limit of parallel requests.
## `requestHandlerTimeoutSecs` (type: `integer`):
Timeout for one request.
## `useApifyProxy` (type: `boolean`):
Send requests through Apify Proxy. Not needed in most runs; turn it on if requests get blocked.
## `proxyUrl` (type: `string`):
Your own proxy, e.g. http://user:pass@host:port. Takes priority over Apify Proxy.
## `apifyProxyGroups` (type: `array`):
Apify Proxy groups used when Use Apify Proxy is on.
## `apifyProxyCountryCode` (type: `string`):
Two-letter proxy country (e.g. US, GB, AU). Leave empty to match the market automatically.
## Actor input object example
```json
{
"region": "USA",
"maxRows": 100,
"destinations": [],
"departurePorts": [],
"ships": [],
"portsOfCall": [],
"sortBy": "RECOMMENDED",
"seniorRate": false,
"militaryRate": false,
"policeRate": false,
"nameLanguage": "english",
"maxRequestRetries": 5,
"minConcurrency": 1,
"maxConcurrency": 10,
"requestHandlerTimeoutSecs": 30,
"useApifyProxy": false,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
```
# Actor output Schema
## `dataset` (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 '