KBB.com Cars Scraper: Extract Used & New Car Listings at Scale

---

What Is KBB.com?

Kelley Blue Book (kbb.com) is one of the most trusted automotive marketplaces in the United States, offering new and used car listings alongside industry-standard vehicle valuations. With hundreds of thousands of active listings, manually collecting pricing trends, inventory data, or competitive intel is impractical. The KBB.com Cars Scraper automates this entirely — turning search result pages into structured, analysis-ready datasets.

---

Overview

The KBB Cars Search Scraper extracts vehicle listings from KBB.com search pages, delivering rich records with 55+ fields per car. It is built for:

• Auto dealers monitoring market pricing and competitor inventory
• Data analysts tracking depreciation trends or regional demand
• Fintech & insurance platforms enriching vehicle databases
• Developers powering car comparison or aggregator tools

The scraper handles paginated search results, respects configurable item limits, and gracefully skips failed URLs to keep bulk runs uninterrupted.

---

Input Format

{
  "urls": ["https://www.kbb.com/cars-for-sale/all"],
  "ignore_url_failures": true,
  "max_items_per_url": 50
}

Field	Type	Default	Description
urls	array	["https://www.kbb.com/cars-for-sale/all"]	One or more KBB search/listing URLs to scrape. Supports bulk entry. Filter by make, model, ZIP, price range, etc. via KBB's search UI before copying the URL.
max_items_per_url	integer	20	Maximum number of vehicle records to collect per URL. Increase for larger datasets.
ignore_url_failures	boolean	true	If true, the scraper continues running when a URL fails instead of stopping the entire run — recommended for bulk jobs.

Tip: Use KBB's search filters (make, model, year, ZIP, price range) to narrow results before copying the URL. This yields more targeted data without hitting item limits on broad queries.

---

Output Format

