Cars.com API endpoint
Searches Cars.com for new and used car listings, returning vehicle summaries (make, model, trim, year, mileage, exterior color, drivetrain, fuel type, pricing, seller, images) plus the total matching count.
/carsdotcom/searchSearches Cars.com for new and used car listings, returning vehicle summaries (make, model, trim, year, mileage, exterior color, drivetrain, fuel type, pricing, seller, images) plus the total matching count for the applied filters, not just the returned page.
Query parameters:
zip (optional) — 5-digit US ZIP code to search around.radius (optional) — search radius in miles around zip.stock_type (optional) — listing condition. Allowed values: new,
used, cpo (certified pre-owned), all.page (optional) — 1-indexed result page. Defaults to 1. Cars.com
returns 24 results per page.Notable response behavior:
total_count reflects Cars.com's own reported matching-result count for
the applied filters, not just len(vehicles). Cars.com caps this figure
at 10000 for very broad searches (e.g. no filters at all) rather than
reporting the true count beyond that.is_cpo is set when Cars.com marks the listing as certified pre-owned.stock_type value returns 400 before any upstream request is
made.| Field | Filled in, of 24 checked | Values in the sample |
|---|---|---|
| listing_id | 24 | |
| vin | 24 | |
| year | 24 | 2,002 to 2,025, median 2,020 |
| make | 24 | “Mercedes-Benz” and 11 other values |
| model | 24 | “E-Class” and 22 other values |
| trim | 24 | “E 350” and 19 other values |
| body_style | 24 | SUV (11), Sedan (7), Coupe (3) and 3 more |
| mileage | 24 | 2,408 to 124,192, median 45,614 |
| exterior_color | 23 | white (9), black (5), gray (3) and 4 more |
| drivetrain | 24 | Rear-wheel Drive (9), All-wheel Drive (8), Front-wheel Drive (5) and 1 more |
| fuel_type | 24 | Gasoline (16), Electric (4), Hybrid (3) and 1 more |
| stock_type | 24 | Used in all 24 |
| price | 24 | 7,171 to 159,900, median 28,993 |
| seller | 24 | |
| images | 24 | median 6 entries |
| url | 24 | cars.com |
| is_cpo | 4 | true in 4 of 4 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| zip | string | No | 5-digit US ZIP code to search around | 90210 | |
| radius | integer | No | Search radius in miles around zip | 50 | |
| stock_type | string | No | Listing condition. Allowed values: new, used, cpo, all Allowed values: new, used, cpo, all. | used | |
| page | integer | No | 1 | 1-indexed result page, defaults to 1. Cars.com returns 24 results per page | 1 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/carsdotcom/search?stock_type=new&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"total_count": 10000,
"page": 1,
"page_size": 24,
"vehicles": [
{
"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,
"seller": {
"dealer_name": "Lexus of Cerritos",
"zip": "90703"
},
"images": [
"https://platform.cstatic-images.com/large/in/v2/2b36ae52-fc12-53e4-9ae5-6d931aec6878/1f5784d2-4853-48a2-9ccb-e56f0fd2c59f/7IaYP6lvanG6iPgFM2TPpNxb5gY.jpg"
],
"url": "https://www.cars.com/vehicledetail/a6ea5d6f-0395-4f9d-94d5-724c4d7414de/"
}
],
"source_url": "https://graph.cars.com/graphql/api"
}
}Request schema
No body schema
Response schema
#/definitions/carsdotcom.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | carsdotcom.SearchResponse | No | ||||
| data.page | integer | No | 1 | |||
| data.page_size | integer | No | 24 | |||
| data.source_url | string | No | ||||
| data.total_count | integer | No | 10000 | |||
| data.vehicles | array | No | ||||
| data.vehicles[].body_style | string | No | Hatchback | |||
| data.vehicles[].drivetrain | string | No | Front-wheel Drive | |||
| data.vehicles[].exterior_color | string | No | white | |||
| data.vehicles[].fuel_type | string | No | Hybrid | |||
| data.vehicles[].images | array | No | ||||
| data.vehicles[].is_cpo | boolean | No | ||||
| data.vehicles[].listing_id | string | No | a6ea5d6f-0395-4f9d-94d5-724c4d7414de | |||
| data.vehicles[].make | string | No | Lexus | |||
| data.vehicles[].mileage | integer | No | 63436 | |||
| data.vehicles[].model | string | No | CT 200h | |||
| data.vehicles[].msrp | number | No | ||||
| data.vehicles[].price | number | No | 21992 | |||
| data.vehicles[].seller | carsdotcom.Seller | No | ||||
| data.vehicles[].seller.dealer_name | string | No | Lexus of Cerritos | |||
| data.vehicles[].seller.zip | string | No | 90703 | |||
| data.vehicles[].stock_type | string | No | Used | |||
| data.vehicles[].trim | string | No | Base | |||
| data.vehicles[].url | string | No | https://www.cars.com/vehicledetail/a6ea5d6f-0395-4f9d-94d5-724c4d7414de/ | |||
| data.vehicles[].vin | string | No | JTHKD5BH9G2270550 | |||
| data.vehicles[].year | integer | No | 2016 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/search?stock_type=new&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"