Cars / Dealership Syndication

Dealership Inventory Syndication

get/dealerships/inventory

Request

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

Query parameters

append_api_keyboolean

If true, the response URLs (such as cached images & relevant links) include the api_key query parameter along with value; if false, they do not. Default — true.

base_ext_colorstring

The base exterior color to filter results by (e.g. White, Black, Blue, Silver, Red). Accepts multiple colors as a comma-separated list.

base_exterior_colorstring

Alias for base_ext_color. Filters by base exterior color (comma-separated list).

base_int_colorstring

The base interior color to filter results by (e.g. Black, Brown, Beige, Red). Accepts multiple colors as a comma-separated list.

base_interior_colorstring

Alias for base_int_color. Filters by base interior color (comma-separated list).

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).

city_mpg_rangestring

Filters listings by city fuel-economy mileage. Specify as min-max MPG (e.g., 20-35).

countrystring

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

cylindersstring

Filters listings by engine cylinder count (e.g., 4, 6, 8). Accepts multiple values as a comma-separated list.

dealer_idstring

Filters listings by MarketCheck dealer ID.

dealer_namestring

Filters listings by dealer name (case-insensitive complete match, substring not supported).

dealer_typestring

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

dealership_group_namestring

Filters listings by the name of the dealership group. Accepts multiple values as a comma-separated list.

dom_180_rangestring

Filters listings by Days on Market observed over the last 180 days. Specify as min-max days (e.g., 10-50).

dom_active_rangestring

Filters listings by active Days on Market (DOM). Specify as min-max days.

dom_rangestring

Filters listings by total Days on Market (DOM). Specify as min-max days.

doorsstring

Filters listings by number of doors (e.g., 2, 4). Accepts multiple values as comma-separated list.

dos_active_rangestring

Filters listings by active Days on Site (DOS). Specify as min-max days.

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_aspirationstring

Filters listings by engine aspiration (Turbocharged, Naturally Aspirated, etc.). Accepts multiple values separated by commas.

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.

engine_size_rangestring

Filters listings by engine displacement size. Specify as min-max liters (e.g., 1.5-3.0).

exterior_colorstring

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

facet_sortstring

Sorts facet buckets. Allowed values — count (descending count, default) or index (alphabetical).

facetsstring

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

first_seen_at_mc_daysstring

Filters listings by the number of days since they were first seen by MarketCheck. Specify as min-max days. Alternative of first_seen_at_mc_range.

first_seen_at_mc_rangestring

Filters listings by the date they were first seen by MarketCheck. Specify as YYYYMMDD-YYYYMMDD (e.g., 20220523-20220631). Alternative of first_seen_at_mc_days.

first_seen_at_source_daysstring

Filters listings by the number of days since first seen on the source site. Specify as min-max days. Alternative of first_seen_at_source_range.

first_seen_at_source_rangestring

Filters listings by date first seen on the source site. Specify as YYYYMMDD-YYYYMMDD. Alternative of first_seen_at_source_days.

first_seen_daysstring

Filters listings by the number of days since they were first seen in MarketCheck inventory. Specify as min-max days. Alternative of first_seen_range.

first_seen_rangestring

Filters listings by the first seen date. Specify as YYYYMMDD-YYYYMMDD (e.g., 20220523-20220631). Alternative of first_seen_days.

fuel_typestring

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

highway_mpg_rangestring

Filters listings by highway fuel-economy mileage. Specify as min-max MPG (e.g., 25-40).

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.

include_relevant_linksboolean

If true, includes relevant links to other MarketCheck API endpoints in the response. Default — false.

interior_colorstring

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

last_seen_daysstring

Filters listings by the number of days since last seen. Specify as min-max days. Alternative of last_seen_at_range.

last_seen_rangestring

Filters listings by last seen date. Specify as YYYYMMDD-YYYYMMDD (e.g., 20220523-20220631). Alternative of last_seen_at_days.

makestring

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

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.

miles_rangestring

Filters listings by odometer reading. Specify as min-max miles (e.g., 1000-50000).

min_photo_linksinteger

Filters listings with at least the specified number of photo links (e.g. 3, 8).

min_photo_links_cachedinteger

Filters listings with at least the specified number of cached photo links (e.g. 3, 8).

modelstring

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

msa_codestring

Filters listings by Metropolitan Statistical Area (MSA) code.

msrp_rangestring

Filters listings by Manufacturer's Suggested Retail Price (MSRP). Specify as min-max USD (e.g., 20000-45000).

ownedboolean

When used with dealer_id, mc_website_id, or source, true returns listings actually owned by that dealer. Default — false.

photo_linksboolean

If true, returns only listings that contain at least one photo link. Default — false.

photo_links_cachedboolean

If true, returns only listings that contain cached photo links. Default — false.

powertrain_typestring

Filters listings by powertrain type (e.g., Combustion, BEV, HEV, MHEV, PHEV). Accepts multiple values separated by commas.

price_rangestring

Filters listings by advertised price in USD. Specify as min-max (e.g., 1000-50000).

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 — 1500. Maximum — 1500.

seating_capacitystring

Filters listings by seating capacity (e.g., 2, 5, 7). Accepts multiple values separated by commas.

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.

sourcestring

Filters listings by website domain (e.g., autotrader.com, cars.com).

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.

statsstring

Comma-separated list of numeric fields for which to return aggregate statistics (mean, max, min, count).

stock_nostring

Filters listings by dealer stock number.

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.

versionstring

Filters listings by vehicle version name.

vinstring

Filters listings by full 17-character Vehicle Identification Number (VIN).

yearstring

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

has_priceboolean

Boolean param to filter listings that have a price (true) or no price (false).

has_milesboolean

Boolean param to filter listings that have a miles (true) or no miles (false).

year_rangestring

Filters listings by model year range. Specify as min-max (e.g., 2015-2025).

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.