Costa Cruises Scraper

A powerful and reliable web scraper for Costa Cruises, built with TypeScript and Apify. This actor allows you to extract detailed cruise information from Costa Cruises' official websites across multiple regions.

Features

• Multi-region support (Italy, USA, Germany, Austria, UK)
• Detailed cruise information extraction
• Flexible destination filtering
• Configurable sorting options
• Proxy support (Apify Proxy or custom)
• Robust error handling
• TypeScript implementation for type safety

Input

The scraper accepts the following input parameters:

{
  "region": "it_IT",
  "maxRows": 500,
  "sortBy": "departDate asc",
  "destinations": ["ME", "CA", "PG", "NO", "PN", "TR", "PE", "PA", "CI", "RW", "SA"],
  "maxRequestRetries": 5,
  "minConcurrency": 1,
  "maxConcurrency": 10,
  "requestHandlerTimeoutSecs": 30,
  "useApifyProxy": false,
  "proxyUrl": ""
}

Input Parameters

Parameter	Type	Description	Default
region	string	Region/locale of Costa website	"it_IT"
maxRows	number	Maximum number of cruise results	500
sortBy	string	Sorting criteria for results	"departDate asc"
destinations	string[]	Array of destination codes to filter	[]
maxRequestRetries	number	Maximum retry attempts for failed requests	5
minConcurrency	number	Minimum concurrent requests	1
maxConcurrency	number	Maximum concurrent requests	10
requestHandlerTimeoutSecs	number	Request timeout in seconds	30
useApifyProxy	boolean	Whether to use Apify Proxy	false
proxyUrl	string	Custom proxy URL	""

Supported Regions

The scraper supports multiple regional versions of the Costa Cruises website:

Region	Domain	Currency
it_IT	costacrociere.it	EUR
en_US	costacruises.com	USD
de_DE	costakreuzfahrten.de	EUR
de_AT	costakreuzfahrten.at	EUR
en_GB	costacruises.co.uk	GBP

Destination Codes

Code	Destination
ME	Mediterraneo
CA	Caraibi
PG	Dubai ed Emirati Arabi
NO	Nord Europa
PN	Tra Mediterraneo ed Europa del Nord
TR	Transoceaniche
PE	Tra Mediterraneo ed Emirati Arabi
PA	Asia
CI	Isole Canarie
RW	Giro del Mondo
SA	Sud America

Sorting Options

• departDate asc - Sort by departure date (ascending)
• departDate desc - Sort by departure date (descending)
• price asc - Sort by price (ascending)
• price desc - Sort by price (descending)
• duration asc - Sort by duration (ascending)
• duration desc - Sort by duration (descending)

Proxy Configuration

The scraper supports two proxy options:

1. Apify Proxy

{
    "useApifyProxy": true
}

2. Custom Proxy

{
    "proxyUrl": "http://user:pass@proxy.example.com:8080"
}

Output

The scraper outputs detailed cruise information in the following format:

{
  "cruiseId": "string",
  "itineraryId": "string",
  "title": "string",
  "description": "string",
  "itineraryImage": "string",
  "itineraryImageAlt": "string",
  "itineraryURL": "string",
  "nightTitle": "string",
  "vaxRule": "string",
  "virtualItineraryCode": "string",
  "masterCruise": "string",
  "shipName": "string",
  "shipId": "string",
  "shipVersion": "string",
  "departurePort": {
    "name": "string",
    "code": "string"
  },
  "arrivalPort": {
    "name": "string",
    "code": "string"
  },
  "departureDate": "ISO date string",
  "arrivalDate": "ISO date string",
  "duration": "string",
  "price": {
    "amount": "string",
    "currency": "string"
  },
  "portsOfCall": [
    {
      "name": "string",
      "day": "string"
    }
  ],
  "visitingCountries": "string",
  "availabilityStatus": "string",
  "destinationNames": ["string"],
  "destinationIds": ["string"],
  "documents": ["string"],
  "serviceCharges": [
    {
      "currency": "string",
      "adultAmount": "string",
      "childAmount": "string",
      "totalAdultAmount": "string",
      "totalChildAmount": "string"
    }
  ],
  "portCharges": {
    "childAmount": "string",
    "infantAmount": "string",
    "adultAmount": "string",
    "currencyCode": "string"
  },
  "portsList": [{}],
  "portImages": ["string"],
  "tileImages": ["string"],
  "portImagesCouple": ["string"],
  "portImagesFamily": ["string"],
  "portImagesDefault": ["string"],
  "seaDestinations": ["string"]
}

Output Fields Description

Field	Description
cruiseId	Unique identifier for the cruise
itineraryId	Unique identifier for the itinerary
title	Cruise title
description	Cruise description
itineraryImage	URL of the itinerary image
itineraryImageAlt	Alt text for the itinerary image
itineraryURL	URL of the itinerary
nightTitle	Title of the night
vaxRule	Vaccination requirements
virtualItineraryCode	Code for virtual itinerary
masterCruise	Master cruise identifier
shipName	Name of the cruise ship
shipId	Identifier for the ship
shipVersion	Version of the ship
departurePort	Port of departure with name and code
arrivalPort	Port of arrival with name and code
departureDate	Date of departure in ISO format
arrivalDate	Date of arrival in ISO format
duration	Duration of the cruise in days
price	Price information with amount and currency
portsOfCall	List of ports visited during the cruise
visitingCountries	Countries visited during the cruise
availabilityStatus	Availability status of the cruise
destinationNames	Names of destinations
destinationIds	IDs of destinations
documents	Required documents
serviceCharges	Service charges information
portCharges	Port charges information
portsList	Detailed list of ports
portImages	Images of ports
tileImages	Tile images for the cruise
portImagesCouple	Port images for couples
portImagesFamily	Port images for families
portImagesDefault	Default port images
seaDestinations	Sea destinations