Cars / Dealerships

Dealerships Search

get/dealerships/car

Request

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

Query parameters

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.

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.

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.

longitudestring

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

mc_categorystring

Filters listings by MarketCheck category code. Case-insensitive.

mc_dealer_idstring

Filters listings by MarketCheck dealer ID.

mc_dealership_group_idstring

Filters listings by MarketCheck dealership group ID.

mc_dealership_group_namestring

Filters listings by dealership group name.

mc_location_idstring

Filters listings by MarketCheck location ID.

mc_rooftop_idstring

Filters listings by MarketCheck rooftop ID.

mc_sub_dealership_group_idstring

Filters listings by MarketCheck sub-dealership group ID.

mc_sub_dealership_group_namestring

Filters listings by sub-dealership group name.

mc_website_idstring

Filters listings by MarketCheck website ID.

msa_codestring

Filters listings by Metropolitan Statistical Area (MSA) code.

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.

statestring

Filters listings by US or Canadian state/province code (e.g., CA, NY, ON). Accepts multiple codes 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.