# KBB Listings

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.

- **Documentation:** [https://scrappa.co/docs/kbb-api/kbb_listings](https://scrappa.co/docs/kbb-api/kbb_listings)
- **API group:** Kelley Blue Book API
- **Endpoint:** `GET https://scrappa.co/api/kbb/v1/listings`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `zip` | string | Yes | US ZIP code for the search area, e.g. 20170. |
| `page` | integer | No | Result page, starting at 1. |
| `location` | string | No | KBB location slug from the SRP URL, e.g. herndon-va. |
| `searchRadius` | integer | No | Search radius in miles. |
| `driveGroup` | string | No | Drive group facet from the SRP filters. |
| `transmissionCode` | string | No | Transmission facet from the SRP filters. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | A public parameter is invalid. This response is not billable. |  |
|  | Kelley Blue Book did not return usable data for this request. This response is not billable. |  |
|  | The requested Kelley Blue Book page was not found. This response is not billable. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)