Celebrity Cruises Scraper - Complete Cruise Data Extractor

Celebrity Cruises Scraper

This scraper extracts cruise data from Celebrity Cruises' GraphQL API and outputs structured cruise information.

Platform Compatibility

• Output Format: Structured cruise data with pricing and itinerary information
• Database Schema: Uses standard cruise database tables (cruises, cruise_price_history, scraper_runs)
• Locale Format: Supports regional markets:
  • celebrity-cruises-en_US (USA market)
  • celebrity-cruises-en_GB (UK market)
• Webhook Handler: Compatible with standard webhook processing

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)

Each region uses the appropriate domain path prefix, currency, language headers, and office codes that match Celebrity Cruises' actual API requirements.

Regional API Compatibility

The scraper automatically configures headers to match Celebrity Cruises' regional APIs:

USA: celebritycruises.com with English headers, office MIA GBR: celebritycruises.com/gb with language: en-gb, office LON

Features

Standard Cruise Data Output

• Complete cruise information including itineraries, pricing, and ship details
• Pricing tiers for different stateroom categories (Interior, Outside, Balcony, Concierge, Aqua, Suite)
• Service charges included in base pricing (Celebrity's pricing model)

Celebrity-Specific Enhancements

Additional optional fields prefixed with cel:

• celStateroomClasses - Detailed cabin information with amenities
• celHighlights - Visual highlights/badges (promotions like "75% OFF 2ND GUEST")
• celPortsDetailedInfo - Enhanced port info with arrival/departure times
• pricing_tiers.tiers - Structured pricing by cabin code (I, O, B, C, A, D)

Stateroom Class Codes

• I - Interior
• O - Outside/Oceanview
• B - Balcony
• C - Concierge Class
• A - AquaClass
• D - Suite/Deluxe

Database Storage

Data is stored with company separation:

• company: celebrity-cruises
• locale: en_US, en_GB
• platform: celebrity-cruises-en_US, celebrity-cruises-en_GB

This maintains clear separation of data by cruise line and regional market.

Destination Codes

Available destination filters:

• ALCAN - Alaska
• CARIB - Caribbean
• GALAP - Galapagos
• EUROP - Europe
• BAHAM - Bahamas
• FAR.E - Asia
• AUSTL - Australia and New Zealand
• T.ATL - Transatlantic
• SAMER - South America
• BERMU - Bermuda
• T.PAN - Panama Canal
• HAWAI - Hawaii
• ATLCO - Canada
• TPACI - Transpacific
• ISLAN - Repositioning
• PACIF - Pacific Coastal
• SOPAC - South Pacific

Example Usage

Single destination (Caribbean cruises from USA):

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

Multiple destinations (Europe and Caribbean from UK):

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

All major destinations from USA:

{
  "region": "USA",
  "maxRows": 200,
  "destinations": ["CARIB", "EUROP", "ALCAN", "BAHAM"],
  "useApifyProxy": true
}

Anti-Bot Measures

Celebrity Cruises has moderate anti-bot protection. The scraper implements:

• Progressive request delays (1-5 seconds between requests)
• Session ID generation for request consistency
• Automatic proxy rotation on rate limiting (403/429 errors)
• Exponential backoff on failed requests

Recommended: Use residential proxies (RESIDENTIAL group) for best results.