Search new and used cars for sale

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

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

nametypedescription
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"

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}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.