Servers Playground How we check Add a server Log in

MarketCheck API

Working · 3.4 s

com.marketcheck/apiv1.2.0 Domain verified

MarketCheck automotive data: search US/UK listings, predict prices, decode VINs, market history.

Commerce

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://developers.marketcheck.com/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

decode_vin_neovin Read-only

Get vehicle specifications from NeoVIN decoder by VIN. Get the basic information on specifications for a car identified by a valid VIN from NeoVIN decoder. This provides detailed vehicle specifications including trim, engine, transmission, features, options, MSRP information, and more comprehensive data than standard VIN decoders.

vinstring, required

Vehicle Identification Number (17 characters, required)

include_genericstring

Boolean to include generic data in response (optional, default: False)

MarketCheck API MCP server | mcptry

Tools (13)

decode_vin_neovin

read-only

Argument	Type	Description
vin*	string	Vehicle Identification Number (17 characters, required)
include_generic	any	Boolean to include generic data in response (optional, default: False)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "vin"
  ],
  "properties": {
    "vin": {
      "type": "string",
      "description": "Vehicle Identification Number (17 characters, required)"
    },
    "include_generic": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to include generic data in response (optional, default: False)"
    }
  },
  "additionalProperties": false
}

get_car_history

Get a car's online listing history by VIN. The history API returns online listing history for a car identified by its VIN. History listings are sorted in the descending order of the listing date / last seen date.

read-only

Argument	Type	Description
vin*	string	Vehicle Identification Number (17 characters, required)
page	any	Page number to fetch results (default is 1, optional)
fields	any	List of fields to fetch, comma-separated (optional)
sort_order	any	Sort order - asc or desc (default is asc, optional)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "vin"
  ],
  "properties": {
    "vin": {
      "type": "string",
      "description": "Vehicle Identification Number (17 characters, required)"
    },
    "page": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Page number to fetch results (default is 1, optional)"
    },
    "fields": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of fields to fetch, comma-separated (optional)"
    },
    "sort_order": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Sort order - asc or desc (default is asc, optional)"
    }
  },
  "additionalProperties": false
}

get_server_info

Get information about the server. Returns: Server capabilities as a dict (serialized by the transport layer)

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_sold_summary

Monthly sold-vehicle statistics for US franchise and independent dealers: how many sold, at what advertised prices, how fast, where, ranked however you ask. A "sale" is inferred (a listing left a dealer site and met MarketCheck's sold rules); prices are advertised asking prices, not transaction prices. History starts January 2021 and runs through the last complete month. No auction, private-party, UK or Canada data. Required: - inventory_type: new, used, certified, or all (all pools new and used into one row; add inventory_type to ranking_dimensions to split them). There is no default. Dates: - date_from / date_to: YYYY-MM-DD; date_from is the first day of a month, date_to the last day of a month (inclusive). Send both or neither; at most one year apart. Omit both for the last complete month. A same-month year-over-year comparison (e.g. July vs July) is more than a year, so make two calls. Geography (summary_by, default state): - summary_by=national for ONE ranking of the whole country. Use it for any "in America"/"nationally" question. Never add up per-state rankings: a make only appears in a state's rows when it makes that state's top_n, so the sum undercounts. - summary_by=state or city_state for rankings within each state or city. - state / city filters take comma-separated lists (OR). There is no ZIP or metro filter. Filters (comma-separated lists are OR; text matching is case-insensitive): - dealer_type: franchise, independent, or all. - dealership_group_name: exact group name(s), e.g. "Lithia Motors Inc.". Don't guess names: look them up with search_dealerships (field mc_dealership_group_name). An unknown name returns a 422. One name contains a comma ("Americas Car-mart, Inc."), so send it alone. - source: the website the sold listing was found on, e.g. carmax.com. For one dealer (rooftop), pass its inventory_url from search_dealerships / search_dealers. Finding a dealer or dealership group (use the dealer directory, never guess): - One dealer's sales: search_dealerships (or search_dealers) by name, city, state or zip, then call this tool with source=<inventory_url>. This also works for dealers that belong to no group, which is most sales. - A whole group's sales: take mc_dealership_group_name from search_dealerships and pass it as dealership_group_name. Only about 38% of sales carry a group, so ranking by dealership_group_name leaves the rest out. - Several rooftops at once: source takes a comma-separated list of inventory_urls. - make, model, trim, body_type, body_subtype, powertrain_type (Combustion, HEV, MHEV, BEV, PHEV, FCEV, EREV), drivetrain (4WD, FWD, RWD; there is no AWD), transmission (Automatic, CVT, Manual), base_exterior_color, base_interior_color, msrp_label, fuel_type_category (ice, ev, hybrid, unknown, other). - year: model year(s), e.g. 2024 or 2020,2022. year_range: inclusive, e.g. 2020-2024, 2020- or -2024. Use year or year_range, not both. - miles_range: inclusive odometer range, e.g. 0-60000, 60000-. Ranking: - ranking_dimensions: comma-separated fields to group and rank by (default make,model,body_type). Valid: year, make, model, trim, body_type, body_subtype, drivetrain, transmission, powertrain_type, fuel_type_category, base_exterior_color, base_interior_color, msrp_label, dealership_group_name, source, inventory_type; or none for a single market total. state is not a dimension: use summary_by. - ranking_measure (default sold_count): sold_count, price_over_msrp_percentage, price_over_mc_msrp_percentage, or a dotted statistic: price.mean, price.sum, price.p50 (median price), dom_active.mean (average days on market), dom_active.p50, dos_active.mean, miles.mean, msrp.mean, and others listed in the valid-values error. - ranking_order: desc (default) or asc. - top_n: rows kept per group (per month and geography), not per response. Default 10. - limit: total rows returned, 1 to 20000 (default 20000). Check `truncated` in the response: true means the limit cut rows. Measure filters remove whole groups after the statistics are computed, leaving the numbers in the remaining rows unchanged (the vehicle filters above act on vehicles, before statistics). Each takes a number with an optional >, <, >=, <= or = prefix, e.g. ">=30": - sold_count, price_over_msrp_percentage, price_over_mc_msrp_percentage. - min_sold_count: shorthand for sold_count >= n. - measure_filters: dotted statistics, e.g. {"price.mean": ">20000", "dom_active.mean": "<45"}. average_sale_price is now price.mean, total_sale_price is price.sum, average_days_on_market is dom_active.mean. - By default measure filters apply AFTER rank and top_n (ranks can read 1, 3, 7), so a floor with the default top_n of 10 often returns no rows. Either raise top_n (e.g. 100000) or set rank_after_filters=true to filter first. - Ascending rankings: ranking_order=asc alone returns thousands of ties at the minimum (everything that sold once). Pair it with a floor, e.g. ranking_measure=dom_active.mean, ranking_order=asc, min_sold_count=30, top_n=100000. Response: `data` rows carry month, the grouping fields, rank, sold_count and nested statistics (price, miles, dom_active, dos_active, msrp, mc_msrp with count, mean and percentiles) plus price_over_msrp_percentage. `result_count`, `truncated`, `warnings` and `applied` (the defaults and date window the API actually used) come back unchanged. The service scales to zero when idle: the first call after a quiet period can take about 9 seconds. Errors: a 422 names the offending parameter and how to fix it; correct the call and retry.

predict_price_with_comparables

Predict car price along with comparable vehicles in the market. This provides predicted price, MSRP along with active set comparables to help understand market positioning and competitive pricing.

read-only

Argument	Type	Description
vin*	string	Vehicle Identification Number (17 characters, required)
zip	any	Location ZIP code (default: '50501' - Des Moines, IA)
city	any	City of the car (optional if zip provided)
miles	integer	Miles the vehicle has driven in total (default: 50,000)
state	any	State of the car (optional if zip provided)
dealer_type	string	Filter based on dealer type (independent or franchise, default: 'franchise')
is_certified	boolean	Boolean to indicate if car is certified or not (default: False)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "vin"
  ],
  "properties": {
    "vin": {
      "type": "string",
      "description": "Vehicle Identification Number (17 characters, required)"
    },
    "zip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "50501",
      "description": "Location ZIP code (default: '50501' - Des Moines, IA)"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "City of the car (optional if zip provided)"
    },
    "miles": {
      "type": "integer",
      "default": 50000,
      "description": "Miles the vehicle has driven in total (default: 50,000)"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "State of the car (optional if zip provided)"
    },
    "dealer_type": {
      "type": "string",
      "default": "franchise",
      "description": "Filter based on dealer type (independent or franchise, default: 'franchise')"
    },
    "is_certified": {
      "type": "boolean",
      "default": false,
      "description": "Boolean to indicate if car is certified or not (default: False)"
    }
  },
  "additionalProperties": false
}

