Search used car listings on kbb.com by ZIP code and return one page of up to 40 records with the KBB Fair Purchase Price, the low and high range, the deal indicator, the VIN and the mileage. has_more comes from the live kbb.com pagination links for the search and is verified on page 2 and the last page. A ZIP with no matches returns an empty listings array and is a billable, valid empty result.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
5 optional filters available.
string
Required
US ZIP code for the search area, e.g. 20170.
example
integer
Optional
Result page, starting at 1.
1
string
Optional
KBB location slug from the SRP URL, e.g. herndon-va.
Austin, Texas
integer
Optional
Search radius in miles.
10
string
Optional
Drive group facet from the SRP filters.
example
string
Optional
Transmission facet from the SRP filters.
example
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 422
A public parameter is invalid. This response is not billable.
HTTP 503
Kelley Blue Book did not return usable data for this request. This response is not billable.
HTTP 404
The requested Kelley Blue Book page was not found. This response is not billable.
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.