# Kelley Blue Book API: Get car value

> Estimates a used car's trade-in and private-party values and ranges on Kelley Blue Book for a given mileage, ZIP code, trim and condition.

Unofficial. Not affiliated with or endorsed by Kelley Blue Book.

- Page: https://fous.com/methods/kbb.com/get-car-value
- Method: `kbb.com/get_car_value`, version 1
- Website: kbb.com
- Returns: trade-in value and range, private-party value and range, trim, valuation date, page link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `car` | string | yes | `"2020 Honda Civic"` | Year, make and model, for example 2019 Toyota Camry. |
| `trim` | string | no | `"EX"` | Trim name, for example SE; defaults to KBB's selected trim. Default "". |
| `mileage` | integer | yes | `60000` | Odometer mileage in miles, for example 45000. |
| `zip_code` | string | yes | `"90210"` | Five-digit US ZIP code, for example 30301. |
| `condition` | string | no | `"excellent"` | Car condition, for example good; defaults to good. One of "excellent", "very_good", "good", "fair". Default "good". |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "car": "2020 Honda Civic",
  "trim": "EX",
  "mileage": 60000,
  "zip_code": "90210",
  "condition": "excellent"
}
```

Its output:

```json
{
  "car": "2020 Honda Civic",
  "trim": "EX Sedan 4D",
  "mileage": 60000,
  "currency": "USD",
  "condition": "excellent",
  "page_link": "https://www.kbb.com/honda/civic/2020/ex-sedan-4d/?vehicleid=445358&mileage=60000&zipcode=90210&intent=trade-in-sell&pricetype=trade-in&condition=excellent",
  "trade_in_value": 15440,
  "valuation_date": "2026-10-23",
  "trade_in_range_low": 14290,
  "dealer_retail_value": null,
  "fair_purchase_price": null,
  "private_party_value": 19640,
  "trade_in_range_high": 16590,
  "private_party_range_low": 18590,
  "private_party_range_high": 20690
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"kbb.com/get_car_value","input":{"car":"2020 Honda Civic","trim":"EX","mileage":60000,"zip_code":"90210","condition":"excellent"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What is my 2018 Honda Accord EX worth as a trade-in with 62000 miles, ZIP 30301, in good condition?
- Private-party value range for a 2021 Subaru Outback Premium, 28,500 miles, ZIP 80202, excellent condition
- On kbb.com, how much could I get trading in a 2016 Ford F-150 XLT with 105000 miles in fair shape, ZIP 73102?
- Estimate the resale value of a 2020 Mazda CX-5 Grand Touring at 41000 miles for someone in ZIP 98101, very good condition
- What's the private sale price for a 2014 Chevrolet Malibu LT, 130,000 miles, ZIP 60601, condition fair?

## Input schema

```json
{
  "type": "object",
  "required": [
    "car",
    "mileage",
    "zip_code"
  ],
  "properties": {
    "car": {
      "type": "string",
      "description": "Year, make and model, for example 2019 Toyota Camry."
    },
    "trim": {
      "type": "string",
      "default": "",
      "description": "Trim name, for example SE; defaults to KBB's selected trim."
    },
    "mileage": {
      "type": "integer",
      "minimum": 0,
      "description": "Odometer mileage in miles, for example 45000."
    },
    "zip_code": {
      "type": "string",
      "description": "Five-digit US ZIP code, for example 30301."
    },
    "condition": {
      "enum": [
        "excellent",
        "very_good",
        "good",
        "fair"
      ],
      "type": "string",
      "default": "good",
      "description": "Car condition, for example good; defaults to good."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "car",
    "trim",
    "mileage",
    "condition",
    "currency",
    "page_link",
    "trade_in_value",
    "private_party_value"
  ],
  "properties": {
    "car": {
      "type": "string"
    },
    "trim": {
      "type": "string"
    },
    "mileage": {
      "type": "integer"
    },
    "currency": {
      "type": "string"
    },
    "condition": {
      "type": "string"
    },
    "page_link": {
      "type": "string"
    },
    "trade_in_value": {
      "type": [
        "number",
        "null"
      ]
    },
    "valuation_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "trade_in_range_low": {
      "type": [
        "number",
        "null"
      ]
    },
    "dealer_retail_value": {
      "type": [
        "number",
        "null"
      ]
    },
    "fair_purchase_price": {
      "type": [
        "number",
        "null"
      ]
    },
    "private_party_value": {
      "type": [
        "number",
        "null"
      ]
    },
    "trade_in_range_high": {
      "type": [
        "number",
        "null"
      ]
    },
    "private_party_range_low": {
      "type": [
        "number",
        "null"
      ]
    },
    "private_party_range_high": {
      "type": [
        "number",
        "null"
      ]
    }
  }
}
```

## See more

- [Kelley Blue Book API: Get KBB car review](https://fous.com/methods/kbb.com/get-car-review.md): Gets Kelley Blue Book's expert and consumer ratings, trim prices with the KBB Fair Purchase Price, fuel economy, pros, cons and the expert review's opening verdict for a car model by year, make and model. Some details are unavailable for certain model years.
- [Cars.com API: Search listings](https://fous.com/methods/cars.com/search-cars.md): Searches Cars.com car listings for a make and model around a US ZIP code within a radius, optionally by condition (new, used or certified pre-owned) and maximum price, in Cars.com search order.
- [CarGurus API: Get used car market value](https://fous.com/methods/cargurus.com/get-market-value.md): Gets the current average used asking price, the CarGurus price range and the 12-month price history for a model year (all trims), from CarGurus price trends.
- [Autotrader API: Search cars](https://fous.com/methods/autotrader.com/search-cars.md): Searches Autotrader car listings near a US ZIP code by make and model, with condition, price, year and distance filters. Returns up to 100 listings in site order.
- [CARFAX API: Search used cars](https://fous.com/methods/carfax.com/search-cars.md): Searches CARFAX used-car listings for a make and model near a US ZIP code, in CARFAX order, with listing details and free vehicle-history highlights. Paid full history reports are not included.
- [CarGurus API: Search cars for sale](https://fous.com/methods/cargurus.com/search-cars.md): Searches new and used cars for sale near a US ZIP code for a make and model, with prices, dealer details and CarGurus deal ratings. Used cars come first, then new cars, each in CarGurus order; market difference is positive below market and negative above.
- [Carvana API: Search used cars](https://fous.com/methods/carvana.com/search-cars.md): Searches Carvana's used-car inventory by make and model, with optional price, year, mileage and ZIP filters, and returns each car's price, estimated monthly payment, mileage and delivery or pickup estimate for the ZIP.
- [CarMax API: Search used cars](https://fous.com/methods/carmax.com/search-cars.md): Searches CarMax used cars by make and model with optional ZIP, distance, year, price and mileage filters, keeping CarMax's order. Pages expose only the first 48 cars; distance is CarMax's distance from the selected local store, and larger limits or narrow distance filters may return fewer matches.
- [All Kelley Blue Book methods](https://fous.com/methods/kbb.com.md)