search_active_cars

Search for cars in the United States and Canada market with comprehensive filters. This endpoint allows searching market vehicles that are up for sale in US and Canadian market right now. This endpoint serves only dealer listings. Carfax fields: `carfax_1_owner`, `carfax_clean_title` and other `carfax_*` values are incomplete in this dataset and are not supported as filters, facets or stats. They should not be used to describe ownership or title history. Filtering categorical fields (two steps). Field values in this API are not canonical English (e.g. fuel_type="Hybrid" is wrong; the actual value is "HEV" or "Electric / Unleaded"). Skipping step 1 leads to silent zero-result responses. STEP 1 — discover valid values: call this tool with only the `facets` parameter (and an optional location filter), rows=1, no other filters set. STEP 2 — filter for real: re-call with the exact strings returned in step 1. For instance, to filter cars by powertrain in New York: STEP 1 call: search_active_cars(facets="powertrain_type", rows=1, state="NY") -> returns {"powertrain_type": [{"item": "HEV", "count": 18058}, {"item": "PHEV", "count": 6004}, ...]} STEP 2 call: search_active_cars(powertrain_type="HEV,PHEV", state="NY") Fields that REQUIRE step 1 before being used as filters: powertrain_type, fuel_type, trim, body_type, drivetrain, transmission, make, model, exterior_color, interior_color. WRONG: search_active_cars(fuel_type="Hybrid") # silent zero-result CORRECT: search_active_cars(facets="fuel_type", rows=1) # discover valid values first then: search_active_cars(fuel_type="Electric / Unleaded") DEALER FILTERING: When any of dealer_id, source, mc_website_id, mc_dealer_id, mc_location_id, mc_rooftop_id, mc_dealership_group_id, mc_dealership_group_name, mc_sub_dealership_group_id, mc_sub_dealership_group_name, or mc_category are provided, this tool automatically routes to the Dealer Inventory Syndication API (GET /dealerships/inventory) instead of the standard inventory search API for optimized dealer-specific inventory retrieval. Use search_past_90_days for expired/sold dealer inventory analysis. STALENESS METRICS — dos_active vs dom_active (read before answering "how long has this car been for sale" questions): - dos_active (Days on Site): days this listing has been active at the CURRENT dealer. Answers "how long has THIS DEALER been trying to sell this car." DEFAULT: use dos_active for stale-inventory and "how long has it been listed" questions (e.g. finding dealers with stale inventory in an area). - dom_active (Days on Market): cumulative days the VEHICLE has been actively listed for sale across all dealers — it survives dealer-to-dealer transfers. Use only when the question is about the vehicle's total market exposure, e.g. evaluating a car at auction or in a dealer trade: a car showing dos_active=15 at the current store may show dom_active=60 because it has been passed around dealers for two months. This rule applies to choosing filter params (dos_active_range vs dom_active_range), sort_by values, and which field to read and report from listing results. When unsure which the user means, default to dos_active.

search_dealers

Search the legacy MarketCheck dealer directory (one-website-per-dealer model). search_dealerships is recommended for new use cases. This endpoint is being phased out; use it only when you specifically need legacy `dealer_id`-style records or the `listing_count_range` inventory-size filter, which is not available on the dealerships endpoint. For get_sold_summary, a dealer's inventory_url here is its `source` value. This endpoint has no dealership-group field; use search_dealerships for group names. Geospatial: pass (latitude AND longitude) OR zip, plus radius (miles, max 7000). Pagination: rows default 10, max 50; start default 0; (start * rows) cannot exceed 10000.

read-only

Argument	Type	Description
zip	any
city	any
rows	any	Page size, default 10, max 50.
start	any	Pagination offset (0-based).
state	any
facets	any	Comma-separated bucket-facet fields. Allowed values (any other field will be silently ignored): city, state, country, dealer_type.
radius	any	Search radius in miles (0..7000).
country

search_dealerships

Search the MarketCheck dealership directory (current, multi-rooftop, group-aware). Use this for "who/where is the dealer?" lookups. For inventory, use search_active_cars. Recommended over search_dealers unless legacy `dealer_id`-style results are needed. This is also the lookup for get_sold_summary (sold-vehicle statistics): - A dealer's (rooftop's) sales: pass its inventory_url as get_sold_summary `source`. Several rooftops: comma-separated inventory_urls. - A dealership group's sales: pass mc_dealership_group_name as get_sold_summary `dealership_group_name`. Filter here with mc_dealership_group_name to list a group's rooftops. Geospatial: pass (latitude AND longitude) OR zip, plus radius (miles, max 7000). mc_category values: Dealer, Retailer, Dealership Group, Aggregator, Marketing, Financing. Pagination: rows default 10, max 50; start default 0; (start * rows) cannot exceed 10000.

read-only

Argument	Type	Description
zip	any	5-digit ZIP/postal code; comma-separated for multi-value.
city	any
rows	any	Page size, default 10, max 50.
start	any	Pagination offset (0-based).
state	any
facets	any	Comma-separated bucket-facet fields. Allowed values (any other field will be silently ignored): city, state, country, dealer_type, mc_website_id, mc_dealer_id, mc_location_id, mc_rooftop_id, mc_category, mc_dealership_group_id, mc_dealership_group_name, mc_sub_dealership_group_id, mc_sub_dealership_group_name.

search_oem_incentives

Search for OEM (manufacturer) incentive offers across all brands. Searches for rebates, financing deals, and lease specials with 50+ filter parameters. Use this when searching across multiple OEMs or doing broad searches.

read-only

Argument	Type	Description
zip	any	5-character ZIP code
city	any	City name
make	any	Comma-separated make names (e.g., "Toyota,Honda")
rows	any	Number of results to return (default: 10, max: 10)
trim	any	Comma-separated trim levels
year	any	Comma-separated years (e.g., "2024,2025")
model	any	Comma-separated model names (e.g., "Camry,Accord")
start	any	Starting record offset (default: 0, max: 10000)
state	any	State code (2 chars)
stats

search_oem_incentives_by_zip

Search for incentives from a specific manufacturer in a location. Optimized for finding all available incentives from a specific OEM in a geographic area. Automatically converts ZIP to MSA code for regional relevance. Use this when you know both the manufacturer and location.

read-only

Argument	Type	Description
oem*	string	OEM identifier (e.g., "toyota", "honda", "ford", "chevrolet", "bmw")
zip*	string	5-character ZIP code
rows	any	Number of results to return (default: 10, max: 10)
year	any	Vehicle year (e.g., "2024")
model	any	Vehicle model (e.g., "Camry", "Accord")
start	any	Starting offset for pagination (default: 0)
stats	any	Comma-separated stat fields (e.g., "monthly,apr")
facets	any	Comma-separated facet fields (e.g., "model,offer_type")
sort_by

search_past_90_days

Search for recent car inventory (EXPIRED/SOLD listings from last 90 days) with comprehensive filters following Marketcheck API structure. Scope: this endpoint serves only expired/sold listings from the last 90 days for US and CA (Canada) markets, not active listings. For currently active listings, use the search_active_cars tool instead. Carfax fields: `carfax_1_owner`, `carfax_clean_title` and other `carfax_*` values are incomplete in this dataset and are not supported as filters, facets or stats. They should not be used to describe ownership or title history. Tip: before filtering by specific field values (make, model, trim, body_type, fuel_type, etc.), use the 'facets' parameter to discover available values in the API. Field values may be represented differently than expected. For example: - Use facets="make,model,trim,body_type" to see all available options - This prevents filtering errors due to incorrect field value assumptions - Facets show actual data distribution and available filter options VIN vs Listing ID Disclaimer: - A single VIN can have multiple listings, each with a unique listing ID - Listing ID changes when there are changes in price or miles of the listing - When expired=false is set, it shows listings for VINs that are currently active in the market (not sold yet), but the specific listing is expired. The latest/current listing for that VIN is present in the active search API - This endpoint shows historical listing data (expired listing IDs) for market analysis, not current inventory This endpoint is designed for analytical use cases including: - Historical market analysis of sold vehicles - Sold vehicle pricing trends and patterns - Days on market analysis for expired listings - Dealer inventory turnover and sales analysis - Market intelligence from recently sold inventory Key use cases: - Analyze recent sales trends and pricing - Get sold/expired listings for market intelligence - Calculate average market prices from recent inventory - Track dealer inventory turnover patterns Due to performance reasons, this endpoint is more restrictive than active search: - Does not accept facets, stats and range_facets in a single call - Requires one of: city, state, zip, (latitude+longitude+radius), source, or dealer_id - For geo queries, radius cannot be greater than 100 miles - Charged at higher rates than active search endpoint STALENESS METRICS — dos_active vs dom_active (read before answering "how long was this car for sale" questions): - dos_active (Days on Site): days the listing was active at the CURRENT dealer. Answers "how long did THIS DEALER try to sell this car." DEFAULT: use dos_active for stale-inventory and "how long was it listed" questions. - dom_active (Days on Market): cumulative days the VEHICLE was actively listed across all dealers — it survives dealer-to-dealer transfers. Use only when the question is about the vehicle's total market exposure, e.g. evaluating a car at auction or in a dealer trade: a car showing dos_active=15 at the current store may show dom_active=60 because it was passed around dealers for two months. This rule applies to choosing filter params (dos_active_range vs dom_active_range), sort_by values, and which field to read and report from listing results. When unsure which the user means, default to dos_active.

