# Carvana Facets API Documentation

Retrieve the full Carvana filter taxonomy with live vehicle counts for every facet. Returns 29 facet keys including makes, body styles, fuel types, price, year and mileage ranges.

- **Documentation:** [https://scrappa.co/docs/carvana-api/carvana_facets](https://scrappa.co/docs/carvana-api/carvana_facets)
- **API group:** Carvana API
- **Endpoint:** `POST https://scrappa.co/api/carvana/facets`

## 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 |
| --- | --- | --- | --- |
| `filters` | object | No | Optional filter object. An empty object returns all facets. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/carvana/facets"
```

## Example response

```json
{
    "success": true,
    "data": {
        "facets": []
    },
    "meta": {
        "endpoint_family": "facets"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 400 | Carvana rejected the request filters |  |
| 422 | Carvana could not accept the requested filters |  |
| 503 | The Carvana API is temporarily unavailable |  |

## 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)