MarketCheck Home

Introduction

Comprehensive search APIs for filtering automotive inventory with minimal latency across dealer data sources.

Start here to choose between the two UK car inventory search endpoints: one for cars that UK dealers are advertising right now, and one for listings that expired or sold in the last 90 days. This overview covers what each endpoint holds and the features they share, from more than 100 filter parameters, facets and stats to radius searches around a postcode or a latitude and longitude. Request parameters and worked examples live on each endpoint's own page.

Overview

Inventory search APIs form the backbone of MarketCheck's automotive data platform. You can search through thousands of vehicle listings with extensive filtering capabilities, statistical analysis, and geographic targeting across dealer data sources.

There are 2 main categories of inventory search APIs:

Active Inventory Search

  • Near real-time inventory of vehicles actively listed for sale by dealers, with up-to-date pricing and condition details.
  • Optimized for current market analysis, inventory management, and client-facing applications.

Endpoint: /search/car/uk/active

Past Inventory Search

  • Historical, expired listings data from the last 90 days providing insights into market trends and dealer performance
  • Vehicle may still be available for sale, but the listing (i.e., price, condition, etc.) is no longer active
  • Contains sold vehicles, expired listings, and vehicles that have been removed from active inventory
  • Includes sophisticated sold vehicle identification and attribution for advanced market analysis (Understanding Attribution)
  • Past data provides insights into market trends, pricing history, vehicle availability over time, and dealer performance tracking

Endpoint: /search/car/uk/recents

Features

Extensive Filtering

You can filter search results using over 100 comprehensive parameters covering every aspect of vehicle specifications, pricing, location, and listing characteristics to precisely target your ideal inventory matches.

Parameter Categories:

  • Vehicle specifications (make, model, year, trim, engine)
  • Pricing and financial data (price ranges, payment estimates)
  • Physical attributes (mileage, condition, exterior/interior colours)
  • Geographic constraints (location, radius, postal codes)

Refer to individual API documentation for detailed parameter lists and examples.

Facets

Facets provide aggregated counts of unique values for specific fields (like make, model, year, trim) across your search results. There are two types of facets:

Field Facets

  • Get unique values and counts for categorical fields like make, model, year, trim, etc.
  • Useful for building dropdowns, filters, and search suggestions
  • Example: Get all unique makes, models in your search results

Range Facets

  • Get aggregated counts for ranges of numerical fields like price, mileage, year, etc.
  • Useful for building price sliders, mileage filters, and year ranges
  • Example: Get price ranges with counts of vehicles in each range

Refer to individual API documentation for available facets and examples.

Stats

Stats provide aggregated statistical data about numerical fields in your search results. You can get:

  • Average, minimum, maximum values for fields like price, mileage, days on market, etc.
  • Distribution of values using percentiles (e.g., 25th, 50th, 75th percentiles)

Refer to individual API documentation for available stats and examples.

Spatial Search

You can perform spatial searches using geographic coordinates (latitude/longitude) or postal codes to find vehicles within a specified radius. This allows you to target specific regions or cities for your search.

Pagination

Search results are paginated to ensure efficient data retrieval and minimize latency. You can specify the number of results per page and navigate through pages using offsets or cursors.

Refer to individual API documentation for pagination parameters and examples.

See Also