CarMax car search
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
| name | type | description |
|---|---|---|
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" import os, requests
res = requests.get(
"https://api.api.sh/carmax/v1/search",
params={"make": "toyota", "model": "camry"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/carmax/v1/search");
url.searchParams.set("make", "toyota");
url.searchParams.set("model", "camry");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); 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}