Cars / Dealership Syndication2

Cars / Dealerships3

Cars / Incentives2

Cars / Inventory5

Cars / Market Insights15

Cars / Third Party5

Cars / Vehicle History1

Cars / Vehicle Listing3

Cars / Vehicle Specs9

Heavy Equipments / Dealerships2

Heavy Equipments / Inventory2

Heavy Equipments / Vehicle Listing1

Motorcycles / Dealerships2

Motorcycles / Inventory2

Motorcycles / Vehicle Listing1

Recreational Vehicles / Dealerships2

Recreational Vehicles / Inventory2

Recreational Vehicles / Vehicle Listing1

UK Cars / Dealerships3

UK Cars / Inventory3

UK Cars / Market Insights2

UK Cars / Vehicle History1

UK Cars / Vehicle Listing2

UK Recreational Vehicles / Inventory1

UK Recreational Vehicles / Vehicle Listing1

Cars / Inventory

Past Inventory Search

get/search/car/recents

Request

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

Query parameters

active_inventory_date_rangestring

Filters listings active at least once within the specified date range. Specify as YYYYMMDD-YYYYMMDD (e.g., 20190523-20190623).

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.

carfax_1_ownerboolean

If true, returns only vehicles with a single previous owner; if false or omitted, no ownership filter is applied. Default — false.

carfax_clean_titleboolean

If true, returns only vehicles with a clean title history; if false or omitted, no title filter is applied. Default — false.

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.

dedupboolean

If true, returns only is_searchable listings irrespective of dealer_id, mc_website_id, or source. Default — false. See nodedup for the opposite behavior.

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

exclude_certifiedboolean

If true, excludes certified-pre-owned vehicles from results. Default — false. See car_type parameter for filtering by inventory type for certified vehicles.

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.

expiredboolean

If true, returns listings of expired VINs (i.e., VINs that are no longer active in the market for sale); if false, returns expired listings of VINs that are still active.

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.

finance_down_paymentstring

Filters listings by finance down-payment amount in USD. Specify a single value or a min-max range.

finance_down_payment_perstring

Filters listings by finance down-payment percentage. Specify a single value or min-max.

finance_empstring

Filters listings by finance Estimated Monthly Payment (EMP) in USD. Specify a single value or min-max.

finance_loan_aprstring

Filters listings by finance loan APR. Specify a single value or min-max.

finance_loan_termstring

Filters listings by finance loan term in months. Specify a single value or min-max months.

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_financeboolean

If true, only listings with finance offers are returned. Default — false.

include_leaseboolean

If true, only listings with lease offers are returned. Default — false.

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.

latitudestring

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

lease_down_paymentstring

Filters listings by lease down-payment amount in USD. Specify a single value or min-max.

lease_empstring

Filters listings by lease Estimated Monthly Payment (EMP) in USD. Specify a single value or min-max.

lease_termstring

Filters listings by lease term length in months. Specify a single value or min-max.

longitudestring

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

makestring

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

matchstring

Comma-separated list of field names for exact matching in combination with vins. Allowed values — year, make, model, trim, version, build_code, options_packages. Example: year,make,model or year,make,model,trim,version.

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

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

nodedupboolean

If true, returns all duplicate listings for a VIN; if false (default), duplicate listings are removed. This is the opposite of dedup.

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.

plotboolean

If true, returns up to 1000 listings for plotting instead of full listing details.

price_change_rangestring

Filters listings by the price change in USD. Since price changes can be positive or negative, specify as min|max (e.g., -5000|1000). This is a range filter.

price_rangestring

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

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.

seating_capacitystring

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

soldboolean

If true, returns listings that are inferred to be sold by MarketCheck.

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.

taxonomy_vinsstring

Comma-separated list of 10-character “squish” VINs (first 8 + 10th & 11th chars). Filters listings by build.

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.

vdp_urlstring

Filters listings by Vehicle Detail Page (VDP) URL match.

vehicle_typestring

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

vehicle_statusstring

Filters listings by vehicle status (e.g., Available, Coming Soon).

vinstring

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

vinsstring

The VINs to find similar cars around. Accepts a comma-separated list of VINs. Used in conjunction with the match parameter always. Similar parameters are ymmt and taxonomy_vins.

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

yearstring

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

year_rangestring

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

ymmtstring

Year-Make-Model-Trim composite string(s). Each combo uses pipe separators and combinations can be comma-separated. For example, 2019|Toyota|Camry|LE,2020|Honda|Civic|EX. Useful for finding multiple groups of similar cars. Alternatively, you can use vins or taxonomy_vins for VIN-based queries.

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.