Introduction

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

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.