UK Cars / Dealerships

Dealers Search

get/dealers/car/uk

Request

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

Query parameters

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.

uk_dealer_countrystring

(not in registry)

created_at_daysstring

Filters dealerships by age in days since creation. Specify as min-max days. Alternative of created_at_range.

created_at_rangestring

Filters dealerships by creation date. Specify as YYYYMMDD-YYYYMMDD. Alternative of created_at_days.

dealer_typestring

Filters dealers by type. Allowed values — franchise, independent.

facetsstring

Field name to return bucket facets for. Accepts multiple fields as a comma-separated list.

fca_statusstring

FCA authorization status for dealers. (e.g., Authorised, Appointed Representative, Registered). Accepts multiple values as a comma-separated list.

inventory_urlstring

Filters dealerships with their domain (e.g., carmax.com).

latitudestring

Latitude component of the search location (decimal degrees). Used for geospatial queries along with longitude and radius parameters.

listing_count_rangestring

Filters dealerships by the count of active listings. Specify as min-max.

longitudestring

Longitude component of the search location (decimal degrees). Used for geospatial queries along with latitude and radius parameters.

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.

range_facetsstring

Comma-separated list of numeric field names for which to return range facets in the response.

rowsinteger

Number of results to return per request. Default — 10. Maximum — 50.

sort_bystring

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

sort_orderstring

Specifies result sort order. Allowed values — asc or desc. Default — asc.

startinteger

Pagination offset (0-based). Default — 0. Maximum page is limited to 10,000/rows.

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.