Kelley Blue Book Scraper

Extract vehicle valuations from Kelley Blue Book. Get MSRP range, 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 extracts structured data from the server-rendered HTML. Input can be supplied as KBB URLs or as year/make/model objects — the actor normalizes both formats automatically.

Data available from the SSR page:

• MSRP range (minimum and maximum)
• Consumer rating (1–5 scale) and review count
• KBB expert review rating
• City fuel economy (MPG)
• Vehicle make, model, year, and full name

Note on dynamic valuations: KBB's fair market price, trade-in values, and private party values are loaded via JavaScript after page render. These fields are populated when present in the page's data layer, but are typically null in the dataset because they are not embedded in the server-rendered HTML.

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 (JS-rendered; typically null)
trade_in_value_good	integer	Trade-in value, Good condition (JS-rendered; typically null)
trade_in_value_very_good	integer	Trade-in value, Very Good condition (JS-rendered; typically null)
private_party_value	integer	Private party sale value (JS-rendered; typically null)
dealer_retail_value	integer	Dealer retail value (JS-rendered; typically null)
consumer_rating	number	Consumer rating (1–5 scale)
consumer_review_count	integer	Number of consumer reviews
expert_rating	number	KBB expert rating
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": null,
  "body_style": null,
  "msrp_min": 24400,
  "msrp_max": 36800,
  "fair_market_price": null,
  "trade_in_value_good": null,
  "trade_in_value_very_good": null,
  "private_party_value": null,
  "dealer_retail_value": null,
  "consumer_rating": 4.4,
  "consumer_review_count": 153,
  "expert_rating": 4.6,
  "mpg_city": 32,
  "mpg_highway": null,
  "engine": null,
  "transmission": null,
  "horsepower": null,
  "available_trims": null,
  "scraped_at": "2026-06-06T17:30:00.000Z"
}

Technical details

• Crawler: CheerioCrawler (fast HTML parsing, no browser overhead)
• Proxy: US residential proxy required — KBB blocks datacenter IPs
• TLS fingerprint: impit Chrome fingerprint (built into CoreCrawler)
• Concurrency: 3 concurrent requests (conservative for residential proxy pool)
• Rate limiting: Automatic backoff when rate-limited

Limitations

• Dynamic pricing fields (fair market price, trade-in, private party) are null in most results — KBB loads these via JavaScript after page render, making them unavailable to the HTML scraper.
• KBB pages are available for US market vehicles only.
• Trim-level detail pages require separate URL lookups.