OpenDealer MCP Server

 ⟨40 unchanged words⟩ "minLength":1,"type":"string"},"class":{"description":"Off-road class. Legal when vertical=offroad. side-by-side, atv, or snowmobile.","enum":["side-by-side","atv","snowmobile"],"type":"string"},"color":{"description":"Exterior color (e.g., ⟨694 unchanged words⟩ 

 ⟨151 unchanged words⟩  code (e.g., CA, TX)"},"vertical":{"description":"Shopper vertical. Omit for every public vertical (cars today). Live verticals come from list_verticals.","minLength":1,"type":"string"},"zip":{"description":"5-digit US ZIP code ⟨11 unchanged words⟩ 

 ⟨548 unchanged words⟩ "minimum":1900,"type":"integer"},"vertical":{"description":"Shopper vertical. Omit for every public vertical (cars today). Live verticals come from list_verticals.","minLength":1,"type":"string"},"year":{"description":"Alias for vehicleModelDate. Same ⟨59 unchanged words⟩ 

 ⟨41 unchanged words⟩ ","minLength":3,"type":"string"},"vertical":{"description":"Shopper vertical. Omit for every public vertical (cars today). Live verticals come from list_verticals.","minLength":1,"type":"string"}},"required":["dealerId"],"type":"object"}

 ⟨8 unchanged words⟩ "minimum":1,"type":"integer"},"vertical":{"description":"Shopper vertical. Omit for every public vertical (cars today). Live verticals come from list_verticals.","minLength":1,"type":"string"},"vin":{"description":"17-character Vehicle Identification Number ⟨4 unchanged words⟩ 

 ⟨105 unchanged words⟩ "minLength":19,"type":"string"},"vertical":{"description":"Shopper vertical. Omit for every public vertical (cars today). Live verticals come from list_verticals.","minLength":1,"type":"string"},"view":{"default":"standard","description": ⟨21 unchanged words⟩ 

 ⟨84 unchanged words⟩ 250,"minimum":1,"type":"integer"},"vertical":{"description":"Shopper vertical. Omit for every public vertical (cars today). Live verticals come from list_verticals.","minLength":1,"type":"string"}},"type":"object"}

 ⟨653 unchanged words⟩ "minimum":1900,"type":"integer"},"vertical":{"description":"Shopper vertical. Omit for every public vertical (cars today). Live verticals come from list_verticals.","minLength":1,"type":"string"},"year":{"description":"Alias for vehicleModelDate. Same ⟨59 unchanged words⟩ 

Get high-level automotive market statistics.

Returns aggregated market data including:
• Totalinventory.totalVehicles vehicles— andsearchable listings on the live index (priced, not sold)
• inventory.activeDealers — active dealers inwith inventoryat least one priced vehicle (internet price or MSRP greater than 0). Same population as dealers_near and Shop, not every status=active account
• AveragemarketData pricing— byYMM segmentcohort snapshot medians and sample sizes
• Top makes by segment volume
• Market(canonical velocitymake indicatorslabels)
• New vs Used vs CPO breakdown

Discover availablecanonical filter valuestokens and counts from the live search index (makessame values GET /v1/vehicles accepts: make, bodybodyType typese.g. suv, fuelfuelType typese.g. gasoline, transmission e.g. automatic, drivetrain e.g. awd, plus price/year ranges). Counts match filter_vehicles totals for each token under the livesame inventory.make, condition, and location.

Call this before filter_vehicles when you need valid dimension values. Optional make, condition, certified, near, and certifiedradius scope the facet counts.

 ⟨35 unchanged words⟩ :{"minLength":1,"type":"string"},"near":{"description":"Location string (ZIP or city, state). Same as GET /v1/vehicles/facets near.","minLength":1,"type":"string"},"radius":{"description":"Search radius in miles (1-250). Omit to use the platform default of 150 miles, the same as the shop and the Runtime API.","maximum":250,"minimum":1,"type":"integer"}},"type":"object"}

 ⟨89 unchanged words⟩ "minimum":0,"type":"integer"},"q":{"description":"Whole-token filter on dealer name, slug, or city. Same as GET /v1/dealers q.","maxLength":200,"minLength":2,"type":"string"},"radius":{"description":"Search radius in miles ⟨52 unchanged words⟩ 

 ⟨21 unchanged words⟩ ,"hatchback"],"type":"string"},"body_type":{"description":"Deprecated: use bodyType. If both are set, bodyType wins.","enum":["sedan","suv","truck","coupe","van","wagon","convertible","hatchback"],"type":"string"},"certified":{"description":"Certified pre-owned only. Same ⟨50 unchanged words⟩ ,"cpo"],"type":"string"},"county":{"description":"County name","minLength":1,"type":"string"},"dealerId":{"description":"Filter to a single dealer UUID. Same as GET /v1/vehicles dealerId.","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","type":"string"},"dealerSlug":{"description":"Filter to a dealer slug. Same as GET /v1/vehicles dealerSlug.","maxLength":200,"minLength":1,"type":"string"},"drivetrain":{"description":"Drivetrain configuration. Same as ⟨7 unchanged words⟩ ,"4wd"],"type":"string"},"fields":{"description":"Sparse field selection (comma-separated). Same as GET /v1/vehicles fields.","type":"string"},"fuelType":{"description":"Fuel type. Same as ⟨8 unchanged words⟩ ,"plug-in-hybrid"],"type":"string"},"fuel_typehasImages":{"description":"Deprecated:Require useat fuelType.least Ifone bothphoto. areSame set,as fuelTypeGET wins./v1/vehicles hasImages.","enumtype":["gasolineboolean"},"diesellat",:{"electricdescription":"Latitude coordinate","hybridmaximum":90,"plug-in-hybridminimum"]:-90,"type":"stringnumber"},"limit":{"default":25,"description ⟨11 unchanged words⟩ "minimum":1,"type":"integer"},"lng":{"description":"Longitude coordinate","maximum":180,"minimum":-180,"type":"number"},"make":{"description":"Vehicle make (resolve  ⟨19 unchanged words⟩ "minimum":0,"type":"integer"},"mileage_maxmodel":{"description":"Deprecated: use mileageMax.Vehicle Ifmodel both(resolve arevia set,list_research_models mileageMaxif wins.","maximumunsure)":9007199254740991,"minimumminLength":01,"type":"integerstring"},"modelnear":{"description":"VehicleLocation modelstring (resolve viaZIP list_research_modelsor ifcity, unsurestate). Same as GET /v1/vehicles near.","minLength":1,"type":"string"},"offsetpage":{"default":01,"description":"Number of results to skip. The window is the next `limit`Page vehiclesnumber starting(1-based). atSame thisas offsetGET (default/v1/vehicles 0).page.","maximum":9007199254740991,"minimum":01,"type":"integer"},"priceChangeMax":{" ⟨65 unchanged words⟩ "minimum":0,"type":"integer"},"price_max":{"description":"Deprecated: use priceMax. If both are set, priceMax wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_min":{"description":"Deprecated: use priceMin. If both are set, priceMin wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"radius":{"description":"Search radius in miles ⟨22 unchanged words⟩ "minimum":1,"type":"integer"},"sort":{"default":"relevance","description":"Deprecated: use sortBy and sortOrder. If sortBy or sortOrder is also set, those win and this value is ignored.","enum":["relevance","price_asc","price_desc","year_desc","mileage_asc","distance_asc","price_drop"],"type":"string"},"sortBy":{"description":"Sort field. Same as GET  ⟨42 unchanged words⟩  code (e.g., CA, TX)"},"transmissionstrictLocation":{"description":"TransmissionWhen type.true, Samea asbare GETnear /v1/vehiclescity transmission.","enum":["automatic","manual","cvt"],"type":"string"},"trim":{"minLength":1,"type":"string"},"type":{"description":"Deprecated:that usematches conditionseveral states or none returns an empty collection (new,same used,as orGET cpo/v1/llm/filter). IfZIP bothand city+state are set,unchanged. conditionOmit wins.to keep the highest-population city pick. Same as GET /v1/vehicles strictLocation.","type":"stringboolean"},"vehicleConditiontransmission":{"description":"Deprecated: useTransmission conditiontype. (new,Same used,as orGET cpo)./v1/vehicles Newtransmission.", Used"enum":["automatic", and Certified are accepted. If both are set"manual", condition wins."cvt"],"type":"string"},"yearMaxvehicleModelDate":{"description":"MaximumExact model year. Same as GET /v1/vehicles yearMax.vehicleModelDate.","maximum":20302100,"minimum":19901900,"type":"integer"},"yearMinyear":{"description":"MinimumAlias modelfor year.vehicleModelDate. Same as GET /v1/vehicles yearMin.year.","maximum":20302100,"minimum":19901900,"type":"integer"},"year_maxyearMax":{"description":"Deprecated: useMaximum yearMax.model Ifyear. bothSame areas set,GET yearMax/v1/vehicles wins.yearMax.","maximum":2030,"minimum":1990,"type":"integer"},"year_minyearMin":{"description":"Deprecated: useMinimum yearMin.model Ifyear. bothSame areas set,GET yearMin/v1/vehicles wins.yearMin.","maximum":2030,"minimum":1990,"type ⟨18 unchanged words⟩ 

{"additionalProperties":false,"properties":{"dealerId":{"description":"Score this dealer when the VIN is listed at more than one rooftop. Same as GET /v1/vehicles/:vin/insights dealerId.","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","type":"string"},"dealerSlug":{"description":"Score this rooftop slug when the VIN is listed at more than one store. Same as insights dealerSlug.","maxLength":200,"minLength":1,"type":"string"},"listingId":{"description":"Canonical listing id ( ⟨30 unchanged words⟩ 

 ⟨37 unchanged words⟩ ","minLength":1,"type":"string"},"type":{"description":"Deprecated: use condition (new, used, or cpo). If both are set, condition wins. Certified maps to cpo.","type":"string"}},"type":"object"}

 ⟨51 unchanged words⟩ ,"cpo"],"type":"string"},"modelcode":{"description":"Deprecated: use cohortKey.","minLength":1,"type":"string"},"type":{"description":"Deprecated: use condition (new, used, or cpo). If both are set, condition wins. Certified maps to cpo.","type":"string"},"year":{"description":"Model year","maximum ⟨7 unchanged words⟩ 

 ⟨9 unchanged words⟩ ). Returns timeline of median/avg prices and days-on-lot. modelcode is a deprecated alias.

 ⟨58 unchanged words⟩ "minimum":7,"type":"integer"},"modelcode":{"description":"Deprecated: use cohortKey.","minLength":1,"type":"string"},"type":{"description":"Deprecated: use condition (new, used, or cpo). If both are set, condition wins. Certified maps to cpo.","type":"string"},"year":{"maximum":2030,"minimum":1990, ⟨4 unchanged words⟩ 

 ⟨41 unchanged words⟩ :{"minLength":1,"type":"string"},"type":{"description":"Deprecated: use condition (new, used, or cpo). If both are set, condition wins. Certified maps to cpo.","type":"string"}},"type":"object"}

 ⟨22 unchanged words⟩ ,"fair"],"type":"string"},"credit_tier":{"description":"Deprecated: use creditTier.","enum":["excellent","good","average","fair"],"type":"string"},"termMonths":{"anyOf":[{"const":36,"type":"number"},{"const":48,"type":"number"},{"const":60,"type":"number"},{"const":72,"type":"number"},{"const":84,"type":"number"}],"description":"Loan term in months. Same as GET /v1/finance/suggested-rates termMonths."},"term_months":{"anyOfenum":[{"const":36,"type":"number"},{"const":48,"type":"number"},{"const":60,"type":"number"},{"const":72,"type":"number"},{"const":84,"type":"number"}],"descriptiontype":"Deprecated: use termMonths.integer"}},"type":"object"}

