Cars.com API endpoint
Returns a Cars.com vehicle listing: full vehicle spec (make, model, trim, mileage, colors, engine, transmission, fuel economy, a key-specs table), Cars.com's own deal-fairness rating and predicted fair price, categorized equipment features, an AutoCheck-derived vehicle history report, Cars.com's own price-change history, the seller's notes, dealer detail (name, rating, address, website, phones, hours) or private-seller detail for a for-sale-by-owner listing, and certified-pre-owned/manufacturer-program detail when applicable.
/carsdotcom/vehicle/{listing_id}Path parameters:
listing_id (required) — the Cars.com listing id, a UUID and the path
segment of a /vehicledetail/{listing_id}/ URL (e.g.
a6ea5d6f-0395-4f9d-94d5-724c4d7414de for
https://www.cars.com/vehicledetail/a6ea5d6f-0395-4f9d-94d5-724c4d7414de/).
Any search response's listing_id field is a valid input here.Notable response behavior:
model and trim are cleanly split (e.g. model: "CT 200h",
trim: "Base").listing_id returns a 404.deal_rating is omitted when Cars.com does not show a deal-fairness
assessment for this listing (not enough comparable listings, etc).history's owner/accidents/title strings are a human-readable
summary derived from the boolean fields alongside them (one_owner,
no_accidents, clean_title, ...) — prefer the booleans for
programmatic checks. This is not a substitute for a full paid vehicle
history report.key_specs and price_history are frequently empty arrays — Cars.com
only populates them for some listings.dealer is populated for a dealer listing; private_seller is populated
instead for a for-sale-by-owner listing. A listing has at most one of the
two.certified_pre_owned_program is only populated for a certified-pre-owned
listing (is_cpo: true); new_vehicle_program is only populated when
Cars.com attaches a manufacturer incentive program to a new-inventory
listing. Both are omitted otherwise.| Field | Filled in, of 7 checked | Values in the sample |
|---|---|---|
| day | 7 | “SUN” and 6 other values |
| department | 7 | Sales in all 7 |
| start_at | 7 | 09:00:00 (5), 10:00:00 (2) |
| end_at | 7 | 20:00:00 (5), 18:00:00 (1), 19:00:00 (1) |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| listing_id (path) | string | Yes | Cars.com listing id (a UUID), the path segment of a /vehicledetail/{listing_id}/ URL | a6ea5d6f-0395-4f9d-94d5-724c4d7414de | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/carsdotcom/vehicle/a6ea5d6f-0395-4f9d-94d5-724c4d7414de" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"listing_id": "a6ea5d6f-0395-4f9d-94d5-724c4d7414de",
"vin": "JTHKD5BH9G2270550",
"year": 2016,
"make": "Lexus",
"model": "CT 200h",
"trim": "Base",
"body_style": "Hatchback",
"mileage": 63436,
"exterior_color": "White",
"drivetrain": "Front-wheel Drive",
"fuel_type": "Hybrid",
"stock_type": "USED",
"price": 21992,
"images": [
"https://platform.cstatic-images.com/in/v2/.../1.jpg"
],
"url": "https://www.cars.com/vehicledetail/a6ea5d6f-0395-4f9d-94d5-724c4d7414de/",
"title": "Used 2016 Lexus CT 200h Base",
"stock_number": "G2270550",
"interior_color": "Parchment",
"engine": "1.8L I-4 DOHC, variable valve control, regular unleaded, engine",
"transmission": "Automatic",
"cylinder_count": 4,
"door_count": 4,
"mpg_city": 43,
"mpg_highway": 40,
"deal_rating": {
"rating": "fair",
"good_price_min": 17591,
"good_price_max": 19566,
"predicted_price": 17950,
"predicted_price_difference": -4042
},
"features": [
{
"category": "Safety",
"items": [
"Automatic Emergency Braking",
"Backup Camera",
"Brake Assist",
"Stability Control"
]
}
],
"history": {
"owner": "Multiple Owners",
"accidents": "No accidents reported",
"title": "Clean",
"one_owner": false,
"no_accidents": true,
"clean_title": true,
"report_url": "https://www.autocheck.com/vehiclehistory/?vin=JTHKD5BH9G2270550&siteID=7071",
"report_source": "autocheck"
},
"sellers_notes": "This vehicle includes a Money-Back Guarantee* and passed our precise inspection process...",
"dealer": {
"name": "Lexus of Cerritos",
"rating": 4.8,
"review_count": 4101,
"address": "18800 Studebaker Rd, Cerritos, CA 90703",
"website": "https://www.cerritoslexus.com/",
"phones": [
{
"area_code": "888",
"local_number": "3375218",
"phone_type": "PRIMARY"
}
],
"hours": [
{
"day": "MON",
"department": "Sales",
"start_at": "09:00:00",
"end_at": "21:00:00"
}
]
},
"listed_days": 13,
"total_price_change_display": "$0",
"price_history": [
{
"description": "Listed",
"inserted_at": "2026-07-22T01:17:35",
"list_price": 21992,
"list_price_display": "$21,992"
}
],
"source_url": "https://graph.cars.com/graphql/api"
}
}Request schema
No body schema
Response schema
#/definitions/carsdotcom.VehicleResponse
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| body_style | string | No | Hatchback | |||
| certified_pre_owned_program | carsdotcom.CertifiedPreOwnedProgram | No | ||||
| certified_pre_owned_program.brand_name | string | No | ||||
| certified_pre_owned_program.certification_text | string | No | 161-point inspection | |||
| certified_pre_owned_program.included_makes | string | No | ||||
| certified_pre_owned_program.logo_url | string | No | ||||
| certified_pre_owned_program.maximum_age_mileage | string | No | 2 years/unlimited miles from your certified vehicle date of purchase. | |||
| certified_pre_owned_program.powertrain_warranty | string | No | ||||
| certified_pre_owned_program.program_url | string | No | https://www.cars.com/cpo/lexus-program/ | |||
| certified_pre_owned_program.roadside_assistance | boolean | No | ||||
| certified_pre_owned_program.slogan | string | No | Enjoy peace of mind with Lexus program benefits | |||
| certified_pre_owned_program.warranty_terms | string | No | ||||
| cylinder_count | integer | No | 4 | |||
| deal_rating | carsdotcom.DealRating | No | ||||
| deal_rating.good_price_max | number | No | 19566 | |||
| deal_rating.good_price_min | number | No | 17591 | |||
| deal_rating.predicted_price | number | No | 17950 | |||
| deal_rating.predicted_price_difference | number | No | -4042 | |||
| deal_rating.rating | string | No | fair | |||
| dealer | carsdotcom.Dealer | No | ||||
| dealer.address | string | No | 18800 Studebaker Rd, Cerritos, CA 90703 | |||
| dealer.hours | array | No | ||||
| dealer.hours[].day | string | No | MON | |||
| dealer.hours[].department | string | No | Sales | |||
| dealer.hours[].end_at | string | No | 21:00:00 | |||
| dealer.hours[].start_at | string | No | 09:00:00 | |||
| dealer.name | string | No | Lexus of Cerritos | |||
| dealer.phones | array | No | ||||
| dealer.phones[].area_code | string | No | 888 | |||
| dealer.phones[].local_number | string | No | 3375218 | |||
| dealer.phones[].phone_type | string | No | PRIMARY | |||
| dealer.rating | number | No | 4.8 | |||
| dealer.review_count | integer | No | 4101 | |||
| dealer.website | string | No | ||||
| door_count | integer | No | 4 | |||
| drivetrain | string | No | Front-wheel Drive | |||
| engine | string | No | 1.8L I-4 DOHC, variable valve control, regular unleaded, engine | |||
| exterior_color | string | No | white | |||
| features | array | No | ||||
| features[].category | string | No | Safety | |||
| features[].items | array | No | Automatic Emergency Braking,Backup Camera,Brake Assist,Stability Control | |||
| fuel_type | string | No | Hybrid | |||
| history | carsdotcom.History | No | ||||
| history.accidents | string | No | No accidents reported | |||
| history.clean_title | boolean | No | true | |||
| history.free_report | boolean | No | ||||
| history.no_accidents | boolean | No | true | |||
| history.one_owner | boolean | No | ||||
| history.owner | string | No | Multiple Owners | |||
| history.personal_use | boolean | No | ||||
| history.report_source | string | No | autocheck | |||
| history.report_url | string | No | https://www.autocheck.com/vehiclehistory/?vin=JTHKD5BH9G2270550&siteID=7071 | |||
| history.title | string | No | Clean | |||
| images | array | No | ||||
| interior_color | string | No | Parchment | |||
| is_cpo | boolean | No | ||||
| key_specs | array | No | ||||
| key_specs[].label | string | No | Engine | |||
| key_specs[].secondary_unit | string | No | ||||
| key_specs[].secondary_value | string | No | ||||
| key_specs[].unit | string | No | ||||
| key_specs[].value | string | No | 1.8L I-4 DOHC | |||
| listed_days | integer | No | 13 | |||
| listing_id | string | No | a6ea5d6f-0395-4f9d-94d5-724c4d7414de | |||
| make | string | No | Lexus | |||
| mileage | integer | No | 63436 | |||
| model | string | No | CT 200h | |||
| mpg_city | integer | No | 43 | |||
| mpg_combined | integer | No | ||||
| mpg_highway | integer | No | 40 | |||
| msrp | number | No | ||||
| new_vehicle_program | carsdotcom.NewVehicleProgram | No | ||||
| new_vehicle_program.logo_url | string | No | ||||
| new_vehicle_program.name | string | No | ||||
| price | number | No | 21992 | |||
| price_direction | string | No | ||||
| price_history | array | No | ||||
| price_history[].description | string | No | Listed | |||
| price_history[].inserted_at | string | No | 2026-07-22T01:17:35 | |||
| price_history[].list_price | number | No | 21992 | |||
| price_history[].list_price_display | string | No | $21,992 | |||
| private_seller | carsdotcom.PrivateSeller | No | ||||
| private_seller.city | string | No | ||||
| private_seller.first_name | string | No | ||||
| private_seller.last_name_initial | string | No | ||||
| private_seller.state | string | No | ||||
| private_seller.zip | string | No | ||||
| seat_count | integer | No | ||||
| seller | carsdotcom.Seller | No | ||||
| seller.dealer_name | string | No | Lexus of Cerritos | |||
| seller.zip | string | No | 90703 | |||
| sellers_notes | string | No | ||||
| source_url | string | No | ||||
| stock_number | string | No | G2270550 | |||
| stock_type | string | No | Used | |||
| title | string | No | Used 2016 Lexus CT 200h Base | |||
| total_price_change_display | string | No | $0 | |||
| transmission | string | No | Automatic | |||
| trim | string | No | Base | |||
| url | string | No | https://www.cars.com/vehicledetail/a6ea5d6f-0395-4f9d-94d5-724c4d7414de/ | |||
| video_urls | array | No | ||||
| vin | string | No | JTHKD5BH9G2270550 | |||
| year | integer | No | 2016 |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/carsdotcom/vehicle/a6ea5d6f-0395-4f9d-94d5-724c4d7414de" \
-H "x-api-key: $CRAWLORA_API_KEY"