# KBB Valuation

Return the Kelley Blue Book price assessment embedded in one kbb.com vehicle detail page: the KBB Fair Purchase Price with its low and high range, the KBB deal indicator, the display and sale prices, the incentive, the dealer fees, the price validity date and the priced history. The configured-vehicle valuation wizard is not anonymously reachable, so this endpoint reads the listing-embedded KBB price signal instead.

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

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