{"additionalProperties":false,"properties":{"dealerId":{"description":"Scope lookup to a specific dealer when the VIN exists at multiple rooftops. Same as GET /v1/vehicles/:vin dealerId.","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","type":"string"},"dealerSlug":{"description":"Scope lookup by dealer slug. Same as GET /v1/vehicles/:vin dealerSlug.","maxLength":200,"minLength":1,"type":"string"},"includeSold":{"description":"When true, return sold tombstone if no live listing. Same as GET /v1/vehicles/:vin includeSold.","type":"boolean"},"listingId":{"description":"Canonical listing id ( ⟨43 unchanged words⟩ 

 ⟨20 unchanged words⟩ filter_vehicles when you need valid dimension values. Optional make/near/radiusmake, scopescondition, and certified scope the facet counts.

 ⟨35 unchanged words⟩ :{"minLength":1,"type":"string"},"near":{"description":"Location string (ZIP or city, state) for geo-scoped facets","minLength":1,"type":"string"},"radius":{"description":"Search radius in miles (1-250). Omit to use the platform default of 150 miles, the same as the shop and the Runtime API.","maximum":250,"minimum":1,"type":"integer"},"vehicleCondition":{"description":"Deprecated: use condition (new, used, or cpo). New, Used, and Certified are accepted. If both are set, condition wins.","type":"string"}},"type":"object"}

 ⟨10 unchanged words⟩  size). Use cohortKey with get_market_segment / get_market_trends. modelcode is a deprecated alias.

