UK Cars / Inventory

Auto-Complete

get/search/car/uk/auto-complete

Request

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

Query parameters

fieldstring

The field name for which to perform auto-completion.

inputstring

The text input string used for auto-completion queries.

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.

citystring

Filters listings by city name (e.g. London, Derby, Birmingham).

countystring

Filters listings by county name (e.g. Greater London, Lancashire). Use instead of state. Accepts multiple counties as comma-separated values.

car_location_citystring

City of the car location. Used for filtering by specific car location city.

car_location_countystring

County of the car location. Used for filtering by specific car location county.

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., arnoldclark.com, cinch.co.uk). 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.

fuel_typestring

Filters listings by fuel type (e.g., Petrol, Diesel, Electric, Petrol Electric Hybrid). 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.

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.

mmstring

Make-Model composite string from the auto-complete API. Pass the value exactly as returned (e.g., toyota|camry).

modelstring

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

postal_codestring

Filters listings within the specified postal code (e.g., M5H 2N2).

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.

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.

variantstring

Alias of trim. Filters listings by vehicle variant identifier. Accepts multiple values as comma-separated list.

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.

ymmstring

Year-Make-Model composite string from auto-completion (e.g., 2019|Toyota|Camry).

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.