Marketcheck Home

Introduction

Comprehensive search APIs for querying automotive inventory with minimal latency across multiple data sources.

Overview

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

There are 2 main categories of inventory search APIs:

Active Inventory Search

  • Near real-time, for sale car listings from dealers, private sellers, and auctions
  • Active data represents vehicles currently listed for sale with up-to-date pricing and condition information
EndpointDescription
/search/car/activeSearch active dealer inventory in the US and Canada
/search/car/fsbo/activeSearch active private party car listings in the US
/search/car/auction/activeSearch active inventory of auction sites

Past Inventory Search

  • Historical, expired listings data from the last 90 days
  • Vehicle may still be available for sale, but the listing (i.e., price, condition, etc.) is no longer active on the source website
  • Contains sold vehicles, expired listings and vehicles that have been removed from active inventory
  • Past data provides insights into market trends, pricing history, and vehicle availability over time
EndpointDescription
/search/car/recentsSearch expired listings from the last 90 days inventory of dealers in the US and Canada
Past Inventory Search APIs are only available for dealer inventory in the US and Canada. They do not support private party or auction listings.

Features

Extensive Filtering

You can filter search results using over 100 parameters covering every aspect of vehicle specifications, pricing, location, and listing characteristics.

Parameter Categories:

  • Vehicle specifications (make, model, year, trim, engine)
  • Pricing and financial data (price ranges, payment estimates)
  • Physical attributes (mileage, condition, exterior/interior colors)
  • Geographic constraints (location, radius, ZIP 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 ZIP 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