Inventory Search

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

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

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

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

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

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

City of the car location. Used for filtering by specific car location city.

County of the car location. Used for filtering by specific car location county.

Latitude of the car location (decimal degrees). Used for geospatial queries of car location.

Longitude of the car location (decimal degrees). Used for geospatial queries of car location.

Seller name at car location. Used for filtering by specific seller name at car location.

Street address of the car location. Used for filtering by specific car location street address.

Postal code of the car location. Used for filtering by specific car location postal code.

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

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

Filters listings by CO2 emissions rating in g/km. Specify as a single value or min-max range (e.g., 0-120).

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

Filters listings by UK country code. Allowed values - uk, england, scotland, wales, northern_ireland.

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

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

Filters listings by MarketCheck dealer ID.

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

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

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

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

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

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

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

Filters listings by drivetrain (FWD, RWD, 4WD). Accepts multiple values separated by commas.

Filters listings by engine designation (e.g., 2.0L I4, 3.5L V6, 2.5L H4). Accepts multiple values as comma-separated list.

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

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

Filters electric vehicles by battery capacity. Specify as min-max kWh (e.g., 40-100).

Filters electric vehicles by battery type (e.g., Lithium-ion, Nickel-metal hydride). Accepts multiple values as comma-separated list.

Filters electric vehicles by driving range. Specify as a single value or min-max miles (e.g., 200-400).

Excludes results from the specified dealer IDs. Accepts multiple values as a comma-separated list.

Excludes the specified makes. Accepts multiple values as a comma-separated list.

Excludes results from the specified MarketCheck website IDs. Accepts multiple values as comma-separated list.

Excludes listings from the specified sources (e.g., arnoldclark.com, cinch.co.uk). Accepts multiple values as comma-separated list.

Excludes listings with specified write-off categories (e.g., Category A, Category B, Category S, Category N). Accepts multiple values as comma-separated list.

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

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

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

FCA authorization status for dealers. (e.g., Authorised, Appointed Representative, Registered). Accepts multiple values as a comma-separated list.

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.

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.

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.

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

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.

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

Filters listings by fuel type (e.g., Petrol, Diesel, Electric, Petrol Electric Hybrid). Accepts multiple values separated by commas.

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

If true, includes listings without a VIN; if false, such listings are excluded. Default — false.

If true, adds a preferred_dealer flag to listings when they match client-specific filters. Default — false.

Filters listings by UK insurance group rating (e.g., E, 15E, etc). Accepts multiple values as comma-separated list.

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

Filters dealers by total listing count. Specify as min-max listings (e.g., 10-100).

If true, returns listings where VAT is included in the price; if false, returns listings where VAT is excluded. Default — no filter applied.

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

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

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

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

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

Comma-separated list of field names for exact matching in combination with vrm. Allowed values — year,make,model,variant,body_type,drivetrain,transmission,fuel_type.

Filters listings by MarketCheck category code. Case-insensitive.

Filters listings by MarketCheck dealer ID.

Filters listings by MarketCheck dealership group ID.

Filters listings by dealership group name.

Filters listings by MarketCheck location ID.

Filters listings by MarketCheck rooftop ID.

Filters listings by MarketCheck sub-dealership group ID.

Filters listings by sub-dealership group name.

Filters listings by MarketCheck website ID.

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

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

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

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

Filters listings by specific vehicle model variant (e.g., 320d M Sport, C220d AMG Line). Accepts multiple values as comma-separated list.

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

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

Filters listings by number of previous owners.

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

Filters listings by CO2 performance rating. Specify as min-max range (e.g., 0-150).

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

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

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

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

Filters listings by powertrain type. Accepts multiple values separated by commas.

If true, flags listings in response from preferred dealers based on client scoring. Default — false.

If true, returns listings only from preferred dealers. Default — false.

Filters listings by positive or negative price-change flag (e.g., positive, negative). Accepts multiple comma-separated values.

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

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

Search radius around the specified location in miles. Used with zip or latitude and longitude for geospatial queries.

Comma-separated list of numeric field names for which to return range facets in the response.

Number of results to return per request. Default — 10. Maximum — 50.

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

Field to sort results by. If omitted, defaults to distance when a location filter is used.

Specifies result sort order. Allowed values — asc or desc. Default — asc.

Filters listings by website domain (e.g., arnoldclark.com, cinch.co.uk).

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

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

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

Filters listings by dealer stock number.

Filters listings by transmission type (Automatic, Manual, etc.). Accepts multiple values separated by commas.

Alias of variant. Filters listings by vehicle trim (e.g., EX, Limited). Use variant instead. Accepts multiple values separated by commas.

If true, returns listings that are ULEZ (Ultra Low Emission Zone) compliant. Default — false.

Filters listings by Unique Vehicle Code identifier. Used for matching specific vehicle configurations.

Alias of trim. Filters listings by vehicle variant identifier. Accepts multiple values as comma-separated list.

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

Filters listings by vehicle registration date. Specify as YYYYMMDD-YYYYMMDD (e.g., 20200101-20231231).

Alias of vrm. Filters listings by Vehicle Registration Mark (VRM/number plate). Use instead of vrm. Accepts multiple values as comma-separated list.

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

Filters listings by Vehicle Registration Mark (VRM/number plate). Use instead of vehicle_registration_mark. Accepts multiple values as comma-separated list.

Filters listings by wheelbase category (e.g., SWB, LWB). Accepts multiple values as comma-separated list.

Filters listings by write-off category classification (e.g., Category A, Category B, Category S, Category N). Accepts multiple values as comma-separated list.

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

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

Year-Make-Model-Trim composite string(s). Each combo uses pipe separators and combinations can be comma-separated. For example, 2019|Ford|Fiesta|Zetec,2020|Ford|Fiesta|St-line. Useful for finding multiple groups of similar cars. Alternatively, you can use vrm and match for VRM-based queries.

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

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