Endpoint Playground

Try the Cars.com vehicle listing detail API

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.

What a live request returned

14 Oct 2026: 7 dealer.hours; 4 fields had a value in every checked item.

Observed request: GET /carsdotcom/vehicle/03e4ba89-1907-44bc-816a-6c979ae950c5
Fields with a value in every checked item: day, department, start_at, end_at

Sample value profiles: start_at: 09:00:00 (5), 10:00:00 (2); day: “SUN” and 6 other values; end_at: 20:00:00 (5), 18:00:00 (1), 19:00:00 (1).

Request: GET /carsdotcom/vehicle/{listing_id}
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 98.7%, median 1.98 s
Monitored request: GET /carsdotcom/vehicle/03e4ba89-1907-44bc-816a-6c979ae950c5

Cars.com vehicle listing detail API documentation Cars.com platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/carsdotcom/vehicle/a6ea5d6f-0395-4f9d-94d5-724c4d7414de' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
listing_id (path)	string	Yes	a6ea5d6f-0395-4f9d-94d5-724c4d7414de	Cars.com listing id (a UUID), the path segment of a /vehicledetail/{listing_id}/ URL

Example JSON response

{
  "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"
  }
}

More Cars.com endpoints

Search Cars.com vehicle listings

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestcarsdotcom.VehicleResponseCars.com

GET /carsdotcom/vehicle/{listing_id}

Get Cars.com vehicle listing detail

Response behavior

- `model` and `trim` are cleanly split (e.g. `model: "CT 200h"`, `trim: "Base"`). - A delisted or invalid `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.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Path parameters

listing_id

requiredstring

Cars.com listing id (a UUID), the path segment of a /vehicledetail/{listing_id}/ URL

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "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"
  }
}

Try the Cars.com vehicle listing detail API

What a live request returned

14 Oct 2026: 7 dealer.hours; 4 fields had a value in every checked item.

Observed request: GET /carsdotcom/vehicle/03e4ba89-1907-44bc-816a-6c979ae950c5
Fields with a value in every checked item: day, department, start_at, end_at

Sample value profiles: start_at: 09:00:00 (5), 10:00:00 (2); day: “SUN” and 6 other values; end_at: 20:00:00 (5), 18:00:00 (1), 19:00:00 (1).

Request: GET /carsdotcom/vehicle/{listing_id}
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 98.7%, median 1.98 s
Monitored request: GET /carsdotcom/vehicle/03e4ba89-1907-44bc-816a-6c979ae950c5

Cars.com vehicle listing detail API documentation Cars.com platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/carsdotcom/vehicle/a6ea5d6f-0395-4f9d-94d5-724c4d7414de' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
listing_id (path)	string	Yes	a6ea5d6f-0395-4f9d-94d5-724c4d7414de	Cars.com listing id (a UUID), the path segment of a /vehicledetail/{listing_id}/ URL

Example JSON response

{
  "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"
  }
}

Get Cars.com vehicle listing detail

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up 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" } }