{
  "accelerate": false,
  "all_in_pricing": false,
  "body_styles": [
    {
      "code": "TRUCKS",
      "name": "Truck"
    }
  ],
  "body_style_sub_type": [
    {
      "name": "Fullsize Crew Cab"
    }
  ],
  "color": {
    "exterior_color": "Star White Metallic Tri-coat",
    "exterior_color_simple": "WHITE",
    "interior_color": "Space Gray",
    "interior_color_simple": "GRAY"
  },
  "days_on_site": 326,
  "description": {
    "has_more": true,
    "label": "WE DELIVER! BUY ONLINE-TEXT-EMAIL-CHAT-PHONE AND WE WILL DELIVER YOUR NEXT VEHICLE TO YOUR DOOR! FROM OUR SALES FLOOR TO YOUR DOOR! IT'S THA..."
  },
  "displacement_uom": null,
  "doors": "4",
  "drive_type": {
    "description": "All wheel drive",
    "name": "AWD4WD"
  },
  "electric_component_info": {
    "battery_range": 300,
    "battery_type": "Lithium-Ion",
    "battery_capacity": 0,
    "battery_efficiency_combined": 51,
    "battery_efficiency_city": 46,
    "battery_efficiency_highway": 56,
    "battery_energy_capacity": 410,
    "battery_maximum_charge_rate": 150,
    "charging_level_max": "DC Level 2",
    "charging_levels_all": [
      "AC Level 1",
      "AC Level 2",
      "DC Level 1",
      "DC Level 2"
    ],
    "charging_port_side": "Driver",
    "connector_types": "CCS",
    "electric_motor_count": 2,
    "epa_charge_time_at240_v": 14.6
  },
  "engine": {
    "code": "EL",
    "name": "Electric"
  },
  "fuel_type": {
    "code": "E",
    "group": "Electric",
    "name": "Electric"
  },
  "has_leather_seats": true,
  "id": 752113639,
  "images": {
    "primary": 0,
    "sources": [
      {
        "alt": "New 2025 Ford F150 Lightning Platinum",
        "src": "https://atcimages.kbb.com/hn/c/0c95d230758e4355b09c4e56e553abdd.jpg",
        "width": 640,
        "height": 480
      }
    ]
  },
  "insurify_enabled": true,
  "fyusion": false,
  "insurance_partner_enabled": true,
  "is_hot": false,
  "is_newly_listed": false,
  "is_reduced_price": false,
  "lifestyle_categories": [
    "Unavailable"
  ],
  "listing_type": "NEW",
  "listing_types": [
    {
      "code": "NEW",
      "name": "New"
    }
  ],
  "make": {
    "code": "FORD",
    "name": "Ford"
  },
  "make_code": "FORD",
  "mileage": {
    "label": "Mileage",
    "value": "26"
  },
  "model": {
    "code": "FORF150LIG",
    "name": "F150 Lightning"
  },
  "model_code": "FORF150LIG",
  "mpg_city": null,
  "mpg_highway": null,
  "owner_id": 86735,
  "payment_services": {
    "active_dealer_track": true,
    "cox_auto_dr_enabled": false,
    "payment_service_active": true,
    "preferred_lender_specified": true,
    "dealer_settings": {
      "cash_deal_price": 72842,
      "taxes_fees_enabled": true,
      "ui_enabled": false,
      "disable_trade": false,
      "lease_enabled": true,
      "price_breakdown_enabled": false
    },
    "payment_calculation_url": "dealerZip=49036&mileage=26&vin=1FT6W7L71SWG20477&certifiedUsed=false&listingType=New&fueltype=Electric&styleId=463679&trim=Platinum&bodyType=Truck&transmission=Automatic&dealerDiscountedPrice=81842&msrp=88585&quotePreference=All&salePrice=72842&dealerId=86735&partnerId=AMK&enableLease=true&disableIncentives=true&hasSpecialOffers=false&useDealerDefaultDealerFees=true",
    "incentives_url": "listingType=New&vin=1FT6W7L71SWG20477&dealerId=86735&partnerId=AMK",
    "digital_retailing_type": "dealerTrackConfigured"
  },
  "price_advisor_enabled": false,
  "price_advisor_rule_enabled": false,
  "pricing_detail": {
    "dealer_discounted_price": 81842,
    "discounts": [
      {
        "label": "Dealer Offer",
        "value": 15743
      }
    ],
    "incentive": 72842,
    "kbb_fpp_amount": 80300,
    "kbb_fpp_delta": 7458,
    "kbb_fpp_high_amount": 82400,
    "kbb_fpp_low_amount": 78300,
    "is_mismatch": true,
    "msrp": 88585,
    "no_price_label": "Contact Dealer For Price",
    "price_valid_until": "2026-06-21",
    "sale_price": 72842
  },
  "market_extension": {
    "is_market_ext_listing": true,
    "is_virtual_dealer": false,
    "long_haul_delivery": false,
    "shipping_cost": 0,
    "distance": 0
  },
  "specifications": {
    "interior_color": {
      "label": "Interior Color",
      "value": "Gray"
    },
    "mile_range": {
      "label": "Mile Range",
      "value": "300 EV Mile Range"
    },
    "transmission": {
      "label": "Transmission",
      "value": "Single-Speed"
    },
    "color": {
      "label": "Exterior Color",
      "value": "White"
    },
    "fuel_type": {
      "label": "Fuel Type",
      "value": "Electric"
    },
    "engine": {
      "label": "Engine",
      "value": "Electric"
    },
    "drive_type": {
      "label": "Drive Type",
      "value": "All Wheel Drive"
    },
    "range": {
      "label": "RANGE",
      "value": "300 EV Mile Range"
    },
    "mileage": {
      "label": "Miles",
      "value": "26"
    }
  },
  "stock_id": "SWG20477",
  "style_id": 463679,
  "styles": [
    {
      "code": "AWD4WD"
    },
    {
      "code": "TRUCKS"
    },
    {
      "code": "HYBEL"
    }
  ],
  "title": "New 2025 Ford F150 Lightning Platinum",
  "title_long": "New 2025 Ford F150 Lightning Platinum Coldwater MI 49036",
  "transmission": {
    "code": "AUT",
    "description": "Single-Speed",
    "group": "Automatic",
    "name": "Automatic"
  },
  "trim": {
    "code": "FORF150LIG|Platinum",
    "name": "Platinum"
  },
  "at_trim": "Platinum",
  "truck_bed_size_description": "Short",
  "vehicle_highlight": {
    "is_vehicle_highlight": true
  },
  "vhr_preview": [
    "NO_SALVAGE_TITLE",
    "NO_ACCIDENTS_REPORTED"
  ],
  "vin": "1FT6W7L71SWG20477",
  "year": 2025,
  "kbb_vehicle_id": 472673,
  "has_special_offer": false,
  "warranties": {
    "original_warranties": {
      "basic": {
        "details": "3 Years/36,000 Miles",
        "label": "Basic",
        "miles": 36000,
        "remaining_miles": 35974,
        "remaining_years": 2,
        "years": 3
      },
      "drivetrain": {
        "details": "5 Years/60,000 Miles",
        "label": "Drivetrain",
        "miles": 60000,
        "remaining_miles": 59974,
        "remaining_years": 4,
        "years": 5
      },
      "corrosion": {
        "details": "5 Years/Unlimited Miles",
        "label": "Corrosion",
        "miles": -1,
        "remaining_miles": -1,
        "remaining_years": 4,
        "years": 5
      },
      "hybrid_electric_components": {
        "details": "8 Years/100000 Miles",
        "label": "Hybrid/Electric Components",
        "miles": 100000,
        "remaining_miles": 99974,
        "remaining_years": 7,
        "years": 8
      },
      "roadside_assistance": {
        "details": "5 Years/60,000 Miles",
        "label": "Roadside Assistance",
        "miles": 60000,
        "remaining_miles": 59974,
        "remaining_years": 4,
        "years": 5
      }
    },
    "original_warranty_expired": false
  },
  "premium_spotlight": true,
  "vehicle_protection_program": false,
  "vdp_base_url": "/cars-for-sale/vehicle/752113639?allListingType=all&newSearch=false",
  "vhr_vdp_base_url": "/cars-for-sale/vehicle/752113639?allListingType=all#purchaseConfidence"
}

