# Subito.it Auto Filter Values

Aggregated filter reference data from the upstream values endpoints: category tree, ad types, seller types, price buckets, vehicle status, fuels, emission classes, body types, equipment keys, colors, gearboxes, doors, years and mileage buckets. Use the keys as search filter values. Best-effort datasources that the upstream cannot reach are omitted instead of failing the request.

- **Documentation:** [https://scrappa.co/docs/subito-motori-api/subito_motori_filters](https://scrappa.co/docs/subito-motori-api/subito_motori_filters)
- **API group:** Subito.it Auto API
- **Endpoint:** `GET https://scrappa.co/api/subito-motori/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.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `category` | integer | No | Category id. 2 = Auto. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/subito-motori/filters?category=2"
```

## Example response

```json
{
    "success": true,
    "data": {
        "categories": [
            {
                "key": "2",
                "value": "Auto",
                "friendly_name": "auto"
            }
        ],
        "adtypes": [
            {
                "key": "s",
                "value": "In vendita"
            }
        ],
        "advertiser_types": [
            {
                "key": "1",
                "value": "Rivenditore"
            }
        ],
        "prices": [
            {
                "key": "10000",
                "value": "10000"
            }
        ]
    },
    "meta": {
        "endpoint_family": "filters"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter or range is invalid. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result. This response is not billable. |

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