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: json { "region": "it_IT", // Required "maxRows": 500, "pageSize": 500, "destinations": ["ME", "CA", "PG", "NO", "PN", "TR", "PE", "PA", "CI", "RW", "SA"], "maxRequestRetries": 5, "minConcurrency": 1, "maxConcurrency": 10, "requestHandlerTimeoutSecs": 30, "batchSize": 250, "useApifyProxy": false, "proxyUrl": "" } ### Input Parameters | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | region | string | Region/locale of Costa website (required) | - | | maxRows | number | Maximum number of cruise results | 500 | | 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 | | pageSize | number | How many results to request per page | 500 | | requestHandlerTimeoutSecs | number | Request timeout in seconds | 30 | | batchSize | number | Number of items per dataset write (optimize performance) | 250 | | useApifyProxy | boolean | Whether to use Apify Proxy | false | | proxyUrl | string | Custom proxy URL | "" | Required parameter ### 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 | ## Proxy Configuration The scraper supports two proxy options: 1. Apify Proxy json { "useApifyProxy": true } 2. Custom Proxy json { "proxyUrl": "http://user:pass@proxy.example.com:8080" } ## Output The scraper outputs detailed cruise information in the following format: json { "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 |