# La Centrale Taxonomy API Documentation

Retrieve the make and model reference lists with live listing counts. This is the taxonomy for the filter UI: `makes` and `models` are two flat lists, each entry carrying its live listing count. Supports the same filter grammar as facets.

- **Documentation:** [https://scrappa.co/docs/lacentrale-api/lacentrale_taxonomy](https://scrappa.co/docs/lacentrale-api/lacentrale_taxonomy)
- **API group:** La Centrale API
- **Endpoint:** `GET https://scrappa.co/api/lacentrale/v1/taxonomy`

## 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 |
| --- | --- | --- | --- |
| `families` | string | No | Vehicle family: AUTO, UTILITY, MOTO, SCOOTER, or QUAD. |
| `make_model` | string | No | Filter by make:model, e.g. RENAULT:CLIO. |
| `zip_code` | string | No | Filter by zip code. Requires zip_code_distance. |
| `zip_code_distance` | string | No | Distance from zip code, e.g. 50km. Required when zip_code is present. |
| `price_min` | integer | No | Minimum price in EUR. |
| `price_max` | integer | No | Maximum price in EUR. |
| `mileage_min` | integer | No | Minimum mileage in km. |
| `mileage_max` | integer | No | Maximum mileage in km. |
| `year_min` | integer | No | Minimum first registration year. |
| `year_max` | integer | No | Maximum first registration year. |
| `energies` | array | No | Comma-separated energy types. |
| `gearbox` | string | No | Gearbox type: AUTO or MANUAL. |
| `categories` | array | No | Comma-separated category codes. |
| `regions` | array | No | Comma-separated region codes. |
| `customer_family_codes` | array | No | Comma-separated customer family codes. |
| `good_deal_badges` | array | No | Comma-separated badges. |
| `crit_air` | array | No | Comma-separated Crit'Air vignette codes. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/lacentrale/v1/taxonomy?families=AUTO"
```

## Example response

```json
{
    "success": true,
    "data": {
        "total": 342880,
        "makes": [
            {
                "name": "ABARTH",
                "count": 446
            }
        ],
        "models": [
            {
                "name": "500",
                "count": 416
            },
            {
                "name": "600E",
                "count": 14
            }
        ]
    },
    "meta": {
        "endpoint_family": "taxonomy"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Invalid aggregation found |  |
|  | Missing or invalid API key |  |
|  | Upstream service error |  |

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