Heavy Equipments / Inventory

Inventory Search

get/search/heavy-equipment/active

Request

  • Base URL: https://api.marketcheck.com/v2
  • URL: https://api.marketcheck.com/v2/search/heavy-equipment/active
  • Auth: API key in query parameter api_key

Query parameters

body_typestring

Filters listings by body type (e.g., SUV, Pickup, Sedan, Hatchback, Convertible). Accepts multiple values separated by commas.

categorystring

Filters listings by Heavy Equipment category (e.g. Agriculture, Construction, Crane). Accepts multiple categories as comma-separated values.

citystring

Filters listings by city name (e.g. Los Angeles, San Francisco, Houston).

dealer_idstring

Filters listings by MarketCheck dealer ID.

dealer_namestring

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

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.

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

hours_used_rangestring

Filters listings by hours used in the case of Heavy Equipment. Specify as min-max hours (e.g., 100-500).

interior_colorstring

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

inventory_typestring

(not in registry)

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.

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.

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

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 — 10.

search_textstring

Text substring search within listing titles, descriptions, and other fields. Use tokenized_search_text instead for tokenized search.

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.

sub_categorystring

Filters RV listings by their sub-category (e.g., Travel Trailer, Fifth Wheel). Accepts multiple values as a comma-separated list.

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.

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.

zipstring

Filters listings within the specified 5-digit ZIP code.

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

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.