{ "openapi": "3.0.1", "info": { "title": "Royal Caribbean Scraper - Complete Cruise Data Extractor", "description": "Royal Caribbean cruise pricing API - 6 markets with per-cabin pricing, discount tracking, and 32 departure ports. Extract sailings, itineraries, and direct booking links. Ideal for travel agencies, comparison sites, and affiliate marketers. ✅ Apify/custom proxy support.", "version": "0.0", "x-build-id": "2eSgktTFiS1cvTEUq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sercul~royal-caribbean/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sercul-royal-caribbean", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sercul~royal-caribbean/runs": { "post": { "operationId": "runs-sync-sercul-royal-caribbean", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sercul~royal-caribbean/run-sync": { "post": { "operationId": "run-sync-sercul-royal-caribbean", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "region" ], "properties": { "region": { "title": "Region", "enum": [ "USA", "GBR", "AUS", "ITA", "DEU", "NLD" ], "type": "string", "description": "Region/country for Royal Caribbean website to scrape", "default": "USA" }, "maxRows": { "title": "Maximum Rows", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of cruise results to fetch", "default": 500 }, "departurePorts": { "title": "Departure Ports", "type": "array", "description": "Filter cruises by departure port codes as returned by the RC API. Leave empty to include all ports.", "items": { "type": "string", "enum": [ "MIA", "FLL", "PCN", "TPA", "GAL", "MSY", "SJU", "BOS", "BYE", "BWI", "SEA", "LAX", "SAN", "HNL", "STH", "BCN", "ROM", "BLQ", "TRS", "ATH", "CTG", "LIS", "SYD", "BNE", "SIN", "HKG", "BAO", "YOK", "YVR", "SWD", "ONX", "CPT" ], "enumTitles": [ "Miami, FL", "Fort Lauderdale, FL", "Port Canaveral, FL", "Tampa, FL", "Galveston, TX", "New Orleans, LA", "San Juan, PR", "Boston, MA", "New York, NY", "Baltimore, MD", "Seattle, WA", "Los Angeles, CA", "San Diego, CA", "Honolulu, HI", "Southampton, UK", "Barcelona, Spain", "Rome (Civitavecchia), Italy", "Venice (Ravenna), Italy", "Trieste, Italy", "Athens (Piraeus), Greece", "Cartagena, Spain", "Lisbon, Portugal", "Sydney, Australia", "Brisbane, Australia", "Singapore", "Hong Kong, China", "Shanghai, China", "Tokyo (Yokohama), Japan", "Vancouver, Canada", "Seward, AK", "Colon, Panama", "Cape Town, South Africa" ] } }, "destinations": { "title": "Destinations", "type": "array", "description": "Filter cruises by destination codes", "items": { "type": "string", "enum": [ "ALASK", "ALCAN", "ATLCO", "AUSTL", "BAHAM", "BERMU", "SOPAC", "CARIB", "EUROP", "FAR.E", "HAWAI", "ISLAN", "MEXCO", "NORDI", "T.ATL", "T.PAN", "TPACI", "TRANS", "ASIA", "DUBAI", "WORLD" ], "enumTitles": [ "Alaska", "Alaska (Alternative)", "Atlantic Coast", "Australia", "Bahamas", "Bermuda", "South Pacific", "Caribbean", "Europe/Mediterranean", "Far East", "Hawaii", "Islands", "Mexico", "Nordic", "Transatlantic", "Panama Canal", "Transpacific", "Transatlantic (Alternative)", "Asia", "Dubai & UAE", "World Cruise" ] } }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of retries for failed requests", "default": 5 }, "minConcurrency": { "title": "Min Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Minimum number of concurrent requests", "default": 1 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of concurrent requests", "default": 10 }, "requestHandlerTimeoutSecs": { "title": "Request Handler Timeout (seconds)", "minimum": 10, "maximum": 300, "type": "integer", "description": "Timeout for request handlers in seconds", "default": 30 }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Whether to use Apify Proxy for requests", "default": false }, "proxyUrl": { "title": "Custom Proxy URL", "type": "string", "description": "Custom proxy URL (if not using Apify Proxy). Format: http://user:pass@proxy.com:port" }, "apifyProxyGroups": { "title": "Apify Proxy Groups", "type": "array", "description": "Proxy groups to use with Apify Proxy (e.g., RESIDENTIAL, DATACENTER)", "items": { "type": "string" }, "default": [ "RESIDENTIAL" ] }, "apifyProxyCountryCode": { "title": "Apify Proxy Country Code", "type": "string", "description": "Country code for Apify Proxy geo-targeting (e.g., US, GB, AU, IT, DE, NL). If not set, will auto-match to region." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }