Royal Caribbean Scraper - Complete Cruise Data Extractor

Royal Caribbean Scraper

This scraper extracts cruise data from Royal Caribbean's GraphQL API and outputs data in a format compatible with the Costa cruises database schema.

Platform Compatibility

• Output Format: Exactly matches Costa scraper output structure
• Database Schema: Uses same tables as Costa (cruises, cruise_price_history, scraper_runs)
• Locale Format: Uses Costa-compatible locale format:
  • royal-caribbean-en_US (USA market)
  • royal-caribbean-en_GB (UK market)
  • royal-caribbean-en_AU (Australia market)
  • royal-caribbean-it_IT (Italian market)
• Webhook Handler: Works with existing apify-webhook-handler

Configuration

Region Parameter: region is a required parameter that must be specified in every actor run.

Supported Regions

• USA - United States market (en_US locale, USD currency)
• GBR - United Kingdom market (en_GB locale, GBP currency)
• AU - Australia market (en_AU locale, AUD currency)
• ITA - Italian market (it_IT locale, EUR currency)

Each region uses the appropriate domain, currency, language headers, and office codes that match Royal Caribbean's actual API requirements.

Regional API Compatibility

The scraper automatically configures headers to match Royal Caribbean's regional APIs:

USA: royalcaribbean.com with English headers GBR: royalcaribbean.com with language: en-gb, country: GBR
Australia: royalcaribbean.com.au with English headers Italy: royalcaribbean.com with language: it, country: ITA, currency: EUR

Features

Costa-Compatible Output

• All essential fields match Costa scraper exactly
• Dynamic pricing fields follow Costa's pattern (price_USD_I, classification_USD_I, etc.)
• Service charges and port charges in expected format

Royal Caribbean-Specific Enhancements

Additional optional fields prefixed with rc:

• rcStateroomClasses - Detailed cabin information
• rcHighlights - Visual highlights/badges
• rcPortsDetailedInfo - Enhanced port info with arrival/departure times
• rcProductViewLink, rcBookingLink - Direct booking URLs
• rcItineraryImages - Additional imagery

Database Storage

Data is stored with company separation:

• company: royal-caribbean
• locale: en_US, en_GB, en_AU, it_IT (Costa-compatible format)
• platform: royal-caribbean-en_US, royal-caribbean-en_GB, etc.

This allows both Costa and Royal Caribbean data to coexist in the same database while maintaining clear separation.

Example Usage

Single destination (Mediterranean cruises from Italy):

{
  "region": "ITA",
  "maxRows": 100,
  "destinations": ["EUROP"],
  "useApifyProxy": true
}

Multiple destinations (Caribbean and Europe from UK):

{
  "region": "GBR", 
  "maxRows": 100,
  "destinations": ["CARIB", "EUROP"],
  "useApifyProxy": true
}

All major destinations (global cruises 12+ nights):

{
  "region": "ITA",
  "maxRows": 50,
  "destinations": ["ALCAN", "AUSTL", "CARIB", "EUROP", "FAR.E", "HAWAI", "ISLAN", "T.ATL", "T.PAN", "TPACI"],
  "useApifyProxy": true
}

Popular USA destinations (matching Royal Caribbean's search patterns):

{
  "region": "USA",
  "maxRows": 20,
  "destinations": ["BAHAM", "BERMU", "CARIB", "EUROP", "HAWAI", "MEXCO", "T.PAN"],
  "useApifyProxy": true
}