# KBB Listing

Return the full record of one kbb.com vehicle detail page: the VIN, the mileage with its display label, the KBB Fair Purchase Price with its low and high range, the deal indicator, the display and sale prices, the incentive, the dealer fees, the price validity date, the price history, the dealer name and the gallery images from the open KBB CDN.

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

## 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 |
| --- | --- | --- | --- |
| `url` | string | Yes | kbb.com vehicle detail page URL (https://www.kbb.com/cars-for-sale/vehicle/{id}) or a used make/model/trim search page such as https://www.kbb.com/cars-for-sale/used/toyota/avalon/xle. A search page returns its most complete priced car. |

## 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)