Kelley Blue Book model year

GET https://api.api.sh/kbb/v1/model
1 credit / call automotive try it in the playground →

Kelley Blue Book's data for a model year: every trim with its vehicle id, Fair Purchase Price, trade-in and private-party value and specs; price range; depreciation history and resale forecast; 5-year cost to own; the expert review with sub-ratings, pros and cons; consumer rating averages and distribution; safety and crash-test ratings; full specs and features; class rankings; FAQs; photos and the model's other years.

Every response includes credits_used: the credits this call cost.

Part of the Kelley Blue Book API: 6 endpoints with prices, use cases and example responses.

Parameters

nametypedescription
makerequired string Make. Example: toyota
modelrequired string Model. Example: camry
yearrequired integer Model year. Example: 2020
zip string ZIP code for local values (default 90210).

Every endpoint also takes fresh, raw, fields (see lean responses and caching).

Example

curl "https://api.api.sh/kbb/v1/model?make=toyota&model=camry&year=2020" \
  -H "x-api-key: $APISH_KEY"

Response

A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).

Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)

{"make": "toyota","model": "camry","year": 2020,"zip": "90210","url": "https://www.kbb.com/toyota/camry/2020/","category": "Mid-size Car","body_styles": ["Sedan"],"price_range": {"low": 17350,"high": 26500,"type": "buyused"},"trims": [{"vehicle_id": 445263,"name": "L Sedan 4D","body_style": "Sedan","fair_purchase_price": 16750,"trade_in_value": 11350,"private_party_value": 15450,"mpg": {"city": 29,"highway": 41,"combined": 34},"horsepower": "203 @ 6600 RPM","engine": "4-Cyl, 2.5 Liter","torque": 184,"drivetrain": "FWD","seats": 5,"curb_weight": 3241,"towing_capacity": 0,"cargo": 14.1,"electric": false,"electric_range": null},{"vehicle_id": 445266,"name": "LE Sedan 4D","body_style": "Sedan","fair_purchase_price": 17400,"trade_in_value": 12850,"private_party_value": 16050,"mpg": {"city": 28,"highway": 39,"combined": 32},"horsepower": "203 @ 6600 RPM","engine": "4-Cyl, 2.5 Liter","torque": 184,"drivetrain": "FWD","seats": 5,"curb_weight": 3296,"towing_capacity": 0,"cargo": 15.1,"electric": false,"electric_range": null},"… 8 more"],"depreciation": {"totalThreeYearDepreciation": -1117,"currentResaleValue": 15450,"currentTradeInValue": 11350,"historicalValues": [{"year": 2023,"resaleValue": 14333,"tradeInValue": 11631,"annualDepreciation": 5079},{"year": 2024,"resaleValue": 18162,"tradeInValue": 15985,"annualDepreciation": -3829},"… 2 more"],"future": [{"year": 2027,"resaleValue": 13221,"tradeInValue": 9712,"annualDepreciation": 2229},{"year": 2028,"resaleValue": 11195,"tradeInValue": 8224,"annualDepreciation": 2026}]},"cost_to_own": null,"expert_review": {"rating": 4.6,"author": null,"ratings": {"comfort": 4.5,"driving": 4.6,"interior_exterior": 4.4,"safety": 0,"value": 4.5},"pros": "- Toyota Safety Sense P standard on all trims\n- Optional all-wheel drive\n- V6, I4, or hybrid engine choices\n- Outstanding reliability and re…","cons": "- Smaller-than-average trunk\n- Sport models don’t offer a manual transmission option\n- Plug-in hybrid missing from the lineup\n- Bold styling…","summary": "With its available all-wheel drive, hybrid or powerful V6 engine options, and a stellar reputation for reliability and high resale values, t…","overview": "#2 in Best Midsize Cars of 2020\nThe Toyota Camry continues to be one of America’s favorite family sedans, offering value, reliability, safet…","driving": "For all of its life, the Toyota Camry has presented itself as a comfortable family sedan that never pushed the boundaries, yet still felt qu…","interior": "Inside the 2020 Toyota Camry’s cabin is an artful blend of style, materials, technology, and versatility. The overall feeling is one of soli…","exterior": "Long gone are the simple lines and demure styling of Camry’s past. The 2020 Camry is a whole new animal, and we think it’s the best looking …","favorite_features": "CAMRY HYBRID\nThe Toyota Camry has been a long-time player in the hybrid sedan game, and the 2020 Camry Hybrid continues the winning streak. …","standard_equipment": "The 2020 Toyota Camry model range includes the L, LE, SE, Nightshade, XSE, XLE, and TRD. The hybrid models cover LE, SE, and XLE. Standard e…","optional_equipment": "More options appear on higher trims, like the Camry SE’s darkened exterior styling treatment, 18-inch wheels, sport bucket seats, and perfor…","under_the_hood": "Residing beneath the 2020 Toyota Camry’s lightweight hood are three engine options. Standard is a 2.5-liter 4-cylinder producing 203 horsepo…","whats_new": "","pricing_notes": "The 2020 Toyota Camry L has a Manufacturer’s Suggested Retail Price (MSRP) of $25,420, including the $995 destination fee. A better buy is t…","reliable": "","good_car": "","published": "January 09, 2021","updated": "August 08, 2023"},"market_pricing": {"fairMarketPrice": {"ymmtAverage": 16750,"ymmtHigh": 16750,"ymmtLow": 16750},"listPrice": {"ymmtAverage": 17350,"ymmtHigh": 17350,"ymmtLow": 17350},"msrp": 0,"originalMSRP": 25420,"fppPrice": 16750},"scores": {"reliabilityScore": "above","rolloverScore": "excellent","qualityScore": "above"},"consumer_ratings": {"averageOverallRating": 4,"totalReviewCount": 352,"averageRatingValue": 4,"averageRatingReliability": 4.1,"averageRatingPerformance": 4,"averageRatingStyling": 4.4,"averageRatingComfort": 4,"averageRatingQuality": 3.9,"averageRatingRecommendation": 3.7,"ratingDistribution": {"oneStar": 34,"twoStar": 27,"threeStar": 50,"fourStar": 52,"fiveStar": 189}},"consumer_summary": {"recommendPercentage": 0.63,"totalReviewCount": 352,"avgQualityScore": 3.9,"avgReliabilityScore": 4.1,"avgOverallRating": 4,"mostHelpfulPros": ["Very nice and sleek looking. Comfortable seats.","Styling, power, performance","… 3 more"],"avgOverallDescription": "Higher than most","generationStartYear": "2018","generationEndYear": "2024"},"safety_ratings": {"overallRating": {"name": "Crash Test Rating","value": 5},"ratings": [{"name": "Frontal Crash","value": 5},{"name": "Side Barrier","value": 5},"… 2 more"],"ratingYear": 2020},"crash_tests": {"overallRating": 5,"frontalCrashRating": 5,"sideCrashRating": 5,"rolloverRating": 5,"driverFrontRating": 0,"passengerFrontRating": 0},"ranking": {"category": "Cars","actualRank": 3,"listName": "Best Mid-Size Cars","listUrl": "/cars/best-mid-size-cars/2020/","yearId": 2020},"specs": {"class": "UsedCar","size": "Mid-Size","engine": "4-Cyl, 2.5 Liter","transmission": "Automatic, 8-Spd w/Sequential Shift","drivetrain": "FWD","horsepower": "203 @ 6600 RPM","torque": 184,"doors": "4","seats": "5","fuel": "Regular","mpg": "29 City / 41 Highway","curb_weight": 3241,"wheelbase": 111.2,"height": 56.9,"zero_to_sixty": null,"hybrid": false,"plug_in_hybrid": false,"electric": false,"fuelEconomy": "City 29 mpg/Hwy 41 mpg/Comb 34 mpg","fuelType": "Gas","basicWarranty": "3 years or 36000 miles","maxSeating": "5","cargoSpace": "14.1 cu.ft.","maximumTowing": "N/A","estimatedElectricRange": null,"zeroToSixty": "N/A","chargingTime": "N/A","additionalSpecs": [{"category": "Dimensions, Weights & Capacities","specs": [{"…": "2 fields"},{"…": "2 fields"},"… 11 more"],"subCategories": null},{"category": "Exterior","specs": [{"…": "2 fields"},{"…": "2 fields"}],"subCategories": null},"… 4 more"],"features": [{"category": "Comfort & Convenience","specs": ["Remote Control Liftgate/Trunk Release"]},{"category": "Entertainment","specs": ["Satellite Radio","Bluetooth Streaming Audio"]},"… 3 more"],"specsRange": [{"specName": "mpgcombined","range": "25 - 34 combined mpg"},{"specName": "horsepower","range": "203 - 301 hp"},"… 5 more"],"availableEngines": ["4-Cyl, 2.5 Liter","V6, 3.5 Liter"]},"class_rankings": [{"spec": "Horsepower","value": "203","results": [{"position": 1,"value": "305","vehicle": "2020 Chevrolet Impala","current": false},{"position": 2,"value": "300","vehicle": "2020 Nissan Maxima","current": false},"… 3 more"]},{"spec": "MPG Combined","value": "34","results": [{"position": 1,"value": "52","vehicle": "2021 Honda Insight","current": false},{"position": 2,"value": "52","vehicle": "2020 Toyota Corolla Hybrid","current": false},"… 3 more"]},"… 1 more"],"faqs": [{"question": "How reliable is the 2020 Toyota Camry?","answer": "Kelley Blue Book users rate the 2020 Toyota Camry reliability 5 out of 5 stars, which is far above average for a vehicle of its class."},{"question": "Is the Toyota Camry 2020 a good Sedan?","answer": "According to the experts at Kelley Blue Book, the 2020 Toyota Camry scores 4.6 out of 5 stars. Owners of the vehicle give it 4 out of 5 star…"},"… 1 more"],"years": [2027,2026,"… 34 more"],"photos": [{"url": "https://file.kelleybluebookimages.com/kbb/base/evox/CP/12148/2020-Toyota-Camry-front_12148_032_1834x733_040_cropped.png","type": "Exterior","primary": true},{"url": "https://file.kelleybluebookimages.com/kbb/base/evox/StJ/12148/2020-Toyota-Camry-headlight_12148_043_640x480.jpg","type": "Exterior","primary": false},"… 106 more"],"image": "https://file.kelleybluebookimages.com/kbb/base/evox/CP/12105/2020-Toyota-Camry-front_12105_032_2400x1800_040.png","cached": false,"credits_used": 1}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.