Search new and used cars for sale
Dealer listings on TrueCar for a search, 30 per page: VIN, year, make, model, trim, price, MSRP, TrueCar's price rating, estimated lease payment, mileage, colors, engine, drivetrain, fuel economy, key features, accident and owner counts, clean-title flag, first photo, distance and the dealer (id, name, address). Filter by make/model/trim, ZIP and radius, year, price and mileage ranges, body style, fuel type, colors, drivetrain, transmission, features, certified pre-owned, recent price drop and dealer. Page with page (next value in next_page, null on the last page; up to 10,000 results per search). A dealer's whole inventory: dealer_id (from dealer.id).
Every response includes credits_used: the credits this call cost.
Part of the TrueCar API: 8 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
condition | used | new | Used (default) or new cars. Example: used |
make | string | Make slug (see /truecar/v1/makes), e.g. toyota, ford, mercedes-benz. Example: toyota |
model | string | Model slug (see /truecar/v1/models); needs make. Example: camry |
trim | string | Trim slug(s), comma-separated (e.g. se,xse); needs make and model. Trim slugs are listed by /truecar/v1/facets. |
zip | string | 5-digit US ZIP code to search around. Without it the search is nationwide. Example: 90210 |
radius | 10 | 25 | 50 | 75 | 100 | 150 | 200 | 250 | 500 | Miles around zip (default 75). |
min_year | integer | Oldest model year. |
max_year | integer | Newest model year. |
min_price | integer | Lowest price in USD. |
max_price | integer | Highest price in USD. |
min_mileage | integer | Lowest mileage. |
max_mileage | integer | Highest mileage. |
body_style | string | Comma-separated: suv, sedan, truck, hatchback, van, coupe, wagon, convertible. |
fuel_type | string | Comma-separated: gas, hybrid, plug-in-hybrid, electric, diesel, hydrogen. |
exterior_color | string | Comma-separated: white, gray, black, silver, blue, red, green, brown, orange, gold, tan, beige, yellow, purple. |
interior_color | string | Comma-separated colors, same values as exterior_color. |
drivetrain | string | Comma-separated: fwd, awd, 4wd, rwd. |
transmission | automatic | manual | Transmission. |
features | string | Comma-separated key features, e.g. apple-carplay, backup-camera, moonroof, third-row-seating, heated-steering-wheel, adaptive-cruise-control, navigation-system, remote-start, tow-package. |
certified | boolean | true: certified pre-owned only. |
price_drop | boolean | true: only cars whose price dropped recently. |
local_only | boolean | true: leave out cars a dealer delivers from far away. |
dealer_id | string | Only this dealership's cars (the dealer.id of a listing, or the id in a TrueCar dealer link). |
sort | best_match | best_deal | price_asc | price_desc | mileage_asc | mileage_desc | year_desc | year_asc | distance | newest | Order (default best_match). distance needs zip. |
page | integer | Page number (30 listings per page). Example: 1 |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/truecar/v1/search?condition=used&make=toyota&model=camry&zip=90210" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/truecar/v1/search",
params={"condition": "used", "make": "toyota", "model": "camry", "zip": "90210"},
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/truecar/v1/search");
url.searchParams.set("condition", "used");
url.searchParams.set("make", "toyota");
url.searchParams.set("model", "camry");
url.searchParams.set("zip", "90210");
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": 1861,"page": 1,"count": 30,"next_page": 2,"price_range": {"min": 3060,"max": 45580},"year_range": {"min": 2003,"max": 2026},"applied_filters": {"condition": "used","make": "toyota","model": "camry","zip": "90210"},"listings": [{"vin": "4T1C11AK6PU085389","url": "https://www.truecar.com/used-cars-for-sale/listing/4T1C11AK6PU085389/","title": "2023 Toyota Camry LE","condition": "used","certified": false,"year": 2023,"make": "Toyota","make_slug": "toyota","model": "Camry","model_slug": "camry","trim": "LE","style": "LE Automatic FWD","style_id": "93648","price": 23624,"offer_price": null,"msrp": null,"base_msrp": null,"discount_label": null,"transfer_fee": null,"price_rating": "excellent","lease_monthly": null,"mileage": 25962,"body_style": "SEDAN","exterior_color": "Ice Edge","interior_color": "Black","engine": "2.5L Inline-4 Gas","fuel_type": "Gas","transmission": "Automatic","drivetrain": "FWD","electric_range": null,"mpg": {"combined": 32,"city": 28,"highway": 39},"key_features": ["Premium Wheels","Apple CarPlay","… 6 more"],"accident_count": 0,"owner_count": 1,"clean_title": true,"stock_number": "PU085389A","listed_at": "2026-10-30T00:45:00.000Z","image": "https://listings-prod.tcimg.net/listings/1696/89/53/4T1C11AK6PU085389/001_2026110205.jpg","distance_miles": 12.3,"no_extra_dealer_fees": false,"…": "1 more fields"},{"vin": "4T1BZ1HK2JU007970","url": "https://www.truecar.com/used-cars-for-sale/listing/4T1BZ1HK2JU007970/","title": "2018 Toyota Camry XLE V6","condition": "used","certified": false,"year": 2018,"make": "Toyota","make_slug": "toyota","model": "Camry","model_slug": "camry","trim": "XLE V6","style": "XLE V6 Automatic","style_id": "58089","price": 21740,"offer_price": null,"msrp": null,"base_msrp": null,"discount_label": null,"transfer_fee": null,"price_rating": "excellent","lease_monthly": null,"mileage": 73821,"body_style": "SEDAN","exterior_color": "Wind Chill Pearl","interior_color": "Macadamia","engine": "3.5L V-6 Gas","fuel_type": "Gas","transmission": "Automatic","drivetrain": "FWD","electric_range": null,"mpg": {"combined": 26,"city": 22,"highway": 33},"key_features": ["Premium Wheels","Moonroof","… 11 more"],"accident_count": 0,"owner_count": 1,"clean_title": true,"stock_number": "JU007970","listed_at": "2026-09-30T07:45:00.000Z","image": "https://listings-prod.tcimg.net/listings/977/70/79/4T1BZ1HK2JU007970/001_2026100306.jpg","distance_miles": 24.6,"no_extra_dealer_fees": false,"…": "1 more fields"},"… 28 more"],"cached": false,"credits_used": 1}