Cars / Inventory

Auto-Complete

get/search/car/auto-complete

Request

  • Base URL: https://api.marketcheck.com/v2
  • URL: https://api.marketcheck.com/v2/search/car/auto-complete
  • Auth: API key in query parameter api_key

Query parameters

body_subtypestring

Filters listings by body subtype (e.g., Crew, Extended, Regular, Extended Crew). Accepts multiple values separated by commas.

body_typestring

Filters listings by body type (e.g., SUV, Pickup, Sedan, Hatchback, Convertible). Accepts multiple values separated by commas.

car_typestring

Filters listings by inventory type. Allowed values - new, used, certified.

citystring

Filters listings by city name (e.g. Los Angeles, San Francisco, Houston).

countrystring

Filters listings by country code. Allowed values - us, ca, all. Default — us.

drivetrainstring

Filters listings by drivetrain (FWD, RWD, 4WD). Accepts multiple values separated by commas.

enginestring

Filters listings by engine designation (e.g., 2.0L I4, 3.5L V6, 2.5L H4). Accepts multiple values as comma-separated list.

engine_blockstring

Filters listings by engine block layout (V, I, H). Accepts multiple values separated by commas.

engine_sizestring

Filters listings by engine displacement size (e.g., 2.0, 2.5, 3.5). Accepts multiple values separated by commas.

exclude_dealer_idsstring

Excludes results from the specified dealer IDs. Accepts multiple values as a comma-separated list.

exclude_makestring

Excludes the specified makes. Accepts multiple values as a comma-separated list.

exclude_mc_website_idsstring

Excludes results from the specified MarketCheck website IDs. Accepts multiple values as comma-separated list.

exclude_sourcesstring

Excludes listings from the specified sources (e.g., autonation.com, carmax.com). Accepts multiple values as comma-separated list.

exterior_colorstring

Filters listings by exterior color (e.g. White, Summit White, Gun Metallic). Accepts multiple values as comma-separated list.

facet_min_countinteger

Minimum document count for a facet bucket to be returned.

fieldstring

The field name for which to perform auto-completion.

fuel_typestring

Filters listings by fuel type (e.g., Unleaded, Diesel, Electric, Premium Unleaded, Electric / Unleaded). Accepts multiple values separated by commas.

ignore_caseboolean

If true, the auto-complete search is case-insensitive. Default — true.

in_transitboolean

If true, returns listings marked as in transit; if false or omitted, no in-transit filter is applied.

include_non_vin_listingsboolean

If true, includes listings without a VIN; if false, such listings are excluded. Default — false.

inputstring

The text input string used for auto-completion queries.

interior_colorstring

Filters listings by interior color. Accepts multiple values as comma-separated list.

inventory_count_rangestring

Filters dealers by total listing count. Specify as min-max listings (e.g., 10-100).

makestring

Filters listings by vehicle make (e.g., Toyota, Ford, Mercedes-Benz). Accepts multiple values as comma-separated list.

modelstring

Filters listings by specific vehicle model (e.g., Camry). Accepts multiple values separated by commas.

radiusinteger

Search radius around the specified location in miles. Used with zip or latitude and longitude for geospatial queries.

seller_typestring

Filters auto-complete suggestions by seller type. Allowed values — dealer, fsbo, auction.

sort_bystring

Field to sort results by. If omitted, defaults to distance when a location filter is used.

statestring

Filters listings by US or Canadian state/province code (e.g., CA, NY, ON). Accepts multiple codes separated by commas.

term_countsboolean

If true, includes term frequency counts in the response. Default — false.

transmissionstring

Filters listings by transmission type (Automatic, Manual, etc.). Accepts multiple values separated by commas.

trimstring

Filters listings by vehicle trim (e.g., EX, Limited). Accepts multiple values separated by commas.

vehicle_typestring

Filters listings by vehicle type (Truck, Car). Accepts multiple values separated by commas.

yearstring

Filters listings by model year (e.g., 2020). Accepts multiple years separated by commas.

zipstring

Filters listings within the specified 5-digit ZIP code.

Response

Successful response. See the linked documentation page for the full field reference.

Changes

No recorded changes to this operation across all 1 revision of this API.