Kelley Blue Book Scraper

Extract vehicle valuations from Kelley Blue Book. Get fair market price, MSRP range, trade-in value, consumer ratings, expert review scores, and fuel economy specs for any car by year, make, and model. Built for dealers, researchers, and automotive market analysis.

What this Actor does

For each vehicle you specify, the actor fetches the corresponding Kelley Blue Book page and returns a structured record. Input can be supplied as KBB URLs or as year/make/model objects — the actor normalizes both formats automatically.

Data available:

• MSRP range (minimum and maximum)
• Fair market price, trade-in value, and private party value for the base trim
• Consumer rating (1–5 scale) and review count
• KBB expert review rating (1–5 scale)
• City and highway fuel economy (MPG)
• Engine, transmission, and horsepower for the base trim
• Trim level, body style, and the full list of available trims
• Vehicle make, model, and year

Usage

Input format

Provide a vehicles array. Each entry can be:

As a URL:

{
  "vehicles": [
    "https://www.kbb.com/toyota/camry/2024/",
    "https://www.kbb.com/honda/accord/2024/"
  ]
}

As an object:

{
  "vehicles": [
    { "year": 2024, "make": "toyota", "model": "camry" },
    { "year": 2023, "make": "ford", "model": "f-150" }
  ]
}

Mixed:

{
  "vehicles": [
    "https://www.kbb.com/toyota/camry/2024/",
    { "year": 2023, "make": "honda", "model": "civic" }
  ],
  "maxItems": 10
}

Input fields

Field	Type	Required	Description
vehicles	array	Yes	List of vehicles to look up. Each entry is a KBB URL string or {year, make, model} object.
maxItems	integer	No	Maximum number of vehicle records to scrape. Useful for testing.

Output schema

Each item in the dataset corresponds to one vehicle:

Field	Type	Description
url	string	KBB vehicle page URL
year	integer	Vehicle model year
make	string	Vehicle make (manufacturer)
model	string	Vehicle model name
trim	string	Trim level (when available)
body_style	string	Body style: Sedan, SUV, Truck, etc.
msrp_min	integer	Minimum MSRP in USD
msrp_max	integer	Maximum MSRP in USD
fair_market_price	integer	KBB fair market price in USD (base trim)
trade_in_value_good	integer	Trade-in value in USD (base trim)
private_party_value	integer	Private party sale value in USD (base trim)
consumer_rating	number	Consumer rating (1–5 scale)
consumer_review_count	integer	Number of consumer reviews
expert_rating	number	KBB expert rating (1–5 scale)
mpg_city	number	EPA city fuel economy (MPG)
mpg_highway	number	EPA highway fuel economy (MPG)
engine	string	Engine description
transmission	string	Transmission type
horsepower	integer	Engine horsepower
available_trims	string	Comma-separated list of available trims
scraped_at	string	ISO timestamp when the record was scraped

Example output

{
  "url": "https://www.kbb.com/toyota/camry/2024/",
  "year": 2024,
  "make": "Toyota",
  "model": "Camry",
  "trim": "LE Sedan 4D",
  "body_style": "Sedan",
  "msrp_min": 24600,
  "msrp_max": 35400,
  "fair_market_price": 23900,
  "trade_in_value_good": 19800,
  "private_party_value": 22100,
  "consumer_rating": 3.9,
  "consumer_review_count": 349,
  "expert_rating": 4.6,
  "mpg_city": 28,
  "mpg_highway": 39,
  "engine": "4-Cyl, 2.5 Liter",
  "transmission": "Automatic",
  "horsepower": 206,
  "available_trims": "LE Sedan 4D, SE Sedan 4D, SE Nightshade Edition Sedan 4D, XLE Sedan 4D, XSE Sedan 4D, TRD Sedan 4D",
  "scraped_at": "2026-08-17T01:58:38.706Z"
}

Technical details

• Speed: fast per record, with low overhead
• Setup: none — run it as it ships
• Pace: 3 concurrent requests — deliberately conservative on this target
• Rate limiting: Automatic backoff when rate-limited

Limitations

• fair_market_price, trade_in_value_good, private_party_value, engine, transmission, and horsepower reflect the base (lowest-priced) trim; the full trim lineup and its price spread are in available_trims and msrp_min/msrp_max.
• KBB pages are available for US market vehicles only.
• Trim-level detail pages require separate URL lookups.

---

Further reading: Used Car Database Access: Listings, Auctions, and Carrier Records in Bulk