# Royal Caribbean — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and compare Royal Caribbean cruises by destination, ship, itinerary, and price. Access detailed sailing information including port schedules, voyage durations, and fares across all global routes and departure dates.

**Category:** Travel | **Website:** [royalcaribbean.com/](https://royalcaribbean.com/) | **Docs:** [parse.bot/marketplace/d27a16ca-69d9-4a67-89a3-8ce7c08b26b5/royalcaribbean-com-api](https://parse.bot/marketplace/d27a16ca-69d9-4a67-89a3-8ce7c08b26b5/royalcaribbean-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-royalcaribbean-com-api-d27a16ca/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_asia_pacific_world_cruise

Search cruises across Far East, South Pacific, and Transpacific destinations, returning detailed itinerary and pricing data for all matching sailings. Fetches search results for these three destinations then enriches each match with full itinerary details including ports and ship info. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalcaribbean-com-api-d27a16ca/get_asia_pacific_world_cruise \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_cruise_details

Get detailed information for a specific cruise itinerary, including full port-by-port itinerary with descriptions, ship details, onboard experiences, images, and pricing. Requires a package code and sail date obtained from search_cruises results (encoded in sailings[*].id as 'packageCode_sailDate').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `package_code` | string | Yes | Itinerary package code from search_cruises results. Found in masterSailing.itinerary.code or as the prefix of sailings[*].id before the underscore (e.g. 'FR05W655'). |
| `sail_date` | string | Yes | Sailing date in ISO format YYYY-MM-DD. Found as the suffix of sailings[*].id after the underscore (e.g. '2026-08-31'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalcaribbean-com-api-d27a16ca/get_cruise_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"package_code":"<string>","sail_date":"<string>"}'
```

### search_cruises

Search for cruises with optional filters for destination, ship, and number of nights. Returns paginated results including cruise IDs, itinerary names, ship details, lowest prices, and available sailing dates. Pagination is manual via skip/limit. Each cruise includes a list of sailing IDs that encode the package code and sail date needed for get_cruise_details (format: 'packageCode_YYYY-MM-DD').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `destination` | string | No | Destination code to filter by (e.g. 'CARIB' for Caribbean, 'ALASK' for Alaska, 'FAR.E' for Far East, 'SOPAC' for South Pacific, 'TPACI' for Transpacific, 'EUROP' for Europe). |
| `limit` | integer | No | Maximum number of results to return per page. |
| `nights` | string | No | Number of nights to filter by. Single value (e.g. '7') or range (e.g. '5-9'). |
| `ship` | string | No | Ship code to filter by (e.g. 'FR' for Freedom of the Seas, 'AN' for Anthem of the Seas, 'QN' for Quantum of the Seas). |
| `skip` | integer | No | Number of results to skip for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-royalcaribbean-com-api-d27a16ca/search_cruises \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination":"<string>","limit":"<integer>","nights":"<string>","ship":"<string>","skip":"<integer>"}'
```