# Kelley Blue Book — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search vehicle ratings, OBD-II diagnostic codes, and current lease deals across years, makes, and models from Kelley Blue Book. Get comprehensive car information and pricing data to compare vehicles and find the best deals.

**Category:** Automotive | **Website:** [kbb.com/](https://kbb.com/) | **Docs:** [parse.bot/marketplace/0284bc02-270a-4d9a-93d5-301a12a321bf/kbb-com-api](https://parse.bot/marketplace/0284bc02-270a-4d9a-93d5-301a12a321bf/kbb-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-kbb-com-api-0284bc02/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_car_ratings

Retrieve expert ratings for a specific vehicle identified by make, model, and year. Extracts rating data from KBB vehicle pages. Available rating fields vary by vehicle and may include expert_overall, overall_rating, performance, comfort, quality, reliability, styling, and value. Some vehicles may return an empty ratings object.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | Yes | Make name in lowercase slug format (e.g. toyota, honda, ford). |
| `model` | string | Yes | Model name in lowercase slug format (e.g. camry, civic, f-150). |
| `year` | string | Yes | Vehicle model year (e.g. 2024). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kbb-com-api-0284bc02/get_car_ratings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>","model":"<string>","year":"<string>"}'
```

### get_lease_deals

Retrieve current best lease deals from Kelley Blue Book. Returns vehicles with lease offer details including monthly payment, down payment, lease duration, and MSRP. Deals are national listings scraped from KBB's best-lease-deals page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zip_code` | string | No | 5-digit US ZIP code. Accepted but deals are national listings and may not vary by location. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kbb-com-api-0284bc02/get_lease_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zip_code":"<string>"}'
```

### get_makes

Retrieve all vehicle makes available for a given model year. Each make includes a numeric makeId used to look up models via get_models, the display makeName, and an optional atcMake code object.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | Yes | Vehicle model year (e.g. 2024). Valid range: 1992 to the latest available year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kbb-com-api-0284bc02/get_makes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### get_models

Retrieve all vehicle models for a given year and make. Each model includes a numeric modelId, modelName, and the parent make information. Use makeId from get_makes as the make_id parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make_id` | string | Yes | KBB Make ID obtained from get_makes endpoint (e.g. 49 for Toyota, 18 for Honda). |
| `year` | string | Yes | Vehicle model year (e.g. 2024). Valid range: 1992 to the latest available year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kbb-com-api-0284bc02/get_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make_id":"<string>","year":"<string>"}'
```

### get_obd_codes

Retrieve OBD-II diagnostic trouble code descriptions from KBB. Currently supports powertrain (P) codes only. Returns a curated set of common codes with their titles and explanatory descriptions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Code category. Only 'P' (powertrain) is supported. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kbb-com-api-0284bc02/get_obd_codes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### get_years

Retrieve all available vehicle model years from Kelley Blue Book. Returns years from 1992 to the latest available (currently 2027). No parameters required; the full year list is returned in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kbb-com-api-0284bc02/get_years \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```