matchrv.com

{
  "type": "object",
  "properties": {
    "intent_summary": {
      "description": "One human-readable line of what the shopper asked for; shown in the page's activity feed",
      "type": "string",
      "maxLength": 200
    },
    "mode": {
      "description": "refine (default) merges into the current shared constraints; replace starts over",
      "type": "string",
      "enum": [
        "refine",
        "replace"
      ]
    },
    "clear": {
      "description": "Constraint keys to remove while refining",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "location",
          "price_max",
          "price_min",
          "rv_types",
          "condition",
          "length_max_ft",
          "length_min_ft",
          "max_weight_lbs",
          "tow_vehicle",
          "sleeps_min",
          "must_have",
          "prefer",
          "fresh_water_min_gal",
          "boondocking",
          "sort"
        ]
      }
    },
    "place": {
      "description": "Shopper location, city name (e.g. 'Tacoma')",
      "type": "string",
      "maxLength": 80
    },
    "radius_miles": {
      "description": "Search radius from place; default 150",
      "type": "number",
      "minimum": 1,
      "maximum": 3000
    },
    "price_max": {
      "description": "Hard price ceiling, USD",
      "type": "number",
      "minimum": 0,
      "maximum": 2000000
    },
    "price_min": {
      "type": "number",
      "minimum": 0,
      "maximum": 2000000
    },
    "rv_types": {
      "description": "Acceptable RV types; omit for all",
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "travel_trailer",
          "fifth_wheel",
          "toy_hauler",
          "class_a",
          "class_b",
          "class_c",
          "popup_camper",
          "truck_camper"
        ]
      }
    },
    "condition": {
      "type": "string",
      "enum": [
        "new",
        "used",
        "any"
      ]
    },
    "length_max_ft": {
      "description": "Hard max overall length, feet",
      "type": "number",
      "minimum": 8,
      "maximum": 60
    },
    "length_min_ft": {
      "type": "number",
      "minimum": 8,
      "maximum": 60
    },
    "max_weight_lbs": {
      "description": "Hard cap on unit weight (checked against GVWR when known, else dry weight, flagged)",
      "type": "number",
      "minimum": 500,
      "maximum": 60000
    },
    "tow_vehicle": {
      "description": "Shopper's tow vehicle as stated, e.g. '2024 Ford F-150' or 'F-150 rated 8,000 lbs'. Pass raw — MatchRV resolves ratings",
      "type": "string",
      "maxLength": 120
    },
    "sleeps_min": {
      "type": "integer",
      "minimum": 1,
      "maximum": 14
    },
    "must_have": {
      "description": "Hard requirements. Search recommendations require these facts to be confirmed; units with missing required data are excluded by the search-readiness gate.",
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "bunkhouse",
          "solar",
          "solar_prep",
          "lithium",
          "generator",
          "four_season",
          "outdoor_kitchen",
          "two_entry_doors"
        ]
      }
    },
    "prefer": {
      "description": "Soft preferences — affect ranking only",
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "bunkhouse",
          "solar",
          "solar_prep",
          "lithium",
          "generator",
          "four_season",
          "outdoor_kitchen",
          "two_entry_doors"
        ]
      }
    },
    "fresh_water_min_gal": {
      "type": "number",
      "minimum": 5,
      "maximum": 300
    },
    "boondocking": {
      "description": "Weight off-grid readiness (tanks, solar, generator, insulation) heavily in ranking",
      "type": "boolean"
    },
    "sort": {
      "type": "string",
      "enum": [
        "best_match",
        "price_asc",
        "price_desc",
        "distance",
        "newest_model_year"
      ]
    },
    "limit": {
      "description": "Results to return (default 5); the page shows the full list",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "additionalProperties": false
}