Raw schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "The person's request in plain words, e.g. \"alaska in july from seattle, balcony, under $3000 for two\". Read by fixed rules; the answer says how it was understood and which words were not. Any other argument given overrides what q says."
},
"region": {
"type": "string",
"description": "Where the cruise goes: caribbean, bahamas, alaska, mexico, mediterranean, northern-europe, european-rivers, asia, repositioning, hawaii, bermuda, panama-canal, south-america, antarctica, australia, ... (every region with sailings on sale)"
},
"month": {
"type": "string",
"description": "Departure month, YYYY-MM"
},
"depart_from": {
"type": "string",
"description": "Earliest departure date, YYYY-MM-DD"
},
"depart_to": {
"type": "string",
"description": "Latest departure date, YYYY-MM-DD"
},
"from_port": {
"type": "string",
"description": "Departure port, e.g. \"Seattle\" or \"Barcelona\"; several comma-separated: \"Miami,Fort Lauderdale\""
},
"calls_at": {
"type": "string",
"description": "A port the ship must visit, e.g. \"Juneau\", \"Santorini\", \"Cozumel\""
},
"line": {
"type": "string",
"description": "Cruise line, e.g. \"Royal Caribbean\", \"NCL\", \"Princess\", \"Viking\""
},
"ship": {
"type": "string",
"description": "Ship name or part of it"
},
"tier": {
"type": "string",
"enum": [
"contemporary",
"premium",
"luxury",
"river"
]
},
"nights_min": {
"type": "integer"
},
"nights_max": {
"type": "integer"
},
"cabin": {
"type": "string",
"enum": [
"inside",
"oceanview",
"balcony",
"suite"
],
"description": "Cabin grade to price. Omit to quote balcony where sold, else the next grade."
},
"max_price_per_person": {
"type": "number",
"description": "Budget per person for the whole cruise, USD"
},
"max_price_per_night": {
"type": "number",
"description": "Budget per person per night, USD"
},
"only_below_usual": {
"type": "boolean",
"description": "Only fares measurably below their usual price"
},
"sort": {
"type": "string",
"enum": [
"best_value",
"lowest_price",
"lowest_per_night",
"soonest"
],
"default": "best_value"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10
}
}
}