---
title: "Cars.com API: Search | Perceptlayer"
description: "Search from Cars.com as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/cars-com/search
---

[APIs](https://perceptlayer.com/apis) / [Cars.com](https://perceptlayer.com/apis/cars-com) / Search

# Cars.com: Search

Search from Cars.com as JSON. 1 credit per successful call.

GET `/v1/cars-com/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `zip` | string | Required | Any |
| `radius_miles` | integer | Required | Any |
| `makes[]` | list of string | Optional | Up to 64 characters |
| `models[]` | list of string | Optional | Up to 64 characters |
| `stock_type` | string | Required | all, used, new, cpo |
| `year_min` | integer | Optional | Any |
| `year_max` | integer | Optional | Any |
| `fuel_slugs[]` | list of string | Optional | Up to 64 characters |
| `transmission_slugs[]` | list of string | Optional | Up to 64 characters |
| `seller_type[]` | list of string | Optional | dealership, private\_seller, online\_seller |
| `sort` | string | Required | BEST\_MATCH\_DESC, DISTANCE, MILEAGE, MILEAGE\_DESC, YEAR, YEAR\_DESC, LISTED\_AT\_DESC, LIST\_PRICE\_DESC |
| `page` | integer | Required | Any |
| `page_size` | integer | Required | Any |

## Example request

cURL shell 

```
curl "https://api.perceptlayer.com/v1/cars-com/search" \
  -H "X-API-Key: $API_KEY"
```

[Run this endpoint in the playground](https://perceptlayer.com/apis/cars-com?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.