Each scraped listing returns a detailed vehicle record:

Identity & Listing Info

Field	Meaning
ID	Internal KBB listing identifier
VIN	Vehicle Identification Number — unique per vehicle
KBB Vehicle ID	KBB's own vehicle catalog ID
Stock ID	Dealer stock number
Style ID / Styles	Trim/style variant identifiers
Title / Title Long	Short and full listing titles
Listing Type / Listing Types	e.g., used, certified, new
Days On Site	How long the listing has been active
VDP Base URL	URL to the Vehicle Detail Page
VHR VDP Base URL	URL to the Vehicle History Report page

Vehicle Specs

Field	Meaning
Year / Make / Model / Trim	Core vehicle identity
Make Code / Model Code / AT Trim	Standardized codes for API/database use
Body Styles / Body Style Sub Type	e.g., SUV, Sedan, Crew Cab
Doors	Number of doors
Drive Type	FWD, RWD, AWD, 4WD
Engine / Displacement UOM	Engine description and displacement unit
Transmission	Automatic, manual, CVT, etc.
Fuel Type	Gas, diesel, hybrid, electric
Electric Component Info	Battery/range details for EVs
MPG City / MPG Highway	Fuel efficiency ratings
Truck Bed Size Description	Bed size for truck listings
Specifications	Full structured spec sheet

Pricing & Market Data

Field	Meaning
Pricing Detail	Full pricing breakdown (MSRP, dealer price, etc.)
All In Pricing	Total price including fees where available
Market Extension	Regional market pricing context
Is Reduced Price	Flag for recently discounted listings
Has Special Offer	Dealer promotional offer flag
Price Advisor Enabled / Price Advisor Rule Enabled	Whether KBB price rating is shown
Payment Services	Financing/payment options available
Accelerate	Indicates availability of KBB's online purchase flow

Condition & Features

Field	Meaning
Mileage	Odometer reading in miles
Color	Exterior color
Has Leather Seats	Boolean feature flag
Vehicle Highlight	Key selling points highlighted by dealer
Lifestyle Categories	Audience tags (e.g., family, off-road, commuter)
Warranties	Active warranty details
Vehicle Protection Program	Extended protection plan info
VHR Preview	Vehicle history report preview data
Description	Full dealer-written listing description

Media

Field	Meaning
Images	Array of listing photo URLs
Fyusion	360° interactive photo data (where available)

Listing Status Flags

Field	Meaning
Is Hot	High-demand listing flag
Is Newly Listed	Recently added to the marketplace
Owner ID	Seller/dealer account identifier
Insurify Enabled / Insurance Partner Enabled	Insurance quote integration flags

---

How to Use

1. Build your search URL — Go to kbb.com/cars-for-sale, apply filters (make, model, ZIP, price), then copy the results page URL.
2. Configure input — Paste URLs into the urls array. Set max_items_per_url based on how many records you need.
3. Run the scraper — Start the actor and monitor progress in the run log.
4. Export — Download results as JSON, CSV, or Excel for use in spreadsheets, databases, or BI tools.

Best practices:

• Narrow search filters before scraping to get relevant data without wasting item quota.
• For multi-region analysis, create separate filtered URLs per ZIP or metro area.
• Set ignore_url_failures: true when running batches of multiple URLs.

---

Use Cases & Business Value

• Dealer pricing strategy: Benchmark local inventory prices against market rates in real time
• Depreciation modeling: Build datasets tracking price drops over Days On Site
• Insurance & fintech enrichment: Populate vehicle databases with specs, VINs, and market values
• Consumer tools: Power "find the best deal" features using Is Reduced Price, Is Hot, and Pricing Detail fields

The scraper eliminates hours of manual research, delivering consistent machine-readable records that feed directly into analytical workflows.

---

Conclusion

The KBB.com Cars Search Scraper gives automotive professionals and developers reliable, structured access to one of the most comprehensive used and new car marketplaces in the US. With 55+ fields per listing — from VIN and specs to pricing flags and media — it provides the depth needed for serious market analysis. Configure your search URL, set your limits, and start extracting today.