search_bookables

{
  "type": "object",
  "properties": {
    "sort": {
      "enum": [
        "relevance",
        "price_asc",
        "price_desc",
        "beds_desc",
        "name_asc"
      ],
      "type": "string",
      "description": "Sort order. Default \"relevance\"."
    },
    "neLat": {
      "type": "number",
      "description": "BOUNDS MODE: Northeast latitude"
    },
    "neLng": {
      "type": "number",
      "description": "BOUNDS MODE: Northeast longitude"
    },
    "swLat": {
      "type": "number",
      "description": "BOUNDS MODE: Southwest latitude"
    },
    "swLng": {
      "type": "number",
      "description": "BOUNDS MODE: Southwest longitude"
    },
    "guests": {
      "type": "number",
      "description": "Number of guests"
    },
    "offset": {
      "type": "number",
      "description": "Pagination offset. Default 0."
    },
    "region": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by state/region (e.g., [\"Vermont\"]). Case-insensitive."
    },
    "sleeps": {
      "type": "number",
      "description": "Minimum sleeping capacity"
    },
    "country": {
      "type": "string",
      "description": "Filter by ISO alpha-2 country code (e.g., \"US\")"
    },
    "feature": {
      "type": "string",
      "description": "Soft ranking signal — boost properties with a guest-confirmed feature (e.g., \"mountain_views\", \"spotless_clean\", \"hot_tub\", \"cozy\", \"beachfront\"). Does NOT hard-filter."
    },
    "nearLat": {
      "type": "number",
      "description": "POINT MODE: Latitude to search near"
    },
    "nearLng": {
      "type": "number",
      "description": "POINT MODE: Longitude"
    },
    "persona": {
      "type": "string",
      "description": "Soft ranking signal — boost properties popular with a guest persona (e.g., \"hiking\", \"romantic\", \"young_family\", \"pet_owners\", \"fishing\", \"luxury\"). Does NOT hard-filter."
    },
    "bedrooms": {
      "type": "number",
      "description": "Minimum bedrooms needed"
    },
    "locality": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by city/town name (e.g., [\"Stowe\"], [\"Seaside\", \"Cannon Beach\"]). Case-insensitive."
    },
    "nearUnit": {
      "enum": [
        "miles",
        "kilometers"
      ],
      "type": "string",
      "description": "Default \"miles\"."
    },
    "nearRadius": {
      "type": "number",
      "description": "POINT MODE: Max distance. Default 25."
    },
    "dateWindows": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "checkIn",
          "checkOut"
        ],
        "properties": {
          "checkIn": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "checkOut": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          }
        }
      },
      "maxItems": 5,
      "description": "Up to 5 date windows to check availability and pricing across. Each window returns per-property availability. Omit for browse mode — browse results carry the nightly anchor \"from\" price only, never a dated total."
    },
    "petsRequired": {
      "type": "boolean",
      "description": "Pet-friendly only"
    },
    "maxProperties": {
      "type": "number",
      "description": "Max results. Default 20."
    },
    "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."
    },
    "semanticFilters": {
      "type": "object",
      "properties": {
        "required": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 10,
          "description": "Natural-language must-haves. Every returned property must have listing, policy, amenity, or review evidence for each criterion; never infer a match from missing data."
        },
        "requested": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 10,
          "description": "Natural-language preferences used as soft ranking signals. A property may still be returned when one or more requested preferences are not evidenced."
        }
      },
      "description": "Reserved optional evidence-backed semantic criteria that complement the explicit location, date, capacity, pet, property-type, and budget filters. Put true must-haves in `required`; put preferences that should improve ranking without excluding otherwise valid stays in `requested`. Until server instructions announce that semantic matching is enabled, omit this field.",
      "additionalProperties": false
    },
    "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."
    }
  }
}