UK Recreational Vehicles / Inventory

Inventory Search

get/search/rv/uk/active

Request

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

Query parameters

availability_statusstring

Filters listings by their availability status (e.g., Due in, sold, pending). Accepts multiple statuses as a comma-separated list.

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

berthsstring

Filters listings by the number of berths in the RV (e.g., 2, 4, 6). Accepts multiple values as a comma-separated list.

categorystring

(not in registry)

chassisstring

Filters listings by chassis type (e.g. Ford, Chevrolet, Mercedes-Benz). Accepts multiple values as a comma-separated list.

citystring

Filters listings by city name (e.g. London, Derby, Birmingham).

countystring

Filters listings by county name (e.g. Greater London, Lancashire). Use instead of state. Accepts multiple counties as comma-separated values.

cylindersstring

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

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.

drive_typestring

Filters listings by drive type (e.g., AWD, FWD, RWD, 4WD). Accepts multiple values as a comma-separated list.

engine_sizestring

Filters listings by engine displacement size (e.g., 2.0, 2.5, 3.5). Accepts multiple values separated by commas.

exterior_colorstring

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

exterior_length_rangestring

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

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., Petrol, Diesel, Electric, Petrol Electric Hybrid). Accepts multiple values separated by commas.

interior_colorstring

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

interior_length_rangestring

Filters listings by interior length in inches. Specify as min-max inches (e.g., 100-200).

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.

msrp_rangestring

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

mtplmstring

Filters listings by Maximum Technically Permissible Laden Mass (MTPLM) in pounds.

postal_codestring

Filters listings within the specified postal code (e.g., M5H 2N2).

price_rangestring

Filters listings by advertised price in GBP. 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.

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., arnoldclark.com, cinch.co.uk).

startinteger

Pagination offset (0-based). Default — 0. Maximum page is limited to 10,000/rows.

statestring

Alias for county. Filters listings by state/county (e.g., Greater London, Lincolnshire). Accepts multiple values as a comma-separated list.

statsstring

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

steeringstring

Filters listings by steering type (e.g., power steering). Accepts multiple values separated by commas.

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.

width_rangestring

Filters listings by vehicle width in inches. Specify as min-max inches (e.g., 60-80).

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.