search_uk_active_cars

Search for active cars in the UK market. This tool searches for currently active car listings in the UK using the Marketcheck API. It supports comprehensive filtering by location, vehicle specifications, price, and more. Includes all parameters supported by the /search/car/uk/active endpoint. Carfax fields: `carfax_1_owner`, `carfax_clean_title` and other `carfax_*` values are incomplete in this dataset and are not supported as filters, facets or stats. They should not be used to describe ownership or title history. Tip: before filtering by specific field values (make, model, trim, body_type, fuel_type, etc.), use the 'facets' parameter to discover available values in the API. Field values may be represented differently than expected. For example: - Use facets="make,model,trim,body_type" to see all available options - This prevents filtering errors due to incorrect field value assumptions - Facets show actual data distribution and available filter options STALENESS METRICS — dos_active vs dom_active (read before answering "how long has this car been for sale" questions): - dos_active (Days on Site): days this listing has been active at the CURRENT dealer. Answers "how long has THIS DEALER been trying to sell this car." DEFAULT: use dos_active for stale-inventory and "how long has it been listed" questions. - dom_active (Days on Market): cumulative days the VEHICLE has been actively listed for sale across all dealers — it survives dealer-to-dealer transfers. Use only when the question is about the vehicle's total market exposure, e.g. evaluating a car at auction or in a dealer trade: a car showing dos_active=15 at the current store may show dom_active=60 because it has been passed around dealers for two months. This rule applies to choosing filter params (dos_active_range vs dom_active_range), sort_by values, and which field to read and report from listing results. When unsure which the user means, default to dos_active.

read-only

Argument	Type	Description
vrm	any	Vehicle Registration Mark (VRM) filter.

search_uk_recent_cars

Search for recent/expired cars in the UK market (last 90 days). This tool searches recent inventory data for expired/sold listings only. It does not include active listings - use search_uk_active_cars for current inventory. Carfax fields: `carfax_1_owner`, `carfax_clean_title` and other `carfax_*` values are incomplete in this dataset and are not supported as filters, facets or stats. They should not be used to describe ownership or title history. Tip: before filtering by specific field values (make, model, trim, body_type, fuel_type, etc.), use the 'facets' parameter to discover available values in the API. Field values may be represented differently than expected. For example: - Use facets="make,model,trim,body_type" to see all available options - This prevents filtering errors due to incorrect field value assumptions - Facets show actual data distribution and available filter options STALENESS METRICS — dos_active vs dom_active (read before answering "how long was this car for sale" questions): - dos_active (Days on Site): days the listing was active at the CURRENT dealer. Answers "how long did THIS DEALER try to sell this car." DEFAULT: use dos_active for stale-inventory and "how long was it listed" questions. - dom_active (Days on Market): cumulative days the VEHICLE was actively listed across all dealers — it survives dealer-to-dealer transfers. Use only when the question is about the vehicle's total market exposure, e.g. evaluating a car at auction or in a dealer trade: a car showing dos_active=15 at the current store may show dom_active=60 because it was passed around dealers for two months. This rule applies to choosing filter params (dos_active_range vs dom_active_range), sort_by values, and which field to read and report from listing results. When unsure which the user means, default to dos_active.

read-only

Argument	Type	Description
vrm	any	Vehicle Registration Mark (VRM) filter.
zip	any

Argument	Type	Description
city	any
make	any
trim	any
year	any
limit	any
model	any
state	any
top_n	any
source	any
date_to	any
body_type	any
date_from	any
drivetrain	any
msrp_label	any
sold_count	any
summary_by	any
year_range	any
dealer_type	any
miles_range	any
body_subtype	any
transmission	any
ranking_order	any
inventory_type*	string
min_sold_count	any
measure_filters	any
powertrain_type	any
ranking_measure	any
fuel_type_category	any
rank_after_filters	any
ranking_dimensions	any
base_exterior_color	any
base_interior_color	any
dealership_group_name	any
price_over_msrp_percentage	any
price_over_mc_msrp_percentage	any

Input schema (JSON)

