# CarDekho Used Car Filters API Documentation

Return the CarDekho used-car filter vocabulary for India: price bands, brands with their models, registration years, fuel, transmission, kilometre bands, owners, body types, seats, discounts and colours. Every option has its slug, label and the number of cars. Use the slugs as search parameters.

- **Documentation:** [https://scrappa.co/docs/cardekho-api/cardekho_used_filters](https://scrappa.co/docs/cardekho-api/cardekho_used_filters)
- **API group:** CarDekho API
- **Endpoint:** `GET https://scrappa.co/api/cardekho/v1/used-cars/filters`

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

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/cardekho/v1/used-cars/filters"
```

## Example response

```json
{
    "success": true,
    "data": {
        "total": 62630,
        "filters": {
            "fuel": {
                "multi_select": true,
                "options": [
                    {
                        "label": "Petrol",
                        "value": "petrol",
                        "count": 30000,
                        "selected": false
                    }
                ]
            }
        }
    },
    "meta": {
        "endpoint_family": "filters",
        "market": "IN"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter or range is invalid. This response is not billable. |
| 404 | Not Found | CarDekho has no listing, price or result for the request. This response is not billable. |
| 422 | Unknown Filter | CarDekho did not recognise the city, make, fuel, transmission, body type, owner or seats value. This response is not billable. |
| 503 | Unexpected Upstream Response | CarDekho returned an unrecognized response shape. This response is not billable. |
| 503 | Upstream Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

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