# Cars.com Listing Search

Search Cars.com new and used vehicle listings. Filter by ZIP code and radius, make and model slugs, stock type, model year range, fuel and transmission slugs, and seller type. Results carry numeric USD prices, mileage in miles, the Cars.com price badge, the predicted price, the model year, make, model, trim, body style, fuel, transmission, drivetrain, colours, dealer, stock number, and the certified-preowned flag. Page through with page and page_size and read has_more from the live total page count.

- **Documentation:** [https://scrappa.co/docs/cars-com-api/cars_com_search](https://scrappa.co/docs/cars-com-api/cars_com_search)
- **API group:** Cars.com API
- **Endpoint:** `GET https://scrappa.co/api/cars-com/v1/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `zip` | string | No | US ZIP code for the search area. |
| `radius_miles` | integer | No | Search radius in miles. |
| `makes` | array | No | Repeatable make slug from the taxonomy endpoint, e.g. toyota. |
| `models` | array | No | Repeatable model slug from the taxonomy endpoint, e.g. toyota-camry. |
| `stock_type` | string | No | all, used, new or cpo. |
| `year_min` | integer | No | Minimum model year. |
| `year_max` | integer | No | Maximum model year. |
| `fuel_slugs` | array | No | Repeatable fuel slug, e.g. electric. |
| `transmission_slugs` | array | No | Repeatable transmission slug, e.g. manual. |
| `seller_type` | array | No | Repeatable: dealership, private_seller or online_seller. |
| `sort` | string | No | BEST_MATCH_DESC, DISTANCE, MILEAGE, MILEAGE_DESC, YEAR, YEAR_DESC, LISTED_AT_DESC or LIST_PRICE_DESC. |
| `page` | integer | No | Result page, starting at 1. |
| `page_size` | integer | No | Listings per page, 1 to 100. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | A public parameter is invalid or an unsupported filter was sent. This response is not billable. |  |
|  | Cars.com did not return usable data for this request. This response is not billable. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)