Recreational Vehicles / Inventory

Inventory Search

get/search/rv/active

Request

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

Query parameters

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

citystring

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

classstring

Filters listings by RV class type (e.g., Class A, Class B, Class C). Accepts multiple values as a comma-separated list.

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

doorsstring

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

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.

fresh_water_capacitystring

(not in registry)

fuel_typestring

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

gvwrstring

Filters listings by Gross Vehicle Weight Rating (GVWR) in pounds. Specify as a single value or min-max range (e.g., 5000-10000).

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.

lengthstring

Filters listings by vehicle length in inches.

length_rangestring

Filters listings by vehicle length in inches. Specify as min-max inches (e.g., 150-250).

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.

model_ostring

Filters listings by model orig (as described on the webpage). Accepts multiple values as comma-separated list.

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

number_of_awningsinteger

Filters listings by the number of awnings. Accepts multiple values as a comma-separated list.

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.

search_textstring

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

seating_capacitystring

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

slideoutsinteger

Filters listings by the number of slideouts. Accepts multiple values as a comma-separated list.

sleepsinteger

Filters listings by the number of sleeping areas. Specify as min-max range (e.g., 1-4).

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.

tokenized_search_textstring

Tokenized search within listing titles, descriptions, and other fields. Use this instead of search_text for exact matches.

transmissionstring

Filters listings by transmission type (Automatic, Manual, etc.). 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.

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.

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.