{
  "type": "object",
  "required": [
    "inventory_type"
  ],
  "properties": {
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "trim": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "year": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "model": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "top_n": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "date_to": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "body_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "date_from": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "drivetrain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "msrp_label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "sold_count": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "summary_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "year_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "dealer_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "miles_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "body_subtype": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "transmission": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "ranking_order": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "inventory_type": {
      "type": "string"
    },
    "min_sold_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "measure_filters": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "powertrain_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "ranking_measure": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "fuel_type_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "rank_after_filters": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "ranking_dimensions": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "base_exterior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "base_interior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "price_over_msrp_percentage": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "price_over_mc_msrp_percentage": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "additionalProperties": false
}

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

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "mm": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Make-Model concatenated string from auto-complete API"
    },
    "vin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their VIN"
    },
    "ymm": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Year-Make-Model concatenated string from auto-complete API"
    },
    "zip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on ZIP around which they are listed"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on City in which they are listed"
    },
    "make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their make"
    },
    "plot": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, results in around 25k coordinates with limited fields for plotting"
    },
    "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."
    },
    "trim": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their trim"
    },
    "vins": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of 17 digit vins (max 10 VINs per request)"
    },
    "year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle manufacturing year (e.g., 2020, 2021)"
    },
    "ymmt": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of Year|Make|Model|Trim combinations"
    },
    "dedup": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, gives results with is_searchable irrespective of dealer_id/mc_website_id/source"
    },
    "doors": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of doors (e.g., 2, 4)"
    },
    "match": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of Year,Make,Model,Trim fields for exact match with vins"
    },
    "model": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their model"
    },
    "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)"
    },
    "start": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Page number/offset to fetch results (default 0, max depends on package)"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on State in which they are listed"
    },
    "stats": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of fields for which stats need to be generated"
    },
    "engine": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their engine"
    },
    "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"
    },
    "radius": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Radius around the search location (Unit - Miles)"
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Source filter to search inventory from specific source"
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on Country in which they are listed"
    },
    "nodedup": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, API gives results without is_searchable (multiple listings for single vin)"
    },
    "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."
    },
    "vdp_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter based on vehicle detail page URL"
    },
    "version": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their version"
    },
    "car_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car type (new/used/certified)"
    },
    "latitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Latitude component of location"
    },
    "msa_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on msa code in which they are listed"
    },
    "stock_no": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their stock number on lot"
    },
    "body_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their body type"
    },
    "cylinders": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of engine cylinders (e.g., 4, 6, 8)"
    },
    "dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Dealer ID filter to search inventory from specific dealer"
    },
    "dom_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Days on Market range in format \"min-max\" (e.g., \"10-50\")"
    },
    "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."
    },
    "lease_emp": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range lease Estimated Monthly Payment(EMI)"
    },
    "longitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Longitude component of location"
    },
    "drivetrain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their drivetrain"
    },
    "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"
    },
    "in_transit": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to filter in transit vehicles"
    },
    "lease_term": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range lease term"
    },
    "msrp_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MSRP range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "sort_order": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "asc",
      "description": "Sort order (asc|desc)"
    },
    "year_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Year range in format \"min-max\" (e.g., \"2019-2021\")"
    },
    "dealer_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Type of dealer (e.g., franchise, independent)"
    },
    "engine_size": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine Size to match (comma-separated values)"
    },
    "finance_emp": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range Estimated Monthly Payment(EMI)"
    },
    "mc_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck seller category. Values: \"Dealer\", \"Retailer\", \"Dealership Group\", \"Aggregator\", \"Marketing\", \"Financing\""
    },
    "miles_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Miles range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "photo_links": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to include only listings that have photo_links"
    },
    "price_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Price range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "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\""
    },
    "body_subtype": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Body subtype to filter listings on (comma-separated values)"
    },
    "engine_block": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine Block to match (comma-separated values)"
    },
    "exclude_make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of makes to exclude from result"
    },
    "mc_dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck dealer ID filter"
    },
    "price_change": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Query to filter listings based on positive and negative price change"
    },
    "range_facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of numeric fields for range facets"
    },
    "transmission": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their transmission"
    },
    "vehicle_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their vehicle type"
    },
    "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\")"
    },
    "include_lease": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean param to search for listings that include leasing options"
    },
    "mc_rooftop_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck rooftop ID filter"
    },
    "mc_website_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck website ID filter"
    },
    "taxonomy_vins": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of 10 letters excerpt from 17 letter VIN"
    },
    "base_ext_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)"
    },
    "carfax_1_owner": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Indicates whether car has had only one owner or not"
    },
    "city_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "City mileage range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "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)"
    },
    "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)."
    },
    "mc_location_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck location ID filter"
    },
    "exclude_sources": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of sources to exclude from result"
    },
    "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)."
    },
    "include_finance": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean param to search for listings that include finance options"
    },
    "last_seen_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last seen date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)"
    },
    "min_photo_links": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings by number of photo links within given range"
    },
    "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."
    },
    "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."
    },
    "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."
    },
    "fetch_all_photos": {
      "type": "boolean",
      "default": false,
      "description": "When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links."
    },
    "finance_loan_apr": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range loans Annual Percentage Rate"
    },
    "first_seen_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen date range in format YYYYMMDD-YYYYMMDD(prev_date-later_date)"
    },
    "options_packages": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their options_packages (intersection of provided OPs).\nTip: before using this filter, 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."
    },
    "seating_capacity": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of seats (e.g., 5, 7, 8)"
    },
    "engine_aspiration": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine Aspiration 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\")"
    },
    "exclude_certified": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean param to exclude certified cars from search results"
    },
    "finance_loan_term": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range finance loan term"
    },
    "highway_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Highway mileage range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "preferred_dealers": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Flag to add preferred dealers flag based on client filter score"
    },
    "carfax_clean_title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Indicates whether car has clean ownership records"
    },
    "exclude_dealer_ids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of dealer ids to exclude from result"
    },
    "lease_down_payment": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range down payment in lease offers"
    },
    "photo_links_cached": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to include only listings that have photo_links_cached"
    },
    "price_change_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Price change range in format \"min-max\" (e.g., \"10-500\")"
    },
    "base_exterior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base exterior 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)"
    },
    "high_value_features": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their high_value_features (intersection of provided HVFs).\nTip: before using this filter, 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."
    },
    "finance_down_payment": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range down payment in finance offers"
    },
    "include_build_object": {
      "type": "boolean",
      "default": false,
      "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"
    },
    "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)."
    },
    "include_dealer_object": {
      "type": "boolean",
      "default": false,
      "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"
    },
    "inventory_count_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Inventory count range for total listings in dealers inventory"
    },
    "exclude_mc_website_ids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of dealer ids to exclude from result"
    },
    "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)"
    },
    "include_relevant_links": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Include relevant links (default true)"
    },
    "mc_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck dealership group ID filter"
    },
    "min_photo_links_cached": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings by number of cached photo links within range"
    },
    "preferred_dealers_only": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Flag to show only preferred dealers listings"
    },
    "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."
    },
    "finance_down_payment_per": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact/range down payment percentage"
    },
    "include_non_vin_listings": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Include non vin listings (default false)"
    },
    "mc_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck dealership group name filter"
    },
    "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)"
    },
    "mc_sub_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck sub-dealership group ID filter"
    },
    "active_inventory_date_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Date range to filter listings active within range (YYYYMMDD-YYYYMMDD)"
    },
    "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."
    },
    "include_mc_dealership_object": {
      "type": "boolean",
      "default": false,
      "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"
    },
    "mc_sub_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck sub-dealership group name filter"
    },
    "include_preferred_dealer_flag": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Flag to add preferred dealers flag based on client filter score"
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "zip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "rows": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Page size, default 10, max 50."
    },
    "start": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination offset (0-based)."
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated bucket-facet fields. Allowed values (any other\nfield will be silently ignored): city, state, country, dealer_type."
    },
    "radius": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search radius in miles (0..7000)."
    },
    "country": {
      "type": "string",
      "description": "US or CA. Default US."
    },
    "sort_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "dist (geo default), dealer_id (default), listing_count, created_at_days."
    },
    "latitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "msa_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Metropolitan Statistical Area code(s)."
    },
    "longitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "sort_order": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "asc | desc (default asc)."
    },
    "dealer_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "franchise | independent."
    },
    "range_facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated numeric range-facet fields. Allowed values:\nlisting_count."
    },
    "inventory_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by dealer domain."
    },
    "created_at_days": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "min-max age in days."
    },
    "created_at_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "YYYYMMDD-YYYYMMDD."
    },
    "listing_count_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "min-max inventory size (e.g. \"50-100\"). Legacy-only."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "zip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "5-digit ZIP/postal code; comma-separated for multi-value."
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "rows": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Page size, default 10, max 50."
    },
    "start": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination offset (0-based)."
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated bucket-facet fields. Allowed values (any other\nfield will be silently ignored): city, state, country, dealer_type,\nmc_website_id, mc_dealer_id, mc_location_id, mc_rooftop_id, mc_category,\nmc_dealership_group_id, mc_dealership_group_name,\nmc_sub_dealership_group_id, mc_sub_dealership_group_name."
    },
    "radius": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search radius in miles (0..7000)."
    },
    "country": {
      "type": "string",
      "description": "US or CA. Default US."
    },
    "sort_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "mc_website_id (default), mc_dealer_id, mc_location_id, mc_rooftop_id,\nmc_dealership_group_id, mc_sub_dealership_group_id, created_at_days."
    },
    "latitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "msa_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Metropolitan Statistical Area code(s)."
    },
    "longitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "sort_order": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "asc | desc (default asc)."
    },
    "dealer_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "franchise | independent."
    },
    "mc_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Seller category (see values above)."
    },
    "mc_dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "range_facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Not supported on this endpoint — pass nothing. Use\nsearch_dealers if you need a listing_count range facet."
    },
    "inventory_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by dealer domain (e.g. carmax.com)."
    },
    "mc_rooftop_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "mc_website_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "mc_location_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "created_at_days": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "min-max age in days."
    },
    "created_at_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "YYYYMMDD-YYYYMMDD."
    },
    "mc_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "mc_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "mc_sub_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "mc_sub_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "zip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "5-character ZIP code"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "City name"
    },
    "make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated make names (e.g., \"Toyota,Honda\")"
    },
    "rows": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of results to return (default: 10, max: 10)"
    },
    "trim": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated trim levels"
    },
    "year": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated years (e.g., \"2024,2025\")"
    },
    "model": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated model names (e.g., \"Camry,Accord\")"
    },
    "start": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Starting record offset (default: 0, max: 10000)"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "State code (2 chars)"
    },
    "stats": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated fields for statistical aggregations (e.g., \"monthly,apr,cashback_amount\")"
    },
    "engine": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated engine types"
    },
    "facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated field names for faceted search (e.g., \"make,model,offer_type\")"
    },
    "radius": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search radius in miles (default: 50, max: 5000 - be conservative, use larger values only when explicitly requested)"
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "OEM source domain"
    },
    "country": {
      "type": "string",
      "description": "Country code"
    },
    "sort_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Field name to sort by (e.g., \"monthly\", \"apr\", \"cashback_amount\")"
    },
    "msa_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Metropolitan Statistical Area code (4 chars)"
    },
    "apr_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "APR percentage range (e.g., \"0-3\")"
    },
    "dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter by dealer ID"
    },
    "fuel_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated fuel types"
    },
    "drivetrain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated drivetrain types"
    },
    "msrp_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MSRP value range"
    },
    "offer_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "One of \"lease\", \"finance\", or \"cash\""
    },
    "sort_order": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "\"asc\" or \"desc\""
    },
    "term_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Term length range (e.g., \"24-60\")"
    },
    "year_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Format \"min-max\" (e.g., \"2020-2025\")"
    },
    "transmission": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated transmission types"
    },
    "monthly_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Monthly payment range (e.g., \"200-400\")"
    },
    "valid_from_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Offer start date range"
    },
    "status_date_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last seen date range"
    },
    "down_payment_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Down payment amount range"
    },
    "search_offers_text": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search within offer text"
    },
    "search_titles_text": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search within offer titles"
    },
    "mileage_limit_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Annual mileage limit range"
    },
    "valid_through_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Offer end date range"
    },
    "due_at_signing_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Due at signing amount range"
    },
    "cashback_amount_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Cashback amount range (e.g., \"1000-5000\")"
    },
    "cashback_target_group": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Target demographic (e.g., \"military,college_grad\")"
    },
    "scraped_at_date_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen date range"
    },
    "search_disclaimers_text": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search within disclaimers"
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "oem",
    "zip"
  ],
  "properties": {
    "oem": {
      "type": "string",
      "description": "OEM identifier (e.g., \"toyota\", \"honda\", \"ford\", \"chevrolet\", \"bmw\")"
    },
    "zip": {
      "type": "string",
      "description": "5-character ZIP code"
    },
    "rows": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of results to return (default: 10, max: 10)"
    },
    "year": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle year (e.g., \"2024\")"
    },
    "model": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle model (e.g., \"Camry\", \"Accord\")"
    },
    "start": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Starting offset for pagination (default: 0)"
    },
    "stats": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated stat fields (e.g., \"monthly,apr\")"
    },
    "facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated facet fields (e.g., \"model,offer_type\")"
    },
    "sort_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Field to sort by (e.g., \"monthly\", \"apr\", \"cashback_amount\")"
    },
    "apr_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "APR range (format: \"min-max\")"
    },
    "offer_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "One of \"lease\", \"finance\", or \"cash\""
    },
    "sort_order": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "\"asc\" or \"desc\""
    },
    "monthly_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Monthly payment range (format: \"min-max\")"
    },
    "cashback_amount_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Cashback range (format: \"min-max\")"
    }
  },
  "additionalProperties": false
}

Argument	Type	Description
vin	any
zip	any	Filter listing on ZIP around which they are listed
city	any	Filter listing on City in which they are listed
make	any	Filter listings on their make
plot	any
rows	any	Number of results to return (default 5, max 50)
sold	any	Boolean to fetch only sold/expired listings (True/False)
trim	any	Filter listing on their trim
vins	any
year	any	Vehicle manufacturing year (e.g., 2020, 2021)
ymmt	any
dedup	any
doors	any	Number of doors (e.g., 2, 4)
match	any
model	any	Filter listings on their model
owned	any	Boolean, when True returns listings actually owned by dealer (used with dealer_id/source)
start	any	Page number/offset to fetch results (default 0)
state	any	Filter listing on State in which they are listed
stats	any	Field for which stats need to be generated (single field only)
engine	any
facets	any	Field facets return unique terms and their counts for categorical data, useful for building search filters and understanding inventory distribution. Syntax: facets=field_name\|offset\|limit\|min_count (single field only) - offset (default: 0): Start position for terms - limit (default: 20, max: 1000): Number of terms to return - min_count (optional): Minimum count for a term to be included Example: facets=make\|0\|60\|2 returns top 60 makes with at least 2 listings each
radius	any	Radius around the search location (Unit - Miles, max 100)
source	any	Filter listing on their source
country	any
expired	any	Boolean to fetch only expired listings or active ones (True/False)
nodedup	any
sort_by	any	Sort by field (dist\|price\|miles\|msrp\|dom\|dom_active\|dos_active\|last_seen\|first_seen, etc.). For staleness sorting, default to dos_active (current dealer) over dom_active (all dealers) — see STALENESS METRICS above.
vdp_url	any
version	any
car_type	any	Car type (new/used/certified)
latitude	any	Latitude component of location
msa_code	any
stock_no	any
body_type	any	Filter listing on their body type
cylinders	any	Number of engine cylinders (e.g., 4, 6, 8)
dealer_id	any	Dealer id to filter the listings
dom_range	any	Days on Market range in format "min-max" (e.g., "10-50")
fuel_type	any	Filter listing on their fuel type. WARNING: This field has many non-normalized values. First call this tool with facets="fuel_type\|0\|1000" to discover exact available values before filtering.
lease_emp	any
longitude	any	Longitude component of location
drivetrain	any
facet_sort	any
in_transit	any	Boolean to filter in transit vehicles (True/False)
lease_term	any
msrp_range	any	MSRP range in format "min-max" (e.g., "1000-5000")
sort_order	any	Sort order (asc\|desc)
year_range	any	Year range in format "min-max" (e.g., "2019-2021")
dealer_name	any
dealer_type	any
engine_size	any
finance_emp	any
mc_category	any	MarketCheck seller category. Values: "Dealer", "Retailer", "Dealership Group", "Aggregator", "Marketing", "Financing"
miles_range	any	Miles range in format "min-max" (e.g., "1000-5000")
photo_links	any
price_range	any	Price range in format "min-max" (e.g., "1000-5000")
body_subtype	any
engine_block	any
exclude_make	any
mc_dealer_id	any
range_facets	any	Numeric field for range facets (single field only)
transmission	any
vehicle_type	any
dom_180_range	any
include_lease	any
mc_rooftop_id	any
mc_website_id	any
taxonomy_vins	any
base_ext_color	any
base_int_color	any
carfax_1_owner	any
city_mpg_range	any
exterior_color	any	Exterior color to match (comma-separated values)
interior_color	any	Interior color to match (comma-separated values)
last_seen_days	any	Last seen days range in format "max-min" (e.g., "3-1" for 1 to 3 days ago).
mc_location_id	any
exclude_sources	any
first_seen_days	any	First seen days range in format "max-min" (e.g., "30-10" for 10 to 30 days ago).
include_finance	any
last_seen_range	any	Last seen date range in format YYYYMMDD-YYYYMMDD
dom_active_range	any	Cumulative days the VEHICLE was 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.
dos_active_range	any	Days the listing was active at the CURRENT dealer, in format "min-max" (e.g., "10-50"). Dealer-level staleness — DEFAULT metric for "how long was it for sale" questions. See STALENESS METRICS above.
fetch_all_photos	boolean	When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links.
finance_loan_apr	any
first_seen_range	any	First seen date range in format YYYYMMDD-YYYYMMDD
seating_capacity	any	Number of seats (e.g., 5, 7, 8)
engine_aspiration	any
engine_size_range	any
exclude_certified	any
finance_loan_term	any
highway_mpg_range	any
carfax_clean_title	any
exclude_dealer_ids	any
lease_down_payment	any
photo_links_cached	any
price_change_range	any
base_exterior_color	any	Base exterior color to match (comma-separated values)
base_interior_color	any	Base interior color to match (comma-separated values)
finance_down_payment	any
include_build_object	boolean	When True, includes build object in response. Build object structure: - year (number): Model year - make (string): Vehicle manufacturer - model (string, optional): Vehicle model - trim (string, optional): Trim level - version (string, optional): Specific version/variant - body_type (string, optional): Body style (sedan, SUV, truck, etc.) - vehicle_type (string, optional): Vehicle category - transmission (string, optional): Transmission type - drivetrain (string, optional): Drivetrain configuration - fuel_type (string, optional): Fuel type (gasoline, electric, hybrid, etc.) - engine (string, optional): Engine description - engine_size (number, optional): Engine displacement - engine_block (string, optional): Engine block configuration - doors (number, optional): Number of doors - cylinders (number, optional): Number of cylinders - made_in (string, optional): Manufacturing country - overall_height, overall_length, overall_width (string, optional): Vehicle dimensions - std_seating (string, optional): Standard seating capacity - highway_mpg (number, optional): Highway fuel economy - city_mpg (number, optional): City fuel economy
dealership_group_name	any
first_seen_at_mc_days	any	First seen at MC days range in format "max-min" (e.g., "25-12" for 12 to 25 days ago).
include_dealer_object	boolean	When True, includes dealer object in response. Dealer object structure: - id (number): Unique dealer identifier - website (string): Dealer website URL - name (string): Dealer business name - dealer_type (string, optional): Dealer classification (franchise, independent) - street, city, state, country (string, optional): Address components - latitude, longitude (string, optional): Geographic coordinates - zip (string, optional): Postal/ZIP code - phone (string, optional): Contact phone number - seller_email (string, optional): Contact email address - dealership_group_name (string, optional): Parent dealership group - msa_code (string, optional): Metropolitan Statistical Area code
exclude_mc_website_ids	any
first_seen_at_mc_range	any	First seen at MC date range in format YYYYMMDD-YYYYMMDD
include_relevant_links	any
mc_dealership_group_id	any
finance_down_payment_per	any
include_non_vin_listings	any	Boolean to include non vin listings (True/False, default False)
mc_dealership_group_name	any
first_seen_at_source_days	any	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	any	First seen at source date range in format YYYYMMDD-YYYYMMDD
mc_sub_dealership_group_id	any
active_inventory_date_range	any	Date range to filter listings active within range (YYYYMMDD-YYYYMMDD)
include_mc_dealership_object	boolean	When True, includes mc_dealership object in response. McDealership object structure: - mc_website_id (number, optional): MarketCheck website identifier - mc_dealer_id (number, optional): MarketCheck dealer identifier - mc_location_id (number, optional): MarketCheck location identifier - mc_rooftop_id (number, optional): MarketCheck rooftop identifier - mc_dealership_group_id (number, optional): MarketCheck dealership group identifier - mc_dealership_group_name (string, optional): MarketCheck dealership group name - mc_sub_dealership_group_id (number, optional): MarketCheck sub-dealership group identifier - mc_sub_dealership_group_name (string, optional): MarketCheck sub-dealership group name - mc_category (string, optional): MarketCheck seller category. Values: "Dealer", "Retailer", "Dealership Group", "Aggregator", "Marketing", "Financing" - website (string, optional): Dealer website URL - name (string, optional): Dealer business name - dealer_type (string, optional): Dealer classification (franchise, independent) - street, city, state, country (string, optional): Address components - latitude, longitude (string, optional): Geographic coordinates - zip (string, optional): Postal/ZIP code - msa_code (string, optional): Metropolitan Statistical Area code - phone (string, optional): Contact phone number
mc_sub_dealership_group_name	any

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "vin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "zip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on ZIP around which they are listed"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on City in which they are listed"
    },
    "make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their make"
    },
    "plot": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "rows": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 5,
      "description": "Number of results to return (default 5, max 50)"
    },
    "sold": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to fetch only sold/expired listings (True/False)"
    },
    "trim": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their trim"
    },
    "vins": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle manufacturing year (e.g., 2020, 2021)"
    },
    "ymmt": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "dedup": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "doors": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of doors (e.g., 2, 4)"
    },
    "match": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "model": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on their model"
    },
    "owned": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean, when True returns listings actually owned by dealer (used with dealer_id/source)"
    },
    "start": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 0,
      "description": "Page number/offset to fetch results (default 0)"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on State in which they are listed  "
    },
    "stats": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Field for which stats need to be generated (single field only)"
    },
    "engine": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "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 (single field only)\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"
    },
    "radius": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Radius around the search location (Unit - Miles, max 100)"
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their source"
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "expired": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to fetch only expired listings or active ones (True/False)"
    },
    "nodedup": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "sort_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Sort by field (dist|price|miles|msrp|dom|dom_active|dos_active|last_seen|first_seen, etc.). For staleness sorting, default to dos_active (current dealer) over dom_active (all dealers) — see STALENESS METRICS above."
    },
    "vdp_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "version": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "car_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car type (new/used/certified)"
    },
    "latitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Latitude component of location"
    },
    "msa_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "stock_no": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "body_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their body type"
    },
    "cylinders": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of engine cylinders (e.g., 4, 6, 8)"
    },
    "dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Dealer id to filter the listings"
    },
    "dom_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Days on Market range in format \"min-max\" (e.g., \"10-50\")"
    },
    "fuel_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listing on their fuel type.\nWARNING: This field has many non-normalized values. First call this tool with facets=\"fuel_type|0|1000\" to discover exact available values before filtering."
    },
    "lease_emp": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "longitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Longitude component of location"
    },
    "drivetrain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "facet_sort": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "in_transit": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to filter in transit vehicles (True/False)"
    },
    "lease_term": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "msrp_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MSRP range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "sort_order": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "asc",
      "description": "Sort order (asc|desc)"
    },
    "year_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Year range in format \"min-max\" (e.g., \"2019-2021\")"
    },
    "dealer_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "dealer_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "engine_size": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "finance_emp": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "mc_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MarketCheck seller category. Values: \"Dealer\", \"Retailer\", \"Dealership Group\", \"Aggregator\", \"Marketing\", \"Financing\""
    },
    "miles_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Miles range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "photo_links": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "price_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Price range in format \"min-max\" (e.g., \"1000-5000\")"
    },
    "body_subtype": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "engine_block": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "exclude_make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "mc_dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "range_facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Numeric field for range facets (single field only)"
    },
    "transmission": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "vehicle_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "dom_180_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "include_lease": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "mc_rooftop_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "mc_website_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "taxonomy_vins": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "base_ext_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "base_int_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "carfax_1_owner": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "city_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "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)"
    },
    "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)."
    },
    "mc_location_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "exclude_sources": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "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)."
    },
    "include_finance": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "last_seen_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last seen date range in format YYYYMMDD-YYYYMMDD"
    },
    "dom_active_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Cumulative days the VEHICLE was 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."
    },
    "dos_active_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Days the listing was active at the CURRENT dealer, in format \"min-max\" (e.g., \"10-50\"). Dealer-level staleness — DEFAULT metric for \"how long was it for sale\" questions. See STALENESS METRICS above."
    },
    "fetch_all_photos": {
      "type": "boolean",
      "default": false,
      "description": "When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links."
    },
    "finance_loan_apr": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "first_seen_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen date range in format YYYYMMDD-YYYYMMDD"
    },
    "seating_capacity": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of seats (e.g., 5, 7, 8)"
    },
    "engine_aspiration": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "engine_size_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "exclude_certified": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "finance_loan_term": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "highway_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "carfax_clean_title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "exclude_dealer_ids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "lease_down_payment": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "photo_links_cached": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "price_change_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "base_exterior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base exterior 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)"
    },
    "finance_down_payment": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "include_build_object": {
      "type": "boolean",
      "default": false,
      "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"
    },
    "dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "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)."
    },
    "include_dealer_object": {
      "type": "boolean",
      "default": false,
      "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"
    },
    "exclude_mc_website_ids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "first_seen_at_mc_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen at MC date range in format YYYYMMDD-YYYYMMDD"
    },
    "include_relevant_links": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "mc_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "finance_down_payment_per": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "include_non_vin_listings": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to include non vin listings (True/False, default False)"
    },
    "mc_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "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"
    },
    "mc_sub_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "active_inventory_date_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Date range to filter listings active within range (YYYYMMDD-YYYYMMDD)"
    },
    "include_mc_dealership_object": {
      "type": "boolean",
      "default": false,
      "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"
    },
    "mc_sub_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "vrm": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle Registration Mark (VRM) filter."
    },
    "zip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on ZIP around which they are listed."
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on City in which they are listed."
    },
    "make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their make (comma-separated values)."
    },
    "plot": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, results in around 25k coordinates with limited fields to plot."
    },
    "rows": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of results to return. Default is 10. Max is 50."
    },
    "trim": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their trim (comma-separated values)."
    },
    "year": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their year (comma-separated values)."
    },
    "ymmt": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of Year, Make, Model, Trim combinations."
    },
    "dedup": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, will give results with is_searchable irrespective of dealer."
    },
    "doors": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Doors to filter the cars on (comma-separated integer values)."
    },
    "match": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of fields for exact match."
    },
    "model": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their model (comma-separated values)."
    },
    "owned": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "When used with dealer_id, returns listings owned by dealer."
    },
    "start": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Page number to fetch results. Default is 0. Max pagination: 10000."
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on State in which they are listed."
    },
    "stats": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of fields for which stats need to be generated."
    },
    "county": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on county in which they are listed."
    },
    "engine": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their engine (comma-separated values)."
    },
    "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"
    },
    "radius": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Radius around the search location in miles (max: 7000)."
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their source (comma-separated URLs)."
    },
    "uvc_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "UVC (Universal Vehicle Code) ID filter."
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on Country (uk, england, scotland, northern ireland, wales)."
    },
    "nodedup": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, API will give results without is_searchable."
    },
    "sort_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Sort by field. Default sort field is distance from the given point. For staleness sorting, default to dos_active (current dealer) over dom_active (all dealers) — see STALENESS METRICS above."
    },
    "variant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their variant (comma-separated values)."
    },
    "vdp_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle details page URL filter."
    },
    "car_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car type. Allowed values are - new / used."
    },
    "latitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Latitude component of location (range: -90 to 90)."
    },
    "stock_no": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their stock number on lot."
    },
    "body_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their body type (comma-separated values)."
    },
    "cylinders": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their cylinders (comma-separated values)."
    },
    "dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Dealer id to filter the listings."
    },
    "dom_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Days on Market range to filter cars (format: min-max e.g. 10-50)."
    },
    "fuel_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their fuel type (comma-separated values)."
    },
    "longitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Longitude component of location (range: -180 to 180)."
    },
    "drivetrain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their drivetrain (comma-separated values)."
    },
    "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"
    },
    "fca_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter on fca status."
    },
    "msrp_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MSRP range to filter listings (format: min-max e.g. 1000-5000)."
    },
    "num_owners": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of owners filter."
    },
    "sort_order": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Sort order - asc or desc. Default sort order is asc."
    },
    "year_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Year range to filter listings (format: min-max e.g. 2019-2021)."
    },
    "dealer_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter based on dealer type (franchise or independent)."
    },
    "engine_size": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine Size to match (comma-separated values from facets API)."
    },
    "mc_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter based on mc_category (Dealer, Dealership Group, etc.)."
    },
    "miles_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Miles range to filter listings (format: min-max e.g. 1000-5000)."
    },
    "photo_links": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to include only listings that have photo_links."
    },
    "postal_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on postal code around which they are listed."
    },
    "price_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Price range to filter listings (format: min-max e.g. 1000-5000)."
    },
    "exclude_make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Make values to exclude from results."
    },
    "mc_dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_dealer_id."
    },
    "price_change": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Price change filter for listings."
    },
    "range_facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of numeric fields for range facets."
    },
    "transmission": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their transmission (comma-separated values)."
    },
    "vehicle_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their vehicle type."
    },
    "co2_emissions": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "CO2 emissions filter (comma-separated values)."
    },
    "dom_180_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last 180 Days on Market range to filter cars."
    },
    "mc_rooftop_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_rooftop_id."
    },
    "mc_website_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Website id to filter the listings."
    },
    "model_variant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Model variant filter."
    },
    "base_ext_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base exterior color to match (alias for base_exterior_color)."
    },
    "base_int_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base interior color to match (alias for base_interior_color)."
    },
    "city_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "City mileage range (min-max format e.g. 1000-5000)."
    },
    "exterior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Exterior color to match (comma-separated values from facets API)."
    },
    "interior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Interior color to match (comma-separated values from facets API)."
    },
    "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)."
    },
    "mc_location_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_location_id."
    },
    "ulez_compliant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter for ULEZ compliant vehicles."
    },
    "ev_battery_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Electric vehicle battery type filter."
    },
    "exclude_sources": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "A list of sources to exclude from result."
    },
    "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)."
    },
    "insurance_group": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Insurance group filter for UK vehicles."
    },
    "is_vat_included": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean filter for VAT inclusion."
    },
    "last_seen_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last seen date range (YYYYMMDD-YYYYMMDD format)."
    },
    "min_photo_links": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Minimum number of photo links required."
    },
    "car_location_zip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car location ZIP filter."
    },
    "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), format min-max. Use for total-market-exposure analysis; otherwise prefer dos_active_range. See STALENESS METRICS above."
    },
    "dos_active_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Days the listing has been active at the CURRENT dealer, format min-max. Dealer-level staleness — DEFAULT metric for \"how long has it been for sale\" questions. See STALENESS METRICS above."
    },
    "ev_vehicle_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Electric vehicle range filter."
    },
    "fetch_all_photos": {
      "type": "boolean",
      "default": false,
      "description": "When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links."
    },
    "first_seen_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen date range (YYYYMMDD-YYYYMMDD format)."
    },
    "seating_capacity": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter on vehicle seating capacity."
    },
    "car_location_city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car location city filter."
    },
    "engine_size_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine size range filter."
    },
    "highway_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Highway mileage range (min-max format e.g. 1000-5000)."
    },
    "preferred_dealers": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Preferred dealers filter."
    },
    "combined_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Combined mileage range for UK (min-max format)."
    },
    "exclude_dealer_ids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "A list of dealer ids to exclude from result."
    },
    "photo_links_cached": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to include only listings with cached photo_links."
    },
    "price_change_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Price change range to filter listings."
    },
    "wheelbase_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their wheelbase category."
    },
    "write_off_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Write off category filter."
    },
    "base_exterior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base exterior 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)."
    },
    "car_location_county": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car location county filter."
    },
    "car_location_street": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car location street filter."
    },
    "include_build_object": {
      "type": "boolean",
      "default": false,
      "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- model_variant (string, optional): Vehicle model variant\n- trim (string, optional): Trim level\n- variant (string, optional): Specific variant identifier\n- body_type (string, optional): Body style (saloon, hatchback, estate, 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 (petrol, diesel, electric, hybrid, etc.)\n- engine (string, optional): Engine description\n- engine_size (number, optional): Engine displacement\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- wheelbase_category (string, optional): Wheelbase classification\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- combined_mpg (number, optional): Combined fuel economy\n- seating_capacity (number, optional): Passenger seating capacity\n- performance_torque_ftlb (number, optional): Torque in foot-pounds\n- performance_maxspeed_mph (number, optional): Maximum speed in miles per hour\n- performance_torque_rpm (number, optional): Torque at RPM\n- performance_power_bhp (number, optional): Power in brake horsepower\n- performance_power_rpm (number, optional): Power at RPM\n- performance_torque_nm (number, optional): Torque in Newton-meters\n- performance_power_kw (number, optional): Power in kilowatts\n- performance_co2 (number, optional): CO2 emissions rating\n- euro_status (number, optional): Euro emissions standard status"
    },
    "car_location_latitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car location latitude coordinate."
    },
    "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., \"15-5\")."
    },
    "include_dealer_object": {
      "type": "boolean",
      "default": false,
      "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, county, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- postal_code (string, optional): UK postal code\n- phone (string, optional): Contact phone number\n- seller_email (string, optional): Contact email address\n- fca_status (string, optional): FCA authorization status\n- preferred_dealer (boolean, optional): Flag indicating if this is a preferred dealer"
    },
    "inventory_count_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Inventory count range to filter listings (min-max format)."
    },
    "performance_co2_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Performance CO2 range filter."
    },
    "car_location_longitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car location longitude coordinate."
    },
    "exclude_mc_website_ids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "A list of MC website ids to exclude from result."
    },
    "first_seen_at_mc_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen at MC date range."
    },
    "mc_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_dealership_group_id."
    },
    "min_photo_links_cached": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Minimum number of cached photo links required."
    },
    "preferred_dealers_only": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter to show only preferred dealers."
    },
    "car_location_seller_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car location seller name filter."
    },
    "include_non_vin_listings": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To include non vin listings. Default is false."
    },
    "mc_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_dealership_group_name."
    },
    "ev_battery_capacity_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "EV battery capacity range filter."
    },
    "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., \"15-5\")."
    },
    "vehicle_registration_mark": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle Registration Mark filter."
    },
    "exclude_write_off_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To exclude write off category."
    },
    "first_seen_at_source_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen at source date range."
    },
    "mc_sub_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_sub_dealership_group_id."
    },
    "active_inventory_date_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Active inventory date range filter."
    },
    "include_mc_dealership_object": {
      "type": "boolean",
      "default": false,
      "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. UK market only supports: dealer\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, county, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- postal_code (string, optional): UK postal code\n- phone (string, optional): Contact phone number\n- fca_status (string, optional): FCA authorization status"
    },
    "mc_sub_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_sub_dealership_group_name."
    },
    "include_preferred_dealer_flag": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Include preferred dealer flag."
    },
    "vehicle_registration_date_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle registration date range (YYYYMMDD-YYYYMMDD)."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "vrm": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle Registration Mark (VRM) filter."
    },
    "zip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on ZIP around which they are listed."
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on City in which they are listed."
    },
    "make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their make (comma-separated values)."
    },
    "plot": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, results in around 25k coordinates with limited fields to plot."
    },
    "rows": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of results to return. Default is 10. Max is 50."
    },
    "sold": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean parameter to fetch only sold listings."
    },
    "trim": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their trim (comma-separated values)."
    },
    "year": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their year (comma-separated values)."
    },
    "ymmt": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of Year, Make, Model, Trim combinations."
    },
    "dedup": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, will give results with is_searchable irrespective of dealer."
    },
    "doors": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Doors to filter the cars on (comma-separated integer values)."
    },
    "match": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of fields for exact match (e.g., year,make,model,trim)."
    },
    "model": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their model (comma-separated values)."
    },
    "owned": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "When used with dealer_id, returns listings owned by dealer."
    },
    "start": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Page number to fetch results. Default is 0. Max pagination: 10000."
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on State in which they are listed."
    },
    "stats": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "List of fields for which stats need to be generated."
    },
    "county": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on county in which they are listed."
    },
    "engine": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their engine (comma-separated values)."
    },
    "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"
    },
    "radius": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Radius around the search location in miles (max: 100 for recent search)."
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their source (comma-separated URLs)."
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on Country (uk, england, scotland, northern ireland, wales)."
    },
    "expired": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean flag to either fetch only the expired listings or active ones."
    },
    "nodedup": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "If true, API will give results without is_searchable."
    },
    "sort_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Sort by field. Default sort field is distance from the given point. For staleness sorting, default to dos_active (current dealer) over dom_active (all dealers) — see STALENESS METRICS above."
    },
    "variant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their variant (comma-separated values)."
    },
    "vdp_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Vehicle details page URL filter."
    },
    "car_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Car type. Allowed values are - new / used / certified."
    },
    "latitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Latitude component of location (range: -90 to 90)."
    },
    "stock_no": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their stock number on lot."
    },
    "body_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their body type (comma-separated values)."
    },
    "cylinders": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their cylinders (comma-separated values)."
    },
    "dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Dealer id to filter the listings."
    },
    "dom_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Days on Market range to filter cars (format: min-max e.g. 10-50)."
    },
    "fuel_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their fuel type (comma-separated values)."
    },
    "lease_emp": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with lease Estimated Monthly Payment (EMI) or range."
    },
    "longitude": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Longitude component of location (range: -180 to 180)."
    },
    "drivetrain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their drivetrain (comma-separated values)."
    },
    "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"
    },
    "fca_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter on fca status."
    },
    "lease_term": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact lease term, or range (min-max e.g. 30-60)."
    },
    "msrp_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "MSRP range to filter listings (format: min-max e.g. 1000-5000)."
    },
    "num_owners": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Number of owners filter."
    },
    "sort_order": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Sort order - asc or desc. Default sort order is asc."
    },
    "year_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Year range to filter listings (format: min-max e.g. 2019-2021)."
    },
    "dealer_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter listings on dealer_name."
    },
    "dealer_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter based on dealer type (franchise or independent)."
    },
    "engine_size": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine Size to match (comma-separated values from facets API)."
    },
    "finance_emp": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with finance Estimated Monthly Payment (EMI) or range."
    },
    "mc_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter based on mc_category (Dealer, Dealership Group, etc.)."
    },
    "miles_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Miles range to filter listings (format: min-max e.g. 1000-5000)."
    },
    "photo_links": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to include only listings that have photo_links."
    },
    "postal_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on postal code around which they are listed."
    },
    "price_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Price range to filter listings (format: min-max e.g. 1000-5000)."
    },
    "body_subtype": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Body subtype to filter listings (comma-separated values from facets API)."
    },
    "engine_block": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine Block to match (comma-separated values from facets)."
    },
    "exclude_make": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Make values to exclude from results."
    },
    "mc_dealer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_dealer_id."
    },
    "range_facets": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma separated list of numeric fields for range facets."
    },
    "transmission": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their transmission (comma-separated values)."
    },
    "vehicle_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their vehicle type (comma-separated values)."
    },
    "dom_180_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last 180 Days on Market range to filter cars."
    },
    "mc_rooftop_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_rooftop_id."
    },
    "mc_website_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Website id to filter the listings."
    },
    "model_variant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Model variant filter."
    },
    "base_ext_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base exterior color to match (alias for base_exterior_color)."
    },
    "base_int_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base interior color to match (alias for base_interior_color)."
    },
    "city_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "City mileage range for UK (min-max format e.g. 1000-5000)."
    },
    "exterior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Exterior color to match (comma-separated values from facets API)."
    },
    "interior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Interior color to match (comma-separated values from facets API)."
    },
    "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)."
    },
    "mc_location_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_location_id."
    },
    "ulez_compliant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter for ULEZ compliant vehicles."
    },
    "exclude_sources": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "A list of sources to exclude from result."
    },
    "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)."
    },
    "insurance_group": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Insurance group filter for UK vehicles."
    },
    "is_vat_included": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean filter for VAT inclusion."
    },
    "last_seen_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last seen date range (YYYYMMDD-YYYYMMDD format)."
    },
    "dom_active_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Cumulative days the VEHICLE was actively listed across all dealers (survives dealer transfers), format min-max. Use for total-market-exposure analysis; otherwise prefer dos_active_range. See STALENESS METRICS above."
    },
    "dos_active_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Days the listing was active at the CURRENT dealer, format min-max. Dealer-level staleness — DEFAULT metric for \"how long was it for sale\" questions. See STALENESS METRICS above."
    },
    "fetch_all_photos": {
      "type": "boolean",
      "default": false,
      "description": "When False (default), limits photo links to single photo per listing to reduce token usage. When True, returns all photo links."
    },
    "finance_loan_apr": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with finance Annual Percentage Rate or range."
    },
    "first_seen_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen date range (YYYYMMDD-YYYYMMDD format)."
    },
    "seating_capacity": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter on vehicle seating capacity."
    },
    "car_include_lease": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean param to search for listings that include leasing options."
    },
    "engine_aspiration": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine Aspiration to match (comma-separated values from facets)."
    },
    "engine_size_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Engine size range filter (min-max format)."
    },
    "exclude_certified": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean param to exclude certified cars from search results."
    },
    "finance_loan_term": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact finance loan term or range."
    },
    "highway_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Highway mileage range for UK (min-max format e.g. 1000-5000)."
    },
    "combined_mpg_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Combined mileage range for UK (min-max format)."
    },
    "exclude_dealer_ids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "A list of dealer ids to exclude from result."
    },
    "lease_down_payment": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact down payment in lease offers or range."
    },
    "photo_links_cached": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean to include only listings with cached photo_links."
    },
    "price_change_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Price change range to filter listings."
    },
    "wheelbase_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listing on their wheelbase category."
    },
    "write_off_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Write off category filter."
    },
    "base_exterior_color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Base exterior 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)."
    },
    "car_include_finance": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Boolean param to search for listings that include finance options."
    },
    "finance_down_payment": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact down payment in finance offers or range."
    },
    "include_build_object": {
      "type": "boolean",
      "default": false,
      "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- model_variant (string, optional): Vehicle model variant\n- trim (string, optional): Trim level\n- variant (string, optional): Specific variant identifier\n- body_type (string, optional): Body style (saloon, hatchback, estate, 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 (petrol, diesel, electric, hybrid, etc.)\n- engine (string, optional): Engine description\n- engine_size (number, optional): Engine displacement\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- wheelbase_category (string, optional): Wheelbase classification\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- combined_mpg (number, optional): Combined fuel economy\n- seating_capacity (number, optional): Passenger seating capacity\n- performance_torque_ftlb (number, optional): Torque in foot-pounds\n- performance_maxspeed_mph (number, optional): Maximum speed in miles per hour\n- performance_torque_rpm (number, optional): Torque at RPM\n- performance_power_bhp (number, optional): Power in brake horsepower\n- performance_power_rpm (number, optional): Power at RPM\n- performance_torque_nm (number, optional): Torque in Newton-meters\n- performance_power_kw (number, optional): Power in kilowatts\n- performance_co2 (number, optional): CO2 emissions rating\n- euro_status (number, optional): Euro emissions standard status"
    },
    "dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Name of the dealership group to search for."
    },
    "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., \"15-5\")."
    },
    "include_dealer_object": {
      "type": "boolean",
      "default": false,
      "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, county, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- postal_code (string, optional): UK postal code\n- phone (string, optional): Contact phone number\n- seller_email (string, optional): Contact email address\n- fca_status (string, optional): FCA authorization status\n- preferred_dealer (boolean, optional): Flag indicating if this is a preferred dealer"
    },
    "exclude_mc_website_ids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "A list of MC website ids to exclude from result."
    },
    "first_seen_at_mc_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen at MC date range."
    },
    "include_relevant_links": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To include_relevant_links. Default is true."
    },
    "mc_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_dealership_group_id."
    },
    "finance_down_payment_per": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Search listings with exact down payment percentage or range."
    },
    "include_non_vin_listings": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To include non vin listings. Default is false."
    },
    "mc_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_dealership_group_name."
    },
    "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., \"15-5\")."
    },
    "exclude_write_off_category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To exclude write off category."
    },
    "first_seen_at_source_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First seen at source date range."
    },
    "mc_sub_dealership_group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_sub_dealership_group_id."
    },
    "active_inventory_date_range": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Active inventory date range filter."
    },
    "include_mc_dealership_object": {
      "type": "boolean",
      "default": false,
      "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. UK market only supports: dealer\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, county, country (string, optional): Address components\n- latitude, longitude (string, optional): Geographic coordinates\n- postal_code (string, optional): UK postal code\n- phone (string, optional): Contact phone number\n- fca_status (string, optional): FCA authorization status"
    },
    "mc_sub_dealership_group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "To filter listings on their mc_sub_dealership_group_name."
    }
  },
  "additionalProperties": false
}