Raw schema
{
"type": "object",
"properties": {
"neLat": {
"type": "number",
"description": "BOUNDS MODE: Northeast corner latitude. Required with swLat."
},
"neLng": {
"type": "number",
"description": "BOUNDS MODE: Northeast corner longitude. Required with swLat."
},
"swLat": {
"type": "number",
"description": "BOUNDS MODE: Southwest corner latitude. Use bounding box for geographic regions like coastlines, mountain ranges, lake shores, or any area that is not a single point. Example: Oregon coast → swLat=42.0, swLng=-124.8, neLat=46.3, neLng=-123.5."
},
"swLng": {
"type": "number",
"description": "BOUNDS MODE: Southwest corner longitude. Required with swLat."
},
"guests": {
"type": "number",
"description": "Number of guests"
},
"offset": {
"type": "number",
"description": "Skip this many results (for pagination / load-more). Default 0."
},
"region": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by state or region name (e.g., [\"Vermont\"], [\"Vermont\", \"New Hampshire\"]). Case-insensitive. Use this instead of bounding box when a guest asks for a specific state."
},
"sleeps": {
"type": "number",
"description": "Minimum sleeping capacity required (filters properties that sleep at least this many)"
},
"checkIn": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-in date (YYYY-MM-DD)"
},
"country": {
"type": "string",
"description": "Filter by ISO 3166-1 alpha-2 country code (e.g., \"US\"). Rarely needed since collections are typically in one country."
},
"feature": {
"type": "string",
"description": "Soft ranking signal — boost properties with a guest-confirmed feature. Does NOT hard-filter. Example values: \"mountain_views\", \"spotless_clean\", \"amazing_host\", \"cozy\", \"beachfront\", \"stocked_kitchen\", \"quiet_peaceful\"."
},
"nearLat": {
"type": "number",
"description": "POINT MODE: Latitude to search near (e.g. 35.789). Use for specific places like a town, address, or landmark. Resolve place names to coordinates before calling. For broad areas (coastlines, mountain ranges), use bounding box (swLat/neLat) instead."
},
"nearLng": {
"type": "number",
"description": "POINT MODE: Longitude to search near (e.g. -83.534). Required when nearLat is provided."
},
"persona": {
"type": "string",
"description": "Soft ranking signal — boost properties popular with a guest persona. Does NOT hard-filter. Example values: \"hiking\", \"young_family\", \"romantic\", \"pet_owners\", \"fishing\", \"honeymoon\", \"luxury\", \"foodie\"."
},
"bedrooms": {
"type": "number",
"description": "Minimum bedrooms needed"
},
"checkOut": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Check-out date (YYYY-MM-DD)"
},
"locality": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by city or town name (e.g., [\"Stowe\"], [\"Seaside\", \"Cannon Beach\"]). Case-insensitive. Use instead of geo when a guest asks for a specific town."
},
"nearUnit": {
"enum": [
"miles",
"kilometers"
],
"type": "string",
"description": "Unit for nearRadius and distance values. Default \"miles\"."
},
"nearRadius": {
"type": "number",
"description": "POINT MODE: Max distance from the nearLat/nearLng point in nearUnit. Default 25 miles. Use 50+ for broad areas."
},
"preferences": {
"type": "string",
"description": "Free text preferences (e.g., \"hot tub, mountain view\")"
},
"petsRequired": {
"type": "boolean",
"description": "Whether guest needs pet-friendly property"
},
"maxProperties": {
"type": "number",
"description": "Max property picks to return. Default 5."
},
"propertySlugs": {
"type": "array",
"items": {
"type": "string"
},
"description": "REPRICE / REHYDRATE mode (the carousel widget's date-change refresh). When set, return EXACTLY these properties re-priced for the dates, in this order — dropping any now unavailable for the dates and backfilling with the next-best similar available properties so the set keeps its size (\"same or slightly expanded\"). Lets a curated/merged carousel re-price across new dates without re-searching. Overrides offset/limit pagination."
},
"propertyTypes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Property type(s). The coarse family (house vs apartment) is the only hard filter; a specific subtype (e.g. \"cabin\", \"a-frame\") returns its whole family with that subtype boosted — cross-manager interleaving may still rank other family members above it; never zero results."
},
"budgetMaxPerNight": {
"type": "number",
"description": "Max nightly budget in major currency units"
},
"collections": {
"type": "array",
"items": {
"type": "string"
},
"description": "Collection slug(s) — each a `collection_id` from list_collections. For search_bookables and discover_collections: OMIT to span the whole network, pass one to scope to a single manager, or several to compare across managers. For build_bookable_carousel: pass the collection_id(s) your chosen properties belong to — one, or several when the picks span managers. Every other tool operates on a single collection — pass exactly ONE."
}
}
}