TrueCar Search API returns one page of public TrueCar inventory for a make and model, used or new, around a US ZIP code. Each listing carries the VIN, year, trim, mileage, specs, price with USD currency, TrueCar price quality rating (excellent, great, good, fair or high), vehicle history counts, stock number, listing date, image, public listing url and the dealer with distance in miles. The response adds total_count, page, per_page (30), has_more and the search location. A valid empty result (unknown model, page past the end) is a successful response; an upstream failure is not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
2 required parameters needed before sending a request.
4 optional filters available.
string
Required
TrueCar make slug: lowercase letters, numbers and hyphens, e.g. toyota or land-rover. Example: toyota.
example
string
Required
TrueCar model slug: lowercase letters, numbers and hyphens, e.g. camry or model-3. Example: camry.
example
string
Optional
used or new. Defaults to used.
example
integer
Optional
1-based page number, 30 listings per page, up to page 100. Defaults to 1.
1
string
Optional
5-digit US ZIP code the search is centred on. Defaults to 10118 (New York, NY). Example: 90210.
example
integer
Optional
Search radius in miles around the postal code, 1 to 500. Defaults to 75 for used and 150 for new cars. Example: 50.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"has_more": true,
"listings": [
{
"mpg": {
"city": 25,
"highway": 35,
"combined": 28
},
"url": "https://www.truecar.com/used-cars-for-sale/listing/4T4BF1FK0ER402253/",
"vin": "4T4BF1FK0ER402253",
"make": "Toyota",
"trim": "LE",
"year": 2014,
"model": "Camry",
"price": 15305,
"style": "2014 LE I4 Automatic",
"dealer": {
"id": 18785,
"city": "Brooklyn",
"name": "Bay Ridge Subaru",
"state": "NY",
"address": "1819 Cropsey Ave",
"postal_code": "11214",
"distance_miles": 10.2
},
"engine": "2.5L Inline-4 Gas",
"mileage": 12131,
"currency": "USD",
"position": 1,
"condition": "used",
"fuel_type": "Gas",
"image_url": "https://listings-prod.tcimg.net/listings/18785/53/22/4T4BF1FK0ER402253/001_2026100807.jpg",
"listed_at": "2026-09-26T18:45:00Z",
"make_slug": "toyota",
"body_style": "Sedan",
"drive_type": "Front Wheel Drive",
"model_slug": "camry",
"owner_count": 1,
"key_features": [
"Bluetooth"
],
"stock_number": "U7616",
"transmission": "Automatic",
"price_quality": "excellent",
"accident_count": 0,
"exterior_color": "Magnetic Gray Metallic",
"interior_color": "Ash",
"has_clean_title": true,
"is_certified_pre_owned": false
},
{
"mpg": {
"city": 28,
"highway": 39,
"combined": 32
},
"url": "https://www.truecar.com/used-cars-for-sale/listing/4T1C11AK5LU934227/",
"vin": "4T1C11AK5LU934227",
"make": "Toyota",
"trim": "LE",
"year": 2020,
"model": "Camry",
"price": 18568,
"style": "LE FWD Automatic",
"dealer": {
"id": 3496,
"city": "Fairlawn",
"name": "Glen Toyota",
"state": "NJ",
"address": "23-07 Maple Avenue",
"postal_code": "07410",
"distance_miles": 15.8
},
"engine": "2.5L Inline-4 Gas",
"mileage": 81214,
"currency": "USD",
"position": 2,
"condition": "used",
"fuel_type": "Gas",
"image_url": "https://listings-prod.tcimg.net/listings/3496/27/42/4T1C11AK5LU934227/001_2026100803.jpg",
"listed_at": "2026-09-22T18:45:00Z",
"make_slug": "toyota",
"body_style": "Sedan",
"drive_type": "Front Wheel Drive",
"model_slug": "camry",
"owner_count": 1,
"key_features": [
"Apple CarPlay",
"Android Auto",
"Adaptive Cruise Control",
"Lane Keep Assist",
"Backup Camera",
"Bluetooth"
],
"stock_number": "38037B",
"transmission": "Automatic",
"price_quality": "excellent",
"accident_count": 0,
"exterior_color": "Brownstone",
"interior_color": "Ash",
"has_clean_title": true,
"is_certified_pre_owned": true
}
],
"location": {
"city": "New York",
"state": "NY",
"postal_code": "10118",
"radius_miles": 75
},
"per_page": 30,
"total_count": 1565
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The make or model is missing or not a TrueCar slug, or the page, postal code or radius is out of range. This response is not billable.
{
"errors": {
"make": [
"A make slug is required, e.g. toyota."
]
},
"message": "The request validation failed"
}Unknown Postal Code
TrueCar could not render a search for the supplied postal code. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "search"
},
"error": {
"code": "INVALID_PARAMETER",
"message": "TrueCar rejected the request parameters. Check the postal code."
},
"success": false
}Upstream Unavailable
TrueCar is temporarily unreachable, blocked the request or answered a page without the expected data (PARSER_DRIFT). Retry later; this response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "TrueCar is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.