---
title: "Carsales API: Facets | Perceptlayer"
description: "Facets from Carsales as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/carsales/facets
---

[APIs](https://perceptlayer.com/apis) / [Carsales](https://perceptlayer.com/apis/carsales) / Facets

# Carsales: Facets

Facets from Carsales as JSON. 1 credit per successful call.

GET `/v1/carsales/facets`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `condition` | string | Optional | used, new |
| `make` | string | Optional | Up to 64 characters |
| `model` | string | Optional | Up to 64 characters |
| `state` | string | Optional | Up to 40 characters |
| `body_style` | string | Optional | Up to 40 characters |
| `transmission` | string | Optional | Automatic, Manual |
| `keyword` | string | Optional | Up to 64 characters |
| `year_min` | integer | Optional | Any |
| `year_max` | integer | Optional | Any |
| `price_min` | integer | Optional | Any |
| `price_max` | integer | Optional | Any |
| `odometer_min` | integer | Optional | Any |
| `odometer_max` | integer | Optional | Any |
| `level` | string | Optional | make, model, state, body\_style, price |
| `q` | string | Optional | Up to 64 characters |

## Example request

cURL shell 

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

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