OrbTop

Kelley Blue Book Scraper

ECOMMERCE
Try on Apify

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.
Try on Apify