{"additionalProperties":false,"properties":{"certified":{"description":"Filter by certified status. Same as GET /v1/market/segments certified.","type":"boolean"},"cohortKey":{"minLength":1,"type":"string ⟨43 unchanged words⟩ "minimum":1,"type":"integer"},"modelcodemodel":{"description":"Deprecated:Filter useby cohortKey.model. Same as GET /v1/market/segments model.","minLength":1,"type":"string"},"page":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"year":{"description":"Filter by year. Same as GET /v1/market/segments year.","maximum":2030,"minimum":1990,"type":"integer"},"yearMax":{"description":"Maximum year. Same as GET /v1/market/segments yearMax.","maximum":2030,"minimum":1990,"type":"integer"},"yearMin":{"description":"Minimum year. Same as GET /v1/market/segments yearMin.","maximum":2030,"minimum":1990,"type":"integer"}},"type":"object"}

 ⟨21 unchanged words⟩ ,"hatchback"],"type":"string"},"body_type":{"description":"Deprecated: use bodyType. If both are set, bodyType wins.","enum":["sedan","suv","truck","coupe","van","wagon","convertible","hatchback"],"type":"string"},"certified":{"description":"Certified pre-owned only. Same ⟨76 unchanged words⟩ "minLength":1,"type":"string"},"dealerId":{"description":"Filter to a single dealer UUID. Same as GET /v1/vehicles/search dealerId.","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","type":"string"},"drivetrain":{"description":"Drivetrain configuration. Same as ⟨24 unchanged words⟩ ,"plug-in-hybrid"],"type":"string"},"fuel_typehasImages":{"description":"Deprecated:Require useat fuelType.least Ifone bothphoto. areSame setas GET /v1/vehicles/search hasImages.","type":"boolean"},"inventoryStatus":{"description":"Inventory fuelTypedisposition wins.filter. Same as GET /v1/vehicles/search inventoryStatus.","enum":["gasolineon_lot","dieselin_transit","electricsold","hybridreserved","plug-in-hybridall"],"type":"string"},"lat": ⟨61 unchanged words⟩ "minimum":0,"type":"integer"},"mileage_max":{"description":"Deprecated: use mileageMax. If both are set, mileageMax wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"mode":{"description":"Search mode. Use hybrid ⟨57 unchanged words⟩ "minLength":1,"type":"string"},"offsetnear":{"default":0,"description":"NumberLocation ofstring results(ZIP toor skip.city, Thestate). windowSame isas theGET next/v1/vehicles/search `limit`near.","minLength":1,"type":"string"},"page":{"default":1,"description":"Page vehiclesnumber starting(1-based). atSame thisas offsetGET (default/v1/vehicles/search 0).page.","maximum":9007199254740991,"minimum":01,"type":"integer"},"priceChangeMax":{" ⟨65 unchanged words⟩ "minimum":0,"type":"integer"},"price_max":{"description":"Deprecated: use priceMax. If both are set, priceMax wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_min":{"description":"Deprecated: use priceMin. If both are set, priceMin wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"q":{"description":"Free-text natural-language query,  ⟨104 unchanged words⟩ "minimum":0,"type":"number"},"sort":{"default":"relevance","description":"Deprecated: use sortBy and sortOrder. If sortBy or sortOrder is also set, those win and this value is ignored.","enum":["relevance","price_asc","price_desc","year_desc","mileage_asc","distance_asc","price_drop"],"type":"string"},"sortBy":{"description":"Sort field. Same as GET /v1/vehicles/v1/vehicles/search sortBy: price, vehiclemodeldate, distance, updatedat, mileage, daysonlot, make, model, pricechange.","enum":["price","vehiclemodeldate","distance","updatedat","mileage","daysonlot","make","model","pricechange"],"type":"string"},"sortOrder" ⟨45 unchanged words⟩ "minLength":1,"type":"string"},"type":{"description":"Deprecated: use condition (new, used, or cpo). If both are set, condition wins.","type":"string"},"useLlmSearchPathvehicleModelDate":{"description":"Deprecated:Exact ignored.model search_vehiclesyear. alwaysSame callsas GET /v1/vehicles/search./v1/vehicles/search vehicleModelDate.","typemaximum":"boolean"}2100,"vehicleCondition":{"description":minimum"Deprecated: use condition (new, used, or cpo). New, Used, and Certified are accepted. If both are set, condition wins."1900,"type":"stringinteger"},"viewyear":{"default":"llm","description":"Response format: llm (optimizedAlias for AI),vehicleModelDate. standardSame (fullas details),GET minimal/v1/vehicles/search (compact)year.","enummaximum":["llm","standard"2100,"minimalminimum"]:1900,"type":"stringinteger"},"yearMax":{"description":"Maximum model ⟨14 unchanged words⟩ "Minimum model year. Same as GET /v1/vehicles yearMin.","maximum":2030,"minimum":1990,"type":"integer"},"year_max":{"description":"Deprecated: use yearMax. If both are set, yearMax wins.","maximum":2030,"minimum":1990,"type":"integer"},"year_min":{"description":"Deprecated: use yearMin. If both are set, yearMin wins.","maximum":2030,"minimum":1990,"type ⟨18 unchanged words⟩ 

{"additionalProperties":false,"properties":{"bodyType":{"description":"Deprecated: useVehicle body_type.body Ifstyle. bothSame areas set,GET body_type/v1/vehicles wins.bodyType.","enum":["sedan","suv"," ⟨7 unchanged words⟩ :"string"},"body_type":{"description":"VehicleDeprecated: bodyuse style.bodyType. SameIf asboth GETare /v1/vehiclesset, body_type.bodyType wins.","enum":["sedan","suv"," ⟨82 unchanged words⟩ :"string"},"fuelType":{"description":"Deprecated: use fuel_type.Fuel Iftype. bothSame areas set,GET fuel_type/v1/vehicles wins.fuelType.","enum":["gasoline","diesel"," ⟨4 unchanged words⟩ :"string"},"fuel_type":{"description":"FuelDeprecated: type.use SamefuelType. asIf GETboth /v1/vehiclesare fuel_type.set, fuelType wins.","enum":["gasoline","diesel"," ⟨36 unchanged words⟩ :"string"},"mileageMax":{"description":"Deprecated: use mileage_max.Maximum Ifmileage. bothSame areas set,GET mileage_max/v1/vehicles wins.mileageMax.","maximum":9007199254740991,"minimum":0,"type":"integer"},"mileage_max":{"description":"MaximumDeprecated: mileage.use SamemileageMax. asIf GETboth /v1/vehiclesare mileage_max.set, mileageMax wins.","maximum":9007199254740991,"minimum":0,"type ⟨78 unchanged words⟩ :"number"},"priceMax":{"description":"Deprecated:Maximum useprice price_max.in IfUSD. bothSame areas set,GET price_max/v1/vehicles wins.priceMax.","maximum":9007199254740991,"minimum":0,"type":"integer"},"priceMin":{"description":"Deprecated:Minimum useprice price_min.in IfUSD. bothSame areas set,GET price_min/v1/vehicles wins.priceMin.","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_max":{"description":"MaximumDeprecated: priceuse inpriceMax. USD.If Sameboth asare GETset, /v1/vehiclespriceMax price_max.wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_min":{"description":"MinimumDeprecated: priceuse inpriceMin. USD.If Sameboth asare GETset, /v1/vehiclespriceMin price_min.wins.","maximum":9007199254740991,"minimum":0,"type ⟨180 unchanged words⟩ :"string"},"yearMax":{"description":"Deprecated: useMaximum year_max.model Ifyear. bothSame areas set,GET year_max/v1/vehicles wins.yearMax.","maximum":2030,"minimum":1990,"type":"integer"},"yearMin":{"description":"Deprecated: useMinimum year_min.model Ifyear. bothSame areas set,GET year_min/v1/vehicles wins.yearMin.","maximum":2030,"minimum":1990,"type":"integer"},"year_max":{"description":"MaximumDeprecated: modeluse year.yearMax. SameIf asboth GETare /v1/vehiclesset, year_max.yearMax wins.","maximum":2030,"minimum":1990,"type":"integer"},"year_min":{"description":"MinimumDeprecated: modeluse year.yearMin. SameIf asboth GETare /v1/vehiclesset, year_min.yearMin wins.","maximum":2030,"minimum":1990,"type ⟨18 unchanged words⟩ 

Price trends over time for a market segment (modelcodecohortKey). Returns timeline of median/avg prices and days-on-lot. modelcode is a deprecated alias.

 ⟨9 unchanged words⟩ offer). Optional filters: condition (new/used), term_monthstermMonths (36–84), credit_tier.creditTier.

 ⟨6 unchanged words⟩ ,"used"],"type":"string"},"creditTier":{"description":"Credit tier. Same as GET /v1/finance/suggested-rates creditTier.","enum":["excellent","good","average","fair"],"type":"string"},"credit_tier":{"description":"Deprecated: use creditTier.","enum":["excellent","good","average","fair"],"type":"string"},"termMonths":{"anyOf":[{"const":36,"type":"number"},{"const":48,"type":"number"},{"const":60,"type":"number"},{"const":72,"type":"number"},{"const":84,"type":"number"}],"description":"Loan term in months. Same as GET /v1/finance/suggested-rates termMonths."},"term_months":{"anyOf":[{"const":36, ⟨14 unchanged words⟩ {"const":84,"type":"number"}],"description":"Deprecated: use termMonths."}},"type":"object"}

Browse market segments with pricing statistics (modelcodecohortKey, median price, sample size). Use to discover modelcodescohortKey forwith get_market_segment / get_market_trends. modelcode is a deprecated alias.

{"additionalProperties":false,"properties":{"bodyType":{"description":"Deprecated: useVehicle body_type.body Ifstyle. bothSame areas set,GET body_type/v1/vehicles wins.bodyType.","enum":["sedan","suv"," ⟨7 unchanged words⟩ :"string"},"body_type":{"description":"VehicleDeprecated: bodyuse style.bodyType. SameIf asboth GETare /v1/vehiclesset, body_type.bodyType wins.","enum":["sedan","suv"," ⟨109 unchanged words⟩ :"string"},"fuelType":{"description":"Deprecated: use fuel_type.Fuel Iftype. bothSame areas set,GET fuel_type/v1/vehicles wins.fuelType.","enum":["gasoline","diesel"," ⟨4 unchanged words⟩ :"string"},"fuel_type":{"description":"FuelDeprecated: type.use SamefuelType. asIf GETboth /v1/vehiclesare fuel_type.set, fuelType wins.","enum":["gasoline","diesel"," ⟨55 unchanged words⟩ :"string"},"mileageMax":{"description":"Deprecated: use mileage_max.Maximum Ifmileage. bothSame areas set,GET mileage_max/v1/vehicles wins.mileageMax.","maximum":9007199254740991,"minimum":0,"type":"integer"},"mileage_max":{"description":"MaximumDeprecated: mileage.use SamemileageMax. asIf GETboth /v1/vehiclesare mileage_max.set, mileageMax wins.","maximum":9007199254740991,"minimum":0,"type ⟨132 unchanged words⟩ :"number"},"priceMax":{"description":"Deprecated:Maximum useprice price_max.in IfUSD. bothSame areas set,GET price_max/v1/vehicles wins.priceMax.","maximum":9007199254740991,"minimum":0,"type":"integer"},"priceMin":{"description":"Deprecated:Minimum useprice price_min.in IfUSD. bothSame areas set,GET price_min/v1/vehicles wins.priceMin.","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_max":{"description":"MaximumDeprecated: priceuse inpriceMax. USD.If Sameboth asare GETset, /v1/vehiclespriceMax price_max.wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_min":{"description":"MinimumDeprecated: priceuse inpriceMin. USD.If Sameboth asare GETset, /v1/vehiclespriceMin price_min.wins.","maximum":9007199254740991,"minimum":0,"type ⟨300 unchanged words⟩ :"string"},"yearMax":{"description":"Deprecated: useMaximum year_max.model Ifyear. bothSame areas set,GET year_max/v1/vehicles wins.yearMax.","maximum":2030,"minimum":1990,"type":"integer"},"yearMin":{"description":"Deprecated: useMinimum year_min.model Ifyear. bothSame areas set,GET year_min/v1/vehicles wins.yearMin.","maximum":2030,"minimum":1990,"type":"integer"},"year_max":{"description":"MaximumDeprecated: modeluse year.yearMax. SameIf asboth GETare /v1/vehiclesset, year_max.yearMax wins.","maximum":2030,"minimum":1990,"type":"integer"},"year_min":{"description":"MinimumDeprecated: modeluse year.yearMin. SameIf asboth GETare /v1/vehiclesset, year_min.yearMin wins.","maximum":2030,"minimum":1990,"type ⟨18 unchanged words⟩ 

{"additionalProperties":false,"properties":{"bodyType":{"description":"Deprecated: use body_type. If both are set, body_type wins.","enum":["sedan","suv","truck","coupe","van","wagon","convertible","hatchback"],"type":"string"},"body_type":{"description":"Vehicle body stylestyle. Same as GET /v1/vehicles body_type.","enum":["Sedansedan","SUVsuv","Trucktruck","Coupecoupe","Vanvan","Wagonwagon","Convertibleconvertible","Hatchbackhatchback"],"type":"string"},"certified":{"description":"FilterCertified forpre-owned CPOonly. vehiclesSame as GET /v1/vehicles certified.","type":"boolean"},"condition":{"description":"VehicleListing condition. Same as GET /v1/vehicles condition: new, used, or cpo. The value certified is a deprecated alias of cpo.","enum":["Newnew","Usedused","Certifiedcpo"],"type":"string"},"dealerId": ⟨12 unchanged words⟩ string"},"drivetrain":{"description":"Drivetrain configurationconfiguration. Same as GET /v1/vehicles drivetrain.","enum":["FWDfwd","RWDrwd","AWDawd","4WD4wd"],"type":"string"},"fuelType":{"description":"Deprecated: use fuel_type. If both are set, fuel_type wins.","enum":["gasoline","diesel","electric","hybrid","plug-in-hybrid"],"type":"string"},"fuel_type":{"description":"Fuel typetype. Same as GET /v1/vehicles fuel_type.","enum":["Gasolinegasoline","Dieseldiesel","Electricelectric","Hybridhybrid","Plug-in Hybridplug-in-hybrid"],"type":"string"},"limit": ⟨22 unchanged words⟩ "minLength":1,"type":"string"},"mileageMax":{"description":"Deprecated: use mileage_max. If both are set, mileage_max wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"mileage_max":{"description":"Maximum mileagemileage. Same as GET /v1/vehicles mileage_max.","maximum":9007199254740991,"minimum":0,"type ⟨34 unchanged words⟩ "minimum":0,"type":"integer"},"priceMax":{"description":"Deprecated: use price_max. If both are set, price_max wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"priceMin":{"description":"Deprecated: use price_min. If both are set, price_min wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_max":{"description":"Maximum price in USDUSD. Same as GET /v1/vehicles price_max.","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_min":{"description":"Minimum price in USDUSD. Same as GET /v1/vehicles price_min.","maximum":9007199254740991,"minimum":0,"type ⟨2 unchanged words⟩ ":{"default":"relevance","description":"SortDeprecated: orderuse sortBy and sortOrder. If sortBy or sortOrder is also set, those win and this value is ignored.","enum":["relevance","price_asc","price_desc","year_desc","mileage_asc"],"type":"string"},"sortBy":{"description":"Sort field. Same as GET /v1/vehicles sortBy: price, vehiclemodeldate, distance, updatedat, mileage, daysonlot, make, model, pricechange.","enum":["price","vehiclemodeldate","distance","updatedat","mileage","daysonlot","make","model","pricechange"],"type":"string"},"sortOrder":{"description":"Sort direction. Same as GET /v1/vehicles sortOrder.","enum":["asc","desc"],"type":"string"},"transmission":{"description":"Transmission typetype. Same as GET /v1/vehicles transmission.","enum":["Automaticautomatic","Manualmanual","CVTcvt"],"type":"string"},"trim": ⟨3 unchanged words⟩ "minLength":1,"type":"string"},"type":{"description":"Deprecated: use condition (new, used, or cpo). If both are set, condition wins.","type":"string"},"vehicleCondition":{"description":"Deprecated: use condition (new, used, or cpo). New, Used, and Certified are accepted. If both are set, condition wins.","type":"string"},"view":{"default":"standard","description": ⟨11 unchanged words⟩ ,"minimal"],"type":"string"},"yearMax":{"description":"Deprecated: use year_max. If both are set, year_max wins.","maximum":2030,"minimum":1990,"type":"integer"},"yearMin":{"description":"Deprecated: use year_min. If both are set, year_min wins.","maximum":2030,"minimum":1990,"type":"integer"},"year_max":{"description":"Maximum model yearyear. Same as GET /v1/vehicles year_max.","maximum":2030,"minimum":1990,"type":"integer"},"year_min":{"description":"Minimum model yearyear. Same as GET /v1/vehicles year_min.","maximum":2030,"minimum":1990,"type ⟨5 unchanged words⟩ 

Preferred structured inventory lookup when make/model/year/color/location are known.

Exact hard filters only (keywordvia mode,GET no/v1/vehicles embeddings)(same viaMeilisearch GETcollection /v1/llm/filter.as search_vehicles). Totals match the filters you pass; there is no forgiving ranking boost.pass. Shop inventory includes listings without photos, so the same filters return the same total here, on GET /v1/llm/filter, and on Shop. Resolve make/model with list_research_makes / ⟨93 unchanged words⟩ 

{"additionalProperties":false,"properties":{"bodyType":{"description":"Deprecated: use body_type. If both are set, body_type wins.","enum":["sedan","suv","truck","coupe","van","wagon","convertible","hatchback"],"type":"string"},"body_type":{"description":"Vehicle body stylestyle. Same as GET /v1/vehicles body_type.","enum":["Sedansedan","SUVsuv","Trucktruck","Coupecoupe","Vanvan","Wagonwagon","Convertibleconvertible","Hatchbackhatchback"],"type":"string"},"certified":{"description":"Certified pre-owned only. Same as GET /v1/vehicles certified.","type":"boolean"},"city":{"minLength":1,"type":"string"},"color":{"description":"Exterior color family. Same as GET /v1/vehicles color.","minLength":1,"type":"string"},"condition":{"description":"Vehicle

 ⟨31 unchanged words⟩ description":"17-character Vehicle Identification Number"}},"required":["vin"],"type":"object"}

{"additionalProperties":false,"properties":{"makecondition":{"description":"FilterListing bycondition. vehicleSame makeas GET /v1/market/* condition: new, used, or cpo. The value certified is a deprecated alias of cpo.","minLengthenum":1["new","used","cpo"],"type":"string"},"typemake":{"description":"Filter by vehicle typemake","enumminLength":[1,"Newtype":"string"},"Usedtype"]:{"description":"Deprecated: use condition (new, used, or cpo). If both are set, condition wins. Certified maps to cpo.","type":"string"}},"type":"object"}

 ⟨24 unchanged words⟩ ,"type":"string"},"condition":{"description":"Listing condition. Same as GET /v1/market/* condition: new, used, or cpo. The value certified is a deprecated alias of cpo.","enum":["new","used","cpo"],"type":"string"},"modelcode":{"description":"Legacy segment key; matches cohort_keyDeprecated: oruse modelcodecohortKey.","minLength":1,"type":"string"},"type":{"description":"ListingDeprecated: use condition (new/used/cpo)"new,"enum":["New" used,"Used or cpo). If both are set, condition wins. Certified maps to cpo."],"type":"string"},"year":{" ⟨11 unchanged words⟩ 

 ⟨23 unchanged words⟩ ,"type":"string"},"condition":{"description":"Listing condition. Same as GET /v1/market/* condition: new, used, or cpo. The value certified is a deprecated alias of cpo.","enum":["new","used","cpo"] ⟨10 unchanged words⟩ :"integer"},"modelcode":{"description":"Legacy aliasDeprecated: foruse cohortKeycohortKey.","minLength":1,"type":"string"},"type":{"description":"VehicleDeprecated: typeuse condition (Newnew, used, or Usedcpo)","enum":["New". If both are set,"Used condition wins. Certified maps to cpo."],"type":"string"},"year":{" ⟨8 unchanged words⟩ 

{"additionalProperties":false,"properties":{"condition":{"description":"Listing condition. Same as GET /v1/market/* condition: new, used, or cpo. The value certified is a deprecated alias of cpo.","enum":["new","used","cpo"] ⟨15 unchanged words⟩ :"string"},"type":{"description":"VehicleDeprecated: typeuse condition (Newnew, used, or Usedcpo)","enum":["New". If both are set,"Used condition wins. Certified maps to cpo."],"type":"string"}},"type":"object"}

 ⟨5 unchanged words⟩ :"boolean"},"condition":{"description":"VehicleListing condition. Same as GET /v1/vehicles condition: new, used, or cpo. The value certified is a deprecated alias of cpo.","enum":["Newnew","Usedused","Certifiedcpo"],"type":"string"},"make": ⟨46 unchanged words⟩ ":250,"minimum":1,"type":"integer"},"vehicleCondition":{"description":"Deprecated: use condition (new, used, or cpo). New, Used, and Certified are accepted. If both are set, condition wins.","type":"string"}},"type":"object"}

 ⟨6 unchanged words⟩ ,"type":"string"},"condition":{"description":"Listing condition. Same as GET /v1/market/* condition: new, used, or cpo. The value certified is a deprecated alias of cpo.","enum":["new","used","cpo"] ⟨18 unchanged words⟩ 1,"type":"integer"},"modelcode":{"description":"Deprecated: use cohortKey.","minLength":1,"type":"string"}," ⟨9 unchanged words⟩ 

 ⟨26 unchanged words⟩ known — it applies exact hard filters via /v1/llm/filterGET /v1/vehicles and returns trustworthy totals.

Discovery order: list_facets  ⟨98 unchanged words⟩ 

{"additionalProperties":false,"properties":{"bodyType":{"description":"Deprecated: use body_type. If both are set, body_type wins.","enum":["sedan","suv","truck","coupe","van","wagon","convertible","hatchback"],"type":"string"},"body_type":{"description":"Vehicle body stylestyle. Same as GET /v1/vehicles body_type.","enum":["Sedansedan","SUVsuv","Trucktruck","Coupecoupe","Vanvan","Wagonwagon","Convertibleconvertible","Hatchbackhatchback"],"type":"string"},"certified":{"description":"FilterCertified forpre-owned Certifiedonly. Pre-OwnedSame vehiclesas onlyGET /v1/vehicles certified.","type":"boolean"},"city":{ ⟨20 unchanged words⟩ \"black\" matches \"Crystal Black Pearl\". Same as GET /v1/vehicles color.","minLength":1,"type":"string"},"condition":{"description":"VehicleListing condition. Same as GET /v1/vehicles condition: new, used, or cpo. The value certified is a deprecated alias of cpo.","enum":["Newnew","Usedused","Certifiedcpo"],"type":"string"},"county": ⟨6 unchanged words⟩ string"},"drivetrain":{"description":"Drivetrain configurationconfiguration. Same as GET /v1/vehicles drivetrain.","enum":["FWDfwd","RWDrwd","AWDawd","4WD4wd"],"type":"string"},"fuelType":{"description":"Deprecated: use fuel_type. If both are set, fuel_type wins.","enum":["gasoline","diesel","electric","hybrid","plug-in-hybrid"],"type":"string"},"fuel_type":{"description":"Fuel typetype. Same as GET /v1/vehicles fuel_type.","enum":["Gasolinegasoline","Dieseldiesel","Electricelectric","Hybridhybrid","Plug-in Hybridplug-in-hybrid"],"type":"string"},"lat": ⟨46 unchanged words⟩ "minLength":1,"type":"string"},"mileageMax":{"description":"Deprecated: use mileage_max. If both are set, mileage_max wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"mileage_max":{"description":"Maximum mileagemileage. Same as GET /v1/vehicles mileage_max.","maximum":9007199254740991,"minimum":0,"type ⟨93 unchanged words⟩ "minimum":0,"type":"integer"},"priceChangeMax":{"description":"Maximum indexed priceChange (USD delta vs first recorded ask; use -1 to exclude unchanged listings)","type":"number"},"priceChangeMin":{"description":"Minimum indexed priceChange (USD delta vs first recorded ask; negative means a drop)","type":"number"},"priceMax":{"description":"Deprecated: use price_max. If both are set, price_max wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"priceMin":{"description":"Deprecated: use price_min. If both are set, price_min wins.","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_max":{"description":"Maximum price in USDUSD. Same as GET /v1/vehicles price_max.","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_min":{"description":"Minimum price in USDUSD. Same as GET /v1/vehicles price_min.","maximum":9007199254740991,"minimum":0,"type ⟨115 unchanged words⟩ ":{"default":"relevance","description":"SortDeprecated: orderuse forsortBy resultsand sortOrder. If sortBy or sortOrder is also set, those win and this value is ignored.","enum":["relevance","price_asc","price_desc","year_desc","mileage_asc","distance_asc","price_drop"],"type":"string"},"sortBy":{"description":"Sort field. Same as GET /v1/vehicles sortBy: price, vehiclemodeldate, distance, updatedat, mileage, daysonlot, make, model, pricechange.","enum":["price","vehiclemodeldate","distance","updatedat","mileage","daysonlot","make","model","pricechange"],"type":"string"},"sortOrder":{"description":"Sort direction. Same as GET /v1/vehicles sortOrder.","enum":["asc","desc"],"type":"string"},"state":{"description":"2-letter US state code ⟨3 unchanged words⟩ )"},"transmission":{"description":"Transmission typetype. Same as GET /v1/vehicles transmission.","enum":["Automaticautomatic","Manualmanual","CVTcvt"],"type":"string"},"trim": ⟨7 unchanged words⟩ "minLength":1,"type":"string"},"useLlmSearchPathtype":{"description":"Legacy.Deprecated: Douse notcondition set.(new, Preferused, filter_vehiclesor withcpo). labeledIf hardboth filters.are set, condition wins.","type":"string"},"useLlmSearchPath":{"description":"Deprecated: ignored. search_vehicles always calls GET /v1/vehicles/search.","type":"boolean"},"vehicleCondition":{"description":"Deprecated: use condition (new, used, or cpo). New, Used, and Certified are accepted. If both are set, condition wins.","type":"string"},"view":{"default":"llm","description": ⟨14 unchanged words⟩ ,"minimal"],"type":"string"},"yearMax":{"description":"Deprecated: use year_max. If both are set, year_max wins.","maximum":2030,"minimum":1990,"type":"integer"},"yearMin":{"description":"Deprecated: use year_min. If both are set, year_min wins.","maximum":2030,"minimum":1990,"type":"integer"},"year_max":{"description":"Maximum model yearyear. Same as GET /v1/vehicles year_max.","maximum":2030,"minimum":1990,"type":"integer"},"year_min":{"description":"Minimum model yearyear. Same as GET /v1/vehicles year_min.","maximum":2030,"minimum":1990,"type ⟨18 unchanged words⟩ 

 ⟨23 unchanged words⟩ you pass; there is no forgiving ranking boost. The Shop gridinventory alsoincludes requireslistings awithout photophotos, so itsthe countsame canfilters bereturn lower.the same total here, on GET /v1/llm/filter, and on Shop. Resolve make/model with list_research_makes / list_research_models first. Map ⟨90 unchanged words⟩ 

 ⟨13 unchanged words⟩ ":{"description":"17-character Vehicle Identification Number","pattern":"^[A-HJ-NPR-Z0-9]{17}$","type":"string"},"maxItems":5,"minItems":2,"type ⟨5 unchanged words⟩ 

{"additionalProperties":true,"properties":{"comparisoncomparisonMatrix":{"additionalProperties":{"items":{},"type":"array"},"propertyNames":{"type":"string"},"type":"object"},"summary":{"additionalProperties":true,"properties":{},"type":"object"},"type":{"enum":["vehicle_comparison","vehicle_listings"],"type":"string"},"vehicles":{"items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array ⟨2 unchanged words⟩ 

 ⟨102 unchanged words⟩ "mileage_max":{"description":"Maximum mileage","maximum":9007199254740991,"minimum":0,"type":"integer"},"model ⟨24 unchanged words⟩  at this offset (default 0).","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_max":{"description":"Maximum price in USD","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_min":{"description":"Minimum price in USD","maximum":9007199254740991,"minimum":0,"type":"integer"}, ⟨76 unchanged words⟩ 

{"additionalProperties":true,"properties":{"items":{"description":"Listings in this result. Cite each item `url`, never `detailsUrl`.","items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array"},"provenance":{"additionalProperties":false,"properties":{"asOf":{"type":"string"},"source":{"type":"string"}},"required":["asOf","source"],"type":"object"},"results":{"items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array"} ⟨3 unchanged words⟩ ,"totalResults":{"type":"number"},"type":{"enum":["vehicle_collection","VehicleCollection"],"type":"string"},"vehicles":{"items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array ⟨2 unchanged words⟩ 

 ⟨81 unchanged words⟩  at this offset (default 0).","maximum":9007199254740991,"minimum":0,"type":"integer"},"radius ⟨34 unchanged words⟩  US state code (e.g., CA, TX)","maxLength":2,"minLength":2,"type":"string"},"zip":{"description":"5-digit US ⟨13 unchanged words⟩ 

 ⟨4 unchanged words⟩ "items":{"additionalProperties":true,"properties":{"@type":{"const":"AutoDealer","type":"string"},"claimEligible":{"type":"boolean"},"name":{"type":"string"},"provenance":{"additionalProperties":false,"properties":{"asOf":{"type":"string"},"source":{"type":"string"}},"required":["asOf","source"],"type":"object"},"slug":{"type":["string","null"]},"telephone":{"type":"string"},"tier":{"type":"string"},"url":{"type":"string"},"websiteUrl":{"type":"string"}},"type":"object"},"type":"array"},"items":{"items":{"additionalProperties":true,"properties":{"@type":{"const":"AutoDealer","type":"string"},"claimEligible":{"type":"boolean"},"name":{"type":"string"},"provenance":{"additionalProperties":false,"properties":{"asOf":{"type":"string"},"source":{"type":"string"}},"required":["asOf","source"],"type":"object"},"slug":{"type":["string","null"]},"telephone":{"type":"string"},"tier":{"type":"string"},"url":{"type":"string"},"websiteUrl":{"type":"string"}},"type":"object"},"type":"array"},"provenance":{"additionalProperties":false,"properties":{"asOf":{"type":"string"},"source":{"type":"string"}},"required":["asOf","source"],"type":"object"},"total":{"type":"number"},"type":{"enum":["dealer_collection","DealerCollection"],"type":"string"}},"type":"object"}

 ⟨96 unchanged words⟩ ,"type":"string"},"mileage_max":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"model ⟨29 unchanged words⟩  at this offset (default 0).","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_max":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"price_min":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"radius ⟨51 unchanged words⟩  US state code (e.g., CA, TX)","maxLength":2,"minLength":2,"type":"string"},"transmission":{"description":"Transmission type ⟨42 unchanged words⟩ 

{"additionalProperties":true,"properties":{"items":{"description":"Listings in this result. Cite each item `url`, never `detailsUrl`.","items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array"},"provenance":{"additionalProperties":false,"properties":{"asOf":{"type":"string"},"source":{"type":"string"}},"required":["asOf","source"],"type":"object"},"results":{"items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array"} ⟨3 unchanged words⟩ ,"totalResults":{"type":"number"},"type":{"enum":["vehicle_collection","VehicleCollection"],"type":"string"},"vehicles":{"items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array ⟨2 unchanged words⟩ 

 ⟨31 unchanged words⟩ ":{"description":"17-character Vehicle Identification Number","pattern":"^[A-HJ-NPR-Z0-9]{17}$","type":"string"}},"required":["vin"],"type":"object"}

{"additionalProperties":true,"properties":{"aggregateRating@type":{"additionalPropertiesconst":true"AutoDealer","propertiestype":"string"},"claimEligible":{"type":"boolean"},"name":{"type":"objectstring"},"inventoryprovenance":{"additionalProperties":truefalse,"properties":{},"asOf":{"type":"objectstring"},"namesource":{"type":"string"}},"openingHoursrequired":{["asOf","source"],"type":"object"},"slug":{"type":["string","null"]},"telephone":{"type":"string"},"urlstier":{"additionalPropertiestype":true"string"},"propertiesurl":{"type":"string"},"websiteUrl":{"type":"objectstring"}},"type":"object"}

{"additionalProperties":true,"properties":{"provenance":{"additionalProperties":false,"properties":{"asOf":{"type":"string"},"source":{"type":"string"}},"required":["asOf","source"],"type":"object"},"type":{"const":"MarketOverview","type":"string"}},"required":["type"],"type":"object"}

 ⟨7 unchanged words⟩  certified vehicles","type":"boolean"},"modelcodecohortKey":{"description":"Model codeCohort identifierkey (unique perymm:… make/model/yearor combinationymmt:…) from list_market_segments","minLength":1,"type":"string"},"condition":{"enum":["new","used","cpo"],"type":"string"},"modelcode":{"description":"VehicleLegacy segment key; matches cohort_key or modelcode","minLength":1,"type":"string"},"type":{"description":"Listing condition (new/used/cpo)","enum":["New","Used"],"type" ⟨7 unchanged words⟩ ,"minimum":1990,"type":"integer"}},"required":["modelcode"],"type":"object"}

{"additionalProperties":true,"properties":{"cohortGrain":{"anyOf":[{"enum":["ymm","ymmt"],"type":"string"},{"type":"null"}]},"cohortKey":{"type":"string"},"condition":{"enum":["new","used","cpo"],"type":"string"},"modelcode":{"type":["string","null"]},"provenance":{"additionalProperties":false,"properties":{"asOf":{"type":"string"},"source":{"type":"string"}},"required":["asOf","source"],"type":"object"},"type":{"const":"MarketSegment","type":"string"}},"required":["type"],"type":"object"}

 ⟨3 unchanged words⟩ {"certified":{"type":"boolean"},"cohortGrain":{"enum":["ymm","ymmt"],"type":"string"},"cohortKey":{"description":"Cohort key (ymm:… or ymmt:…)","minLength":1,"type":"string"},"condition":{"enum":["new","used","cpo"],"type":"string"},"days":{"default":30,"maximum":90, ⟨3 unchanged words⟩ :"integer"},"modelcode":{"description":"MarketLegacy segmentalias modelcodefor cohortKey","minLength":1,"type":"string"} ⟨15 unchanged words⟩ ,"minimum":1990,"type":"integer"}},"required":["modelcode"],"type":"object"}

{"additionalProperties":false,"properties":{"condition":{"enum":["new","used","cpo"],"type":"string"},"limit":{"default":20,"maximum":50, ⟨23 unchanged words⟩ 

 ⟨13 unchanged words⟩ ":{"description":"17-character Vehicle Identification Number","pattern":"^[A-HJ-NPR-Z0-9]{17}$","type":"string"}},"required":["vin"],"type":"object"}

 ⟨15 unchanged words⟩ ,"type":"string"},"term_months":{"enumanyOf":[{"const":36,"type":"number"},{"const":48,"type":"number"},{"const":60,"type":"number"},{"const":72,"type":"number"},{"const":84],"type":"number"}]}},"type":"object"}

 ⟨25 unchanged words⟩ :"string"},"view":{"default":"llmstandard","description":"Response format: llm (optimized for AI), standard (full details), or minimal (compact)","enum":["llmminimal","standard","minimal"],"type":"string"},"vin":{"description":"17-character Vehicle Identification Number","pattern":"^[A-HJ-NPR-Z0-9]{17}$","type":"string"}},"type":"object"}

{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"Canonical rooftop listing idDealer (`dealerId:VIN`).or UseLotLinx forvehicle disambiguationpage. whenNOT the same VINcite appearsURL. atCite multiple`url` dealers.only.","type":["string","null"]},"urlfeedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical opendealer.shop VDP URL. Cite this torooftop shoppers;listing neverid detailsUrl(`dealerId:VIN`).", /llm/*"type":["string", or /v1/llm/* as the human listing URL."null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"vehicleIdentificationNumberunit":{"const":"mi","type":"string"},"vinvalue":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"17-characterCanonical VIN.opendealer.shop PartVDP. ofCite thethis citeURL objectonly. withNever url.cite detailsUrl.","type":"string"},"vin":{"description":"17-character VIN.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"}

{"additionalProperties":false,"properties":{"vindealerId":{"descriptionformat":"17-character Vehicle Identification Numberuuid","pattern":"^([A-HJ-NPR-Z0-90-9a-fA-F]{178}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","type":"string"},"dealerSlug":{"maxLength":200,"minLength":1,"type":"string"},"listingId":{"description":"Canonical listing id when scoping history to one rooftop","maxLength":300,"minLength":1,"type":"string"},"vin":{"description":"17-character Vehicle Identification Number"}},"required":["vin"],"type":"object"}

 ⟨27 unchanged words⟩ properties":{},"type":"object"},"type":{"const":"VehicleListingHistory","type":"string"},"vin":{"type":"string"}},"required ⟨3 unchanged words⟩ 

{"additionalProperties":true,"properties":{"attribution":{"type":"string"},"categories":{"items":{"additionalProperties":true," ⟨2 unchanged words⟩ :"object"},"type":"array"},"category":{"type":"string"},"rankingsentries":{"items":{"additionalProperties":true,"properties":{},"type":"object"},"type":"array"},"urlshopUrl":{"type":"string"},"type":{"enum":["ResearchRankingCategoryCollection","ResearchRanking"],"type":"string"}},"type":"object"}

{"additionalProperties":false,"properties":{"cohortKey":{"minLength":1,"type":"string"},"condition":{"enum":["new","used","cpo"],"type":"string"},"limit":{"maximum":100,"minimum":1, ⟨5 unchanged words⟩ ,"type":"string"},"minSampleSize":{"maximum":9007199254740991,"minimum":1,"type":"integer"},"modelcode":{"minLength":1,"type":"string"},"page":{"maximum":9007199254740991,"minimum":1,"type":"integer"}},"type":"object"}

{"additionalProperties":true,"properties":{"attribution":{"type":"string"},"make":{"additionalProperties":true,"properties":{} ⟨15 unchanged words⟩ "},{"type":"null"}]},"urlshopUrl":{"type":"string"},"type":{"const":"ResearchModel","type":"string"},"year":{"type ⟨3 unchanged words⟩ 

 ⟨155 unchanged words⟩ "mileage_max":{"description":"Maximum mileage","maximum":9007199254740991,"minimum":0,"type":"integer"},"mode ⟨83 unchanged words⟩  at this offset (default 0).","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_max":{"description":"Maximum price in USD","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_min":{"description":"Minimum price in USD","maximum":9007199254740991,"minimum":0,"type":"integer"},"q ⟨132 unchanged words⟩  US state code (e.g., CA, TX)","maxLength":2,"minLength":2,"type":"string"},"transmission":{"description":"Transmission type ⟨92 unchanged words⟩ 

{"additionalProperties":true,"properties":{"items":{"description":"Listings in this result. Cite each item `url`, never `detailsUrl`.","items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array"},"provenance":{"additionalProperties":false,"properties":{"asOf":{"type":"string"},"source":{"type":"string"}},"required":["asOf","source"],"type":"object"},"results":{"items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array"} ⟨3 unchanged words⟩ ,"totalResults":{"type":"number"},"type":{"enum":["vehicle_collection","VehicleCollection"],"type":"string"},"vehicles":{"items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array ⟨2 unchanged words⟩ 

 ⟨113 unchanged words⟩ ,"type":"string"},"mileage_max":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"mode ⟨27 unchanged words⟩  at this offset (default 0).","maximum":9007199254740991,"minimum":0,"type":"integer"},"price_max":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"price_min":{"maximum":9007199254740991,"minimum":0,"type":"integer"},"q ⟨82 unchanged words⟩ US state code (e.g., CA, TX)","maxLength":2,"minLength":2,"type":"string"},"transmission":{"description":"Transmission type" ⟨60 unchanged words⟩ ]{5}$","type":"string"}},"required":["source"],"type":"object"}

{"additionalProperties":true,"properties":{"items":{"description":"Listings in this result. Cite each item `url`, never `detailsUrl`.","items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array"},"provenance":{"additionalProperties":false,"properties":{"asOf":{"type":"string"},"source":{"type":"string"}},"required":["asOf","source"],"type":"object"},"results":{"items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array"} ⟨3 unchanged words⟩ ,"totalResults":{"type":"number"},"type":{"enum":["vehicle_collection","VehicleCollection"],"type":"string"},"vehicles":{"items":{"additionalProperties":true,"properties":{"listingIdcondition":{"enum":["new","used","cpo"],"type":"string"},"detailsUrl":{"description":"CanonicalDealer rooftopor listingLotLinx idvehicle (`dealerId:VIN`).page. UseNOT forthe disambiguationcite whenURL. theCite same`url` VINonly.","type":["string","null"]},"feedReceivedAt":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"]},"listingId":{"description":"Canonical appearsrooftop atlisting multipleid dealers.(`dealerId:VIN`).","type":["string","null"]},"mileage":{"additionalProperties":false,"properties":{"status":{"enum":["reported","unknown"],"type":"string"},"unit":{"const":"mi","type":"string"},"value":{"type":["number","null"]}},"required":["value","unit","status"],"type":"object"},"price":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"currency":{"const":"USD","type":"string"}},"required":["amount","currency"],"type":"object"},"priceChangedAt":{"type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL.VDP. Cite this to shoppers; never detailsUrl, /llm/*, or /v1/llm/* asURL theonly. humanNever listingcite URL.detailsUrl.","type":"string"},"vin":{"description":"17-character VIN. Part of the cite object with url.","type":"string"}},"required":["price","mileage","condition","feedReceivedAt","lastSeenAt"],"type":"object"},"type":"array ⟨2 unchanged words⟩ 

 ⟨24 unchanged words⟩ ":{"description":"17-character Vehicle Identification Number","pattern":"^[A-HJ-NPR-Z0-9]{17}$","type":"string"},"year":{"maximum":2030,"minimum" ⟨7 unchanged words⟩ 

 ⟨36 unchanged words⟩ 
• Name, address, phone, website
• Slug (the public handle for get_dealer and dealer_inventory; the public list does not include internal dealer UUIDs)
• Distance from search location
• Current inventory count
 ⟨5 unchanged words⟩ 

 ⟨27 unchanged words⟩ ,"type":"number"},"limit":{"default":50,"description":"Maximum number of dealers to return (1-200,). Omit to use the Runtime API default: 50)of 100.","maximum":200,"minimum":1,"type ⟨13 unchanged words⟩ :0,"description":"Number of results to skipskip. forThe paginationwindow is the next `limit` vehicles starting at this offset (default 0).","minimum":0,"type":"integer"},"radius":{"default":50,"description":"Search radius in miles (1-250,). Omit to use the platform default: 50)of 150 miles, the same as the shop and the Runtime API.","maximum":250,"minimum":1,"type ⟨33 unchanged words⟩ 

Preferred structured inventory lookup when make/model/year/color/location are known.

Uses exactExact hard filters only (keyword mode, no embeddings) via GET /v1/llm/filter. Totals match the Runtimefilters /v1/llm/filteryou path.pass; Resolvethere exactis make/modelno namesforgiving ranking boost. The Shop grid also requires a photo, so its count can be lower. Resolve make/model with list_research_makes and/ list_research_models first. Map shopper prose onto labeled keys (make, model, body,keys; price_max,use location);search_vehicles doonly notfor dumpfuzzy theNL sentenceor intoVIN-in-q search_vehicles.lookup.

Often the first step in shopping playbooks ( ⟨69 unchanged words⟩ 

 ⟨118 unchanged words⟩ :0,"description":"Number of results to skipskip. forThe paginationwindow is the next `limit` vehicles starting at this offset (default 0).","minimum":0,"type":"integer"} ⟨8 unchanged words⟩ ,"type":"integer"},"radius":{"default":50,"description":"Search radius in miles (1-250,). Omit to use the platform default: 50)of 150 miles, the same as the shop and the Runtime API.","maximum":250,"minimum":1,"type ⟨79 unchanged words⟩ 

 ⟨4 unchanged words⟩ items":{"additionalProperties":true,"properties":{"listingId":{"description":"Canonical rooftop listing id (`dealerId:VIN`). Use for disambiguation when the same VIN appears at multiple dealers.","type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL. ⟨34 unchanged words⟩ items":{"additionalProperties":true,"properties":{"listingId":{"description":"Canonical rooftop listing id (`dealerId:VIN`). Use for disambiguation when the same VIN appears at multiple dealers.","type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL. ⟨40 unchanged words⟩ "items":{"additionalProperties":true,"properties":{"listingId":{"description":"Canonical rooftop listing id (`dealerId:VIN`). Use for disambiguation when the same VIN appears at multiple dealers.","type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP  ⟨36 unchanged words⟩ 

{"additionalProperties":false,"properties":{"listingId":{"description":"Canonical listing id (`dealerId-or-slug:VIN`). Scores that rooftop when the VIN is listed at more than one store.","maxLength":300,"minLength":19,"type":"string"},"vin":{"description":"17-character Vehicle Identification Number ⟨11 unchanged words⟩ 

 ⟨60 unchanged words⟩  Prefer a slug from dealers_near or search results. A display name binds only when it matches one rooftop. Shared names (two Jay Hatfield stores, or just "Honda") return candidate slugs instead of picking one.

CRITICAL: Only use URL fields from the  ⟨9 unchanged words⟩ 

{"additionalProperties":false,"properties":{"dealerId":{"description":"Dealer identifier: UUID or slug (e.g., \"rsm-honda\"). or the full rooftop display name. Prefer the slug from dealers_neardealers_near. orA searchdisplay results.name is accepted only when it matches one rooftop; shared names return candidate slugs instead of a guess.","minLength":3,"type":"string"} ⟨4 unchanged words⟩ 

Get complete details for a specific vehicle by listingId or VIN.

When a VIN is listed at multiple dealer rooftops, a VIN-only lookup returns an envelope of every listing (type vehicle_listings) with no single-store price, seller, or url. Pass listingId to fetch one store.

Returns comprehensive Schema.org Vehicle data including:
•  ⟨92 unchanged words⟩ 

{"additionalProperties":false,"properties":{"listingId":{"description":"Canonical listing id (`dealerId-or-slug:VIN`). Preferred when the VIN is listed at multiple dealers.","maxLength":300,"minLength":19,"type":"string"},"view":{"default":"llm","description": ⟨26 unchanged words⟩ ]{17}$","type":"string"}},"required":["vin"],"type":"object"}

{"additionalProperties":true,"properties":{"listingId":{"description":"Canonical rooftop listing id (`dealerId:VIN`). Use for disambiguation when the same VIN appears at multiple dealers.","type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL. ⟨34 unchanged words⟩ 

 ⟨18 unchanged words⟩  categories. Pass a category slug (e.g., "best-suvssuvs") for the full scored ranking.

Rankings are ⟨48 unchanged words⟩ 

 ⟨4 unchanged words⟩ description":"Ranking category slug (e.g., \"best-suvs\suvs\"). Omit to list all available categories." ⟨6 unchanged words⟩ 

 ⟨34 unchanged words⟩ ,"type":"string"},"radius":{"default":50,"description":"Search radius in miles (1-250,). Omit to use the platform default: 50)of 150 miles, the same as the shop and the Runtime API.","maximum":250,"minimum":1,"type ⟨3 unchanged words⟩ 

Search for vehiclesForgiving acrossvehicle dealershipssearch (Meilisearch-backed NL + structured filtersMeilisearch).

Preferred tool order for assistants:
1. list_facetsnatural-language orq, list_research_makes/list_research_modelstypo-tolerant tomake/model/color, discoveroptional validstructured values
2.filters. filter_vehiclesUse (mapwhen shopperthe intentshopper ontoquery labeledis hardfuzzy filters)
3.or get_vehicleexploratory.

Use /filter_vehicles get_deal_scoreinstead /when research_modelmake/model/year/body/price/location forare depth

Whenknown the— askit impliesapplies analysisexact (goodhard deal?,filters safety,via budget,/v1/llm/filter timing,and dealerreturns plan),trustworthy continuetotals.

Discovery withorder: alist_facets shopping/ playbooklist_research_makes from→ initializefilter_vehicles instructions(structured) or resource opendealer://assistant/shopping-playbooks —search_vehicles do(exploratory) not→ stopget_vehicle at/ rawget_deal_score searchfor results.depth.

Location modes (choose ONE): zip+radius, lat+lng+radius, city+state+radius, county+state+radius — or embed location in q.

Forgiving matching:q modelmay variants,also colorbe families,a typo17-character tolerance.VIN Hardfor capsexact lookup.

When the ask implies analysis (price_maxdeal, yearsafety, radius) arebudget, nevertiming, relaxed.dealer Preferplan), filter_vehicles;chain doshopping notplaybooks dumpfrom shopperinitialize proseinstructions intoor q.opendealer://assistant/shopping-playbooks.

CRITICAL: CITE: Each vehicle's cite object is ⟨34 unchanged words⟩ 

 ⟨232 unchanged words⟩ :0,"description":"Number of results to skipskip. forThe paginationwindow is the next `limit` vehicles starting at this offset (default 0).","minimum":0,"type":"integer"} ⟨20 unchanged words⟩ },"q":{"description":"Free-text natural-language query.query, Youor cana pass17-character aVIN wholefor sentenceexact listing lookup. For sentences (e.g. \"new black Honda Civic sedan under $45k within 150 miles of 92672\"):, price/mileage/year/condition and zip+radius are parsed out as hard constraints, while

 ⟨4 unchanged words⟩ items":{"additionalProperties":true,"properties":{"listingId":{"description":"Canonical rooftop listing id (`dealerId:VIN`). Use for disambiguation when the same VIN appears at multiple dealers.","type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL. ⟨34 unchanged words⟩ items":{"additionalProperties":true,"properties":{"listingId":{"description":"Canonical rooftop listing id (`dealerId:VIN`). Use for disambiguation when the same VIN appears at multiple dealers.","type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL. ⟨40 unchanged words⟩ "items":{"additionalProperties":true,"properties":{"listingId":{"description":"Canonical rooftop listing id (`dealerId:VIN`). Use for disambiguation when the same VIN appears at multiple dealers.","type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP  ⟨36 unchanged words⟩ 

 ⟨133 unchanged words⟩ :0,"description":"Number of results to skipskip. forThe paginationwindow is the next `limit` vehicles starting at this offset (default 0).","minimum":0,"type":"integer"} ⟨13 unchanged words⟩ ,"type":"string"},"radius":{"default":50,"description":"Search radius in miles (1-250,). Omit to use the platform default: 50)of 150 miles, the same as the shop and the Runtime API.","maximum":250,"minimum":1,"type ⟨129 unchanged words⟩ 

 ⟨4 unchanged words⟩ items":{"additionalProperties":true,"properties":{"listingId":{"description":"Canonical rooftop listing id (`dealerId:VIN`). Use for disambiguation when the same VIN appears at multiple dealers.","type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL. ⟨34 unchanged words⟩ items":{"additionalProperties":true,"properties":{"listingId":{"description":"Canonical rooftop listing id (`dealerId:VIN`). Use for disambiguation when the same VIN appears at multiple dealers.","type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP URL. ⟨40 unchanged words⟩ "items":{"additionalProperties":true,"properties":{"listingId":{"description":"Canonical rooftop listing id (`dealerId:VIN`). Use for disambiguation when the same VIN appears at multiple dealers.","type":["string","null"]},"url":{"description":"Canonical opendealer.shop VDP  ⟨36 unchanged words⟩