Raw schema
{
"type": "object",
"properties": {
"destination": {
"type": "string",
"description": "Optional destination key ('antalya', 'bodrum'). Omit to search all."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Departure date, format YYYY-MM-DD (recommended β exact availability for that date)."
},
"budget_total_max": {
"type": "integer",
"description": "Max TOTAL budget in EUR for the whole party."
},
"budget_total_min": {
"type": "integer",
"description": "Optional min total, to skip too-basic offers."
},
"stars_min": {
"type": "integer",
"minimum": 1,
"maximum": 5,
"description": "Minimum hotel star rating (1-5)."
},
"board": {
"type": "string",
"description": "Board filter substring, e.g. 'all inclusive', 'ultra'."
},
"zone": {
"type": "string",
"description": "Zone/resort filter substring, e.g. 'Belek', 'Alanya', 'Lara', 'Side', 'Kemer'."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 24,
"description": "Shortlist size (default 12)."
},
"adults": {
"type": "integer",
"minimum": 1,
"maximum": 6,
"description": "Number of adults (default 2)."
},
"children_ages": {
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 17
},
"maxItems": 6,
"description": "Age of each child AT DEPARTURE (0-14 = child; 15+ is counted as an adult automatically)."
},
"nights": {
"type": "integer",
"minimum": 2,
"maximum": 21,
"description": "Trip length in nights. Omit for the standard charter length (6 nights / 7 days). Most departures also sell 3-10 nights."
},
"family_friendly": {
"type": "boolean",
"description": "true = only hotels with family facilities (kids club / kids pool / family rooms) and not adults-only."
},
"aquapark": {
"type": "boolean",
"description": "true = only hotels with an aquapark / water park."
},
"kids_club": {
"type": "boolean",
"description": "true = only hotels with a kids / mini club."
},
"adults_only": {
"type": "boolean",
"description": "true = only adults-only hotels; false = EXCLUDE adults-only hotels (use false for any party with children)."
},
"beach": {
"type": "boolean",
"description": "true = only hotels with a beach (own or nearby, per the hotel facts)."
},
"private_beach": {
"type": "boolean",
"description": "true = only hotels listing a private / own beach."
},
"spa": {
"type": "boolean",
"description": "true = only hotels with spa / Turkish bath / sauna."
},
"luxury": {
"type": "boolean",
"description": "true = only hotels tagged luxury."
}
},
"additionalProperties": false
}