Search Past 90 Days

Full reference for the search_past_90_days tool — search expired and sold vehicle listings from the last 90 days in US and Canada for historical market analysis.

Search expired and sold car listings from the last 90 days in the US and Canada. This tool is designed for historical market analysis, pricing trends, and dealer inventory turnover — not for finding active listings.

This tool returns only expired/sold listings. For currently active inventory, use search_active_cars.

Overview

PropertyValue
Tool namesearch_past_90_days
MarketsUS, Canada
DataExpired/sold listings from last 90 days
Seller typesdealer only
Default rows5 (max 50)
API endpointGET /v2/search/car/recents
BillingHigher rate than active search

Important Constraints

Location Requirement

At least one location filter is required for every query:

  • city, state, zip, dealer_id, source, or latitude + longitude + radius
  • For geo queries, radius cannot exceed 100 miles

VIN vs Listing ID

A single VIN can have multiple listing IDs — each price or mileage change creates a new listing record. When expired=false, results show listings for VINs that are still active in the market, but the specific listing record shown is the expired one. The current listing lives in the active search API.

Analytics Limitation

Unlike active search, you cannot combine facets, stats, and range_facets in a single call. Run them as separate requests.

Parameters

This tool shares most parameters with search_active_cars, plus these additional filters:

Status Filters

ParameterTypeDescription
soldboolFilter to confirmed sold listings only
expiredboolFilter by expiry status (true for expired, false for listings with active VINs)
ownedboolWhen used with dealer_id, returns listings actually owned by that dealer

Location Filters (at least one required)

ParameterTypeDescription
citystringCity name
statestring2-letter state code
zipstringZIP code
dealer_idstringDealer ID
sourcestringListing source filter
latitude + longitude + radiusfloat, float, intGeo search (radius max 100 miles)

All vehicle specification, pricing, color, timing, and analytics parameters from search_active_cars are also supported.

Use Cases

Analyze sold vehicles in a market

search_past_90_days(
  state="CA",
  make="Toyota",
  model="RAV4",
  sold=true,
  rows=20,
  sort_by="price",
  sort_order="desc"
)

Days-on-market analysis for a dealer

search_past_90_days(
  dealer_id="12345",
  stats="dom",
  rows=1
)

Discover recently sold body types

search_past_90_days(
  state="TX",
  facets="body_type|0|30",
  sold=true,
  rows=1
)

Track recent sales for a specific model

search_past_90_days(
  state="NY",
  make="BMW",
  model="X5",
  sold=true,
  sort_by="last_seen",
  sort_order="desc",
  rows=20
)

See Also