search_active_cars

{
  "additionalProperties": false,
  "properties": {
    "active_inventory_date_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Date range to filter listings active within range (YYYYMMDD-YYYYMMDD)"
    },
    "base_ext_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base exterior color to match (comma-separated values)"
    },
    "base_exterior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base exterior color to match (comma-separated values)"
    },
    "base_int_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base interior color to match (comma-separated values)"
    },
    "base_interior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base interior color to match (comma-separated values)"
    },
    "exterior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Exterior color to match (comma-separated values)"
    },
    "interior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Interior color to match (comma-separated values)"
    },
    "body_subtype": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Body subtype to filter listings on (comma-separated values)"
    },
    "body_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their body type"
    },
    "car_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car type (new/used/certified)"
    },
    "cylinders": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of engine cylinders (e.g., 4, 6, 8)"
    },
    "doors": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of doors (e.g., 2, 4)"
    },
    "drivetrain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their drivetrain"
    },
    "engine": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their engine"
    },
    "engine_aspiration": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine Aspiration to match (comma-separated values)"
    },
    "engine_block": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine Block to match (comma-separated values)"
    },
    "engine_size": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine Size to match (comma-separated values)"
    },
    "engine_size_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine size range in format \"min-max\" (e.g., \"1.0-2\")"
    },
    "fuel_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their fuel type.\nWARNING: This field has many non-normalized values. RECOMMENDED: Use powertrain_type instead for reliable filtering, OR first call this tool with facets=\"fuel_type|0|1000\" to discover exact available values."
    },
    "make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their make"
    },
    "model": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their model"
    },
    "powertrain_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter on powertrain_type. Available values: \"Combustion\" (gas/diesel), \"HEV\" (Hybrid Electric), \"MHEV\" (Mild Hybrid), \"BEV\" (Battery Electric), \"PHEV\" (Plug-in Hybrid), \"FCEV\" (Fuel Cell Electric), \"EREV\" (Extended Range Electric).\nRECOMMENDED: Use this field instead of fuel_type for consistent and reliable filtering of vehicle power sources."
    },
    "seating_capacity": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of seats (e.g., 5, 7, 8)"
    },
    "transmission": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their transmission"
    },
    "trim": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their trim"
    },
    "vehicle_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their vehicle type"
    },
    "version": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their version"
    },
    "year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle manufacturing year (e.g., 2020, 2021)"
    },
    "year_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Year range in format \"min-max\" (e.g., \"2019-2021\")"
    },
    "carfax_1_owner": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Indicates whether car has had only one owner or not"
    },
    "carfax_clean_title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Indicates whether car has clean ownership records"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on City in which they are listed"
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on Country in which they are listed"
    },
    "latitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Latitude component of location"
    },
    "longitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Longitude component of location"
    },
    "msa_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on msa code in which they are listed"
    },
    "radius": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Radius around the search location (Unit - Miles)"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on State in which they are listed"
    },
    "zip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on ZIP around which they are listed"
    },
    "city_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "City mileage range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "highway_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Highway mileage range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "dom_180_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last 180 Days on Market range in format \"min-max\" (e.g., \"10-50\")"
    },
    "dom_active_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Cumulative days the VEHICLE has been actively listed across ALL dealers (survives dealer transfers) in format \"min-max\" (e.g., \"10-50\"). Use for total-market-exposure analysis (auction/trade evaluation); otherwise prefer dos_active_range. See STALENESS METRICS above."
    },
    "dom_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Days on Market range in format \"min-max\" (e.g., \"10-50\")"
    },
    "dos_active_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Days the listing has been active at the CURRENT dealer, in format \"min-max\" (e.g., \"10-50\"). Dealer-level staleness — DEFAULT metric for \"how long has it been for sale\" questions. See STALENESS METRICS above."
    },
    "first_seen_at_mc_days": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen at MC days range in format \"max-min\" (e.g., \"25-12\" for 12 to 25 days ago)."
    },
    "first_seen_at_mc_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen at MC date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)"
    },
    "first_seen_at_source_days": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen at source days range in format \"max-min\" (e.g., \"25-12\" for 12 to 25 days ago)."
    },
    "first_seen_at_source_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen at source date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)"
    },
    "first_seen_days": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen days range in format \"max-min\" (e.g., \"30-10\" for 10 to 30 days ago)."
    },
    "first_seen_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)"
    },
    "last_seen_days": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last seen days range in format \"max-min\" (e.g., \"3-1\" for 1 to 3 days ago)."
    },
    "last_seen_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last seen date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)"
    },
    "dedup": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, gives results with is_searchable irrespective of dealer_id/mc_website_id/source"
    },
    "exclude_certified": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean param to exclude certified cars from search results"
    },
    "exclude_dealer_ids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of dealer ids to exclude from result"
    },
    "exclude_high_value_features": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter to remove listings with specified excluded HVFs. Use facets=\"high_value_features|0|1000\" first to discover available feature names."
    },
    "exclude_make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of makes to exclude from result"
    },
    "exclude_mc_website_ids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of dealer ids to exclude from result"
    },
    "exclude_options_packages": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter to remove listings with specified excluded OPs. Use facets=\"options_packages|0|1000\" first to discover available package names."
    },
    "exclude_sources": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of sources to exclude from result"
    },
    "finance_down_payment": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range down payment in finance offers"
    },
    "finance_down_payment_per": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range down payment percentage"
    },
    "finance_emp": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range Estimated Monthly Payment(EMI)"
    },
    "finance_loan_apr": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range loans Annual Percentage Rate"
    },
    "finance_loan_term": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range finance loan term"
    },
    "include_finance": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean param to search for listings that include finance options"
    },
    "include_lease": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean param to search for listings that include leasing options"
    },
    "lease_down_payment": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range down payment in lease offers"
    },
    "lease_emp": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range lease Estimated Monthly Payment(EMI)"
    },
    "lease_term": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range lease term"
    },
    "high_value_features": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their high_value_features (intersection of provided HVFs).\nIMPORTANT: Before using this filter, first call this tool with facets=\"high_value_features|0|1000\" to get the complete list of available high_value_features and their counts. This ensures you use exact feature names as they appear in the data."
    },
    "options_packages": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their options_packages (intersection of provided OPs).\nIMPORTANT: Before using this filter, first call this tool with facets=\"options_packages|0|1000\" to get the complete list of available options packages and their counts. This ensures you use exact package names as they appear in the data."
    },
    "vin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their VIN"
    },
    "vins": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of 17 digit vins (max 10 VINs per request)"
    },
    "taxonomy_vins": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of 10 letters excerpt from 17 letter VIN"
    },
    "mm": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Make-Model concatenated string from auto-complete API"
    },
    "ymm": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Year-Make-Model concatenated string from auto-complete API"
    },
    "ymmt": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of Year|Make|Model|Trim combinations"
    },
    "match": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of Year,Make,Model,Trim fields for exact match with vins"
    },
    "in_transit": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to filter in transit vehicles"
    },
    "include_non_vin_listings": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Include non vin listings (default false)"
    },
    "include_preferred_dealer_flag": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Flag to add preferred dealers flag based on client filter score"
    },
    "include_relevant_links": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Include relevant links (default true)"
    },
    "inventory_count_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Inventory count range for total listings in dealers inventory"
    },
    "min_photo_links": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings by number of photo links within given range"
    },
    "min_photo_links_cached": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings by number of cached photo links within range"
    },
    "nodedup": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, API gives results without is_searchable (multiple listings for single vin)"
    },
    "owned": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "When true, returns listings actually owned by dealer (used with dealer_id/mc_website_id/source)"
    },
    "photo_links": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to include only listings that have photo_links"
    },
    "photo_links_cached": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to include only listings that have photo_links_cached"
    },
    "plot": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, results in around 25k coordinates with limited fields for plotting"
    },
    "preferred_dealers": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Flag to add preferred dealers flag based on client filter score"
    },
    "preferred_dealers_only": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Flag to show only preferred dealers listings"
    },
    "price_change": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Query to filter listings based on positive and negative price change"
    },
    "price_change_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Price change range in format \"min-max\" (e.g., \"10-500\")"
    },
    "price_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Price range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "msrp_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MSRP range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "miles_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Miles range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Dealer ID filter to search inventory from specific dealer"
    },
    "dealer_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Type of dealer (e.g., franchise, independent)"
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Source filter to search inventory from specific source"
    },
    "stock_no": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their stock number on lot"
    },
    "vdp_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter based on vehicle detail page URL"
    },
    "mc_website_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck website ID filter"
    },
    "mc_dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck dealer ID filter"
    },
    "mc_location_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck location ID filter"
    },
    "mc_rooftop_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck rooftop ID filter"
    },
    "mc_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck dealership group ID filter"
    },
    "mc_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck dealership group name filter"
    },
    "mc_sub_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck sub-dealership group ID filter"
    },
    "mc_sub_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck sub-dealership group name filter"
    },
    "mc_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck seller category. Values: \"Dealer\", \"Retailer\", \"Dealership Group\", \"Aggregator\", \"Marketing\", \"Financing\""
    },
    "facet_sort": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Controls sort order of facet terms:\n- count (default): Sort by frequency (highest first)\n- index: Sort alphabetically"
    },
    "facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Field facets return unique terms and their counts for categorical data, useful for building search filters and understanding inventory distribution.\nSyntax: facets=field_name|offset|limit|min_count\n- offset (default: 0): Start position for terms\n- limit (default: 20, max: 1000): Number of terms to return\n- min_count (optional): Minimum count for a term to be included\nExample: facets=make|0|60|2 returns top 60 makes with at least 2 listings each"
    },
    "range_facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of numeric fields for range facets"
    },
    "stats": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of fields for which stats need to be generated"
    },
    "sort_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Sort by field (dist|price|miles|msrp|dom|dom_180|dom_active|dos_active|highway_mpg|city_mpg|last_seen|first_seen|lease_term|lease_emp|lease_down_payment|finance_loan_term|finance_loan_apr|finance_emp|finance_down_payment|price_change_percent). For staleness sorting, default to dos_active (current dealer) over dom_active (all dealers) — see STALENESS METRICS above."
    },
    "sort_order": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "asc",
      "description": "Sort order (asc|desc)"
    },
    "rows": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 5,
      "description": "Number of results to return. For standard searches: default 5, max 50. For dealer/syndication searches (when dealer_id, mc_dealer_id, mc_location_id, or similar dealer identifiers are provided): defaults to 1500 (full inventory), max 1500."
    },
    "start": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Page number/offset to fetch results (default 0, max depends on package)"
    },
    "seller_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "dealer",
      "description": "Filter by seller type. Only 3 strict values allowed: \"dealer\" (default), \"fsbo\" (private seller), \"auction\""
    },
    "fetch_all_photos": {
      "default": false,
      "type": "boolean",
      "description": "When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links."
    },
    "include_dealer_object": {
      "default": false,
      "type": "boolean",
      "description": "When True, includes dealer object in response. Dealer object structure:\n- id (number): Unique dealer identifier\n- website (string): Dealer website URL\n- name (string): Dealer business name\n- dealer_type (string, optional): Dealer classification (franchise, independent)\n- street, city, state, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- zip (string, optional): Postal/ZIP code\n- phone (string, optional): Contact phone number\n- seller_email (string, optional): Contact email address\n- dealership_group_name (string, optional): Parent dealership group\n- msa_code (string, optional): Metropolitan Statistical Area code"
    },
    "include_mc_dealership_object": {
      "default": false,
      "type": "boolean",
      "description": "When True, includes mc_dealership object in response. McDealership object structure:\n- mc_website_id (number, optional): MarketCheck website identifier\n- mc_dealer_id (number, optional): MarketCheck dealer identifier\n- mc_location_id (number, optional): MarketCheck location identifier\n- mc_rooftop_id (number, optional): MarketCheck rooftop identifier\n- mc_dealership_group_id (number, optional): MarketCheck dealership group identifier\n- mc_dealership_group_name (string, optional): MarketCheck dealership group name\n- mc_sub_dealership_group_id (number, optional): MarketCheck sub-dealership group identifier\n- mc_sub_dealership_group_name (string, optional): MarketCheck sub-dealership group name\n- mc_category (string, optional): MarketCheck seller category. Values: \"Dealer\", \"Retailer\", \"Dealership Group\", \"Aggregator\", \"Marketing\", \"Financing\"\n- website (string, optional): Dealer website URL\n- name (string, optional): Dealer business name\n- dealer_type (string, optional): Dealer classification (franchise, independent)\n- street, city, state, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- zip (string, optional): Postal/ZIP code\n- msa_code (string, optional): Metropolitan Statistical Area code\n- phone (string, optional): Contact phone number"
    },
    "include_build_object": {
      "default": false,
      "type": "boolean",
      "description": "When True, includes build object in response. Build object structure:\n- year (number): Model year\n- make (string): Vehicle manufacturer\n- model (string, optional): Vehicle model\n- trim (string, optional): Trim level\n- version (string, optional): Specific version/variant\n- body_type (string, optional): Body style (sedan, SUV, truck, etc.)\n- vehicle_type (string, optional): Vehicle category\n- transmission (string, optional): Transmission type\n- drivetrain (string, optional): Drivetrain configuration\n- fuel_type (string, optional): Fuel type (gasoline, electric, hybrid, etc.)\n- engine (string, optional): Engine description\n- engine_size (number, optional): Engine displacement\n- engine_block (string, optional): Engine block configuration\n- doors (number, optional): Number of doors\n- cylinders (number, optional): Number of cylinders\n- made_in (string, optional): Manufacturing country\n- overall_height, overall_length, overall_width (string, optional): Vehicle dimensions\n- std_seating (string, optional): Standard seating capacity\n- highway_mpg (number, optional): Highway fuel economy\n- city_mpg (number, optional): City fuel economy\n- powertrain_type (string, optional): Powertrain classification"
    }
  },
  "type": "object"
}