CarMax car search

GET https://api.api.sh/carmax/v1/search
1 credit / call automotive try it in the playground →

Used cars in CarMax's nationwide inventory, 24 per page (up to 48 with limit): price, price drops, mileage, VIN, specs, MPG, features, highlights, customer rating, the store and transfer (shipping) details. Filter by make, model, keyword, any facet segment (filters: colors, body types, drivetrain, fuel, features, packages, doors, size...), year, price and mileage ranges, highway MPG, ZIP and radius. Every response also lists the site's filters with values, segments and counts. Pass next_page back as page; null on the last page.

Every response includes credits_used: the credits this call cost.

Part of the CarMax API: 7 endpoints with prices, use cases and example responses.

Parameters

nametypedescription
make string Make, e.g. toyota. Example: toyota
model string Model (needs make), e.g. camry. Example: camry
filters string Comma-separated facet segments from filters[].values[].segment, e.g. white,hybrid,all-wheel-drive,sedans,leather-seats.
keyword string Free-text search, e.g. camry hybrid.
min_year integer Earliest model year.
max_year integer Latest model year.
min_price integer Minimum price in USD.
max_price integer Maximum price in USD.
min_mileage integer Minimum miles.
max_mileage integer Maximum miles.
min_mpg_highway integer Minimum highway MPG.
zip string ZIP code the distances and nearest store are based on (default 90210).
radius string Miles from the ZIP, or nationwide (default: nationwide, including cars that can be shipped).
local_only true | false true = only cars at stores near the ZIP (no transfers).
sort best_match | soonest_available | price_asc | price_desc | mileage_asc | mileage_desc | year_desc | year_asc | newest Sort order.
url string A carmax.com search link (/cars/...) used as-is instead of the filters.
limit integer Cars per page (1-48, default 24).
page integer Page number.

Every endpoint also takes fresh, raw, fields (see lean responses and caching).

Example

curl "https://api.api.sh/carmax/v1/search?make=toyota&model=camry" \
  -H "x-api-key: $APISH_KEY"

Response

A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).

Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)

{"total": 1252,"page": 1,"count": 24,"next_page": 2,"applied_filters": {"make": "toyota","model": "camry","zip": null,"radius": null,"local_only": false,"sort": "best_match"},"selected": [{"name": "make","value": "toyota","label": "Toyota"},{"name": "model","value": "camry","label": "Camry"}],"location": {"store_id": 7126,"store_name": "Burbank","distance_miles": 8.3},"cars": [{"stock_number": 28861525,"url": "https://www.carmax.com/car/28861525","vin": "4T1G11AK6LU351313","year": 2020,"make": "Toyota","model": "Camry","trim": "SE","body": "4D Sedan","price": 23998,"original_price": null,"price_drop": false,"mileage": 47076,"exterior_color": "White","interior_color": "Gray","transmission": "Automatic","drivetrain": "Front Wheel Drive","engine": {"type": "Gas","size": "2.5L","cylinders": 4,"horsepower": 203,"torque": 184},"mpg": {"city": 28,"highway": 39},"battery_range_miles": null,"features": ["Power Locks","Power Windows","… 19 more"],"highlights": ["lowMilesPerYear","fuelEfficient","… 1 more"],"rating": 4.769230769230769,"review_count": 39,"store": {"id": 7810,"name": "LAX","city": "Inglewood","state": "CA","distance_miles": 15.2},"transfer": {"fee": 0,"type": "test-drive","text": "Test drive today at","min_days": 3,"max_days": 3,"transferable": true},"new_arrival": false,"coming_soon": false,"reserved": false,"listed_at": "2026-10-28T17:40:06.148Z","image": "https://img2.carmax.com/assets/28861525/hero.jpg?width=800"},{"stock_number": 29120934,"url": "https://www.carmax.com/car/29120934","vin": "4T1G11AK3LU957524","year": 2020,"make": "Toyota","model": "Camry","trim": "SE","body": "4D Sedan","price": 23998,"original_price": null,"price_drop": false,"mileage": 42836,"exterior_color": "Gray","interior_color": "Black","transmission": "Automatic","drivetrain": "Front Wheel Drive","engine": {"type": "Gas","size": "2.5L","cylinders": 4,"horsepower": 203,"torque": 184},"mpg": {"city": 28,"highway": 39},"battery_range_miles": null,"features": ["SiriusXM Trial Available","Android Auto","… 19 more"],"highlights": ["singleOwner","lowMilesPerYear","… 2 more"],"rating": 4.769230769230769,"review_count": 39,"store": {"id": 7810,"name": "LAX","city": "Inglewood","state": "CA","distance_miles": 15.2},"transfer": {"fee": 0,"type": "test-drive","text": "Test drive today at","min_days": 3,"max_days": 3,"transferable": true},"new_arrival": false,"coming_soon": false,"reserved": false,"listed_at": "2026-10-10T21:31:49.06Z","image": "https://img2.carmax.com/assets/29120934/hero.jpg?width=800"},"… 22 more"],"filters": [{"name": "PriceDrop","label": "Price drops","type": "Flag"},{"name": "Distance","label": "Distance or Shipping","type": "Distance"},"… 17 more"],"cached": false,"credits_used": 1}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.