Kelley Blue Book Scraper

Pricing

Rating

Developer

Actor stats

Categories

Share

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

Output schema

Each item in the dataset corresponds to one vehicle:

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.