Skip to content
Scrappa Get API key
Kelley Blue Book API 1 credit/request

KBB Taxonomy

GET https://scrappa.co/api/kbb/v1/taxonomy

Return the Kelley Blue Book vehicle taxonomy: the available years, and - once a parent id is supplied - the makes for a year, the models for a make and the trims for a model. Levels below the deepest supplied id stay null, so a client can detect which parent to select next. The endpoint reads the public fdpq.syndication.kbb.com research API.

KBB Taxonomy 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/kbb/v1/taxonomy
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
Example JSON appears below when a response schema is available for this endpoint.

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

4 optional filters available.

year integer Optional

Model year, e.g. 2020.

Example value 10
makeId integer Optional

KBB make id from the years response, e.g. 47 (Subaru).

Example value 10
modelId integer Optional

KBB model id from the makes response, e.g. 280 (Forester).

Example value 10
vehicleListingType string Optional

used or new.

Example value example

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

HTTP 422

A public parameter is invalid. This response is not billable.

503

HTTP 503

Kelley Blue Book did not return usable data for this request. This response is not billable.

404

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.