Raw schema
{
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "Destination name (fuzzy matched)"
},
"search": {
"type": "string",
"description": "Boat NAME only (\"Papillon\", \"Ziphius\") โ the name an operator gave one hull, matched as a WHOLE WORD, so send the name the guest said and not a shortening of it. NEVER a make or a model: both go in `makemodel`, a model on its own included (\"Oceanis 46\")."
},
"boat_type": {
"type": "string",
"enum": [
"sailboat",
"catamaran",
"motorboat",
"gulet",
"yacht",
"rib",
"other"
]
},
"makemodel": {
"type": "string",
"description": "Make and/or model, plain text, exactly as the guest said it: \"Bali 4.2\", \"Fountaine Pajot\", \"FP 41\", \"Lagoon\", \"Oceanis 46\". Make alone is fine and so is a MODEL alone. Do not split it, do not add punctuation, do not expand acronyms."
},
"guests": {
"type": "integer",
"description": "Number of guests"
},
"date_from": {
"type": "string",
"description": "Start date YYYY-MM-DD"
},
"date_to": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"price_min": {
"type": "number",
"description": "Min price per day for the boat in EUR, all fees in โ a boat's WEEKLY list figure: a week's grand total (charter, every required fee now or at pickup, the 45 EUR platform fee, our discounts; deposits never) at max guests รท its days. A dated row's `list_price.per_day` is its own stay's and may differ"
},
"price_max": {
"type": "number",
"description": "Max price per day for the boat in EUR, all fees in โ a boat's WEEKLY list figure: a week's grand total (charter, every required fee now or at pickup, the 45 EUR platform fee, our discounts; deposits never) at max guests รท its days; a dated row's `list_price.per_day` is its own stay's and may differ. Use ONLY for an explicit per-day cap; for a whole-trip/weekly budget use total_max instead."
},
"total_max": {
"type": "number",
"description": "Max grand total for the stay in EUR (the charter, every required fee now or at pickup and the flat 45 EUR platform fee; deposits never included): screened on the total `price_summary` states (`list_price.total`: the boat page's Total for the stay it names, for the `guests` given, else max guests); a month-wide range on `per_day` ร days at max guests. Use this whenever the guest gives a total or per-week budget, e.g. \"under โฌ5000 for the week\". Needs dates to apply."
},
"cabins": {
"type": "integer",
"description": "Minimum number of guest cabins (crew cabins are not counted)"
},
"length_min": {
"type": "integer",
"description": "Minimum boat length in feet"
},
"year_min": {
"type": "integer",
"description": "Minimum build year"
},
"features": {
"type": "array",
"items": {
"type": "string",
"enum": [
"air_conditioning",
"heating",
"hot_water",
"generator",
"inverter",
"solar_panels",
"watermaker",
"wifi",
"deck_shower",
"fridge",
"cooler",
"freezer",
"ice_maker",
"oven",
"microwave",
"dishwasher",
"washing_machine",
"coffee_machine",
"electric_toilet",
"toilet",
"tv",
"sound_system",
"autopilot",
"chartplotter",
"radar",
"ais",
"bow_thruster",
"stern_thruster",
"electric_windlass",
"dinghy",
"davits",
"outboard",
"bimini",
"sprayhood",
"teak_deck",
"gangway",
"flybridge",
"bathing_platform",
"jacuzzi",
"underwater_lights",
"stabilizers",
"railing_net",
"lazy_bag",
"spinnaker",
"gennaker",
"electric_winch",
"snorkeling_gear",
"diving_equipment",
"sup",
"kayak",
"fishing_gear",
"water_toys",
"seabob",
"e_foil",
"windsurf",
"bikes",
"jet_ski",
"bbq",
"dinghy:hard_bottom",
"dinghy:hypalon",
"dinghy:console",
"dinghy:large",
"outboard:electric",
"outboard:hp_15_plus",
"tv:smart",
"tv:satellite",
"sound_system:bluetooth",
"fridge:flybridge"
]
},
"description": "Equipment/amenity filters โ boats must have ALL listed. Namespaced slugs (\"dinghy:hypalon\") are subtypes that already imply the parent โ do not also list the parent. Map user phrasing to slugs: \"ac\"/\"a/c\"/\"air con\"/\"aircon\"/\"klima\" โ air_conditioning, \"heater\"/\"cabin heating\"/\"webasto\" โ heating, \"warm water\"/\"boiler\"/\"water heater\" โ hot_water, \"genset\"/\"power generator\" โ generator, \"power inverter\"/\"12v to 220v\" โ inverter, \"solar power\"/\"solar\" โ solar_panels, \"water maker\"/\"desalinator\" โ watermaker, \"wi-fi\"/\"internet\"/\"wireless internet\"/\"4g\" โ wifi, \"cockpit shower\"/\"outdoor shower\"/\"transom shower\" โ deck_shower, \"refrigerator\"/\"icebox\" โ fridge, \"ice chest\"/\"cool box\" โ cooler, \"deep freeze\" โ freezer, \"icemaker\" โ ice_maker, \"stove\"/\"cooker\"/\"hob\"/\"kitchen\" โ oven, \"micro wave\" โ microwave, \"dish washer\" โ dishwasher, \"washer\"/\"dryer\"/\"laundry\" โ washing_machine, \"coffee maker\"/\"espresso machine\"/\"nespresso\" โ coffee_machine, \"electric wc\"/\"electric heads\" โ electric_toilet, \"wc\"/\"restroom\"/\"bathroom\" โ toilet, \"television\"/\"screen\" โ tv, \"speakers\"/\"stereo\"/\"music\" โ sound_system, \"auto pilot\" โ autopilot, \"gps\"/\"chart plotter\"/\"plotter\"/\"navigation\" โ chartplotter, \"ais transponder\" โ ais, \"bowthruster\" โ bow_thruster, \"electric anchor winch\" โ electric_windlass, \"tender\"/\"zodiac\" โ dinghy, \"dinghy davits\" โ davits, \"outboard motor\" โ outboard, \"shade\"/\"canopy\"/\"sun awning\" โ bimini, \"spray hood\" โ sprayhood, \"teak cockpit\" โ teak_deck, \"passerelle\" โ gangway, \"fly bridge\" โ flybridge, \"swim platform\"/\"diving platform\" โ bathing_platform, \"hot tub\"/\"whirlpool\"/\"swimming pool\" โ jacuzzi, \"gyro stabilizer\"/\"seakeeper\" โ stabilizers, \"child safety net\"/\"lifeline net\" โ railing_net, \"lazyjack\"/\"lazybag\"/\"stack pack\" โ lazy_bag, \"code zero\" โ gennaker, \"e-winch\" โ electric_winch, \"snorkel\"/\"masks and fins\" โ snorkeling_gear, \"scuba gear\"/\"dive gear\" โ diving_equipment, \"paddleboard\"/\"paddle board\" โ sup, \"canoe\" โ kayak, \"fishing equipment\"/\"rods\" โ fishing_gear, \"towables\"/\"wakeboard\"/\"water skis\"/\"tubes\" โ water_toys, \"underwater scooter\" โ seabob, \"efoil\"/\"electric foil\"/\"fliteboard\"/\"wing foil\" โ e_foil, \"windsurfing\"/\"windsurf board\" โ windsurf, \"bicycle\"/\"e-bike\"/\"electric bike\" โ bikes, \"waverunner\"/\"pwc\" โ jet_ski, \"barbecue\"/\"grill\" โ bbq, \"hard bottom dinghy\"/\"rigid dinghy\"/\"rib tender\"/\"hard bottom\" โ dinghy:hard_bottom, \"hypalon dinghy\"/\"hypalon tender\" โ dinghy:hypalon, \"console dinghy\"/\"console tender\" โ dinghy:console, \"large dinghy\"/\"big tender\" โ dinghy:large, \"electric outboard\"/\"torqeedo\" โ outboard:electric, \"15hp outboard\"/\"powerful outboard\"/\"planing outboard\" โ outboard:hp_15_plus, \"smart tv\" โ tv:smart, \"satellite tv\"/\"sat tv\" โ tv:satellite, \"bluetooth\"/\"bluetooth speakers\"/\"bluetooth sound system\" โ sound_system:bluetooth, \"fridge on flybridge\"/\"flybridge fridge\" โ fridge:flybridge."
},
"sort": {
"type": "string",
"enum": [
"best_value",
"deals",
"price_low",
"price_high",
"newest"
],
"description": "Sort order. Default: best_value (best value, available boats first). Use deals for biggest discounts first."
},
"limit": {
"type": "integer",
"default": 5,
"maximum": 25
}
},
"additionalProperties": false
}