# Subito.it Auto Search

Search current Subito.it Auto listings (category 2). Filter by brand, model, price, mileage, first-registration year, power, fuel, gearbox, body type, equipment, seller type, region and municipality. Sort by date, relevance, price, year, mileage or power. Offset pagination with a cap of 10 000: at the cap the upstream answers an empty result, which is a valid billable empty. has_more is computed from the live total.

- **Documentation:** [https://scrappa.co/docs/subito-motori-api/subito_motori_search](https://scrappa.co/docs/subito-motori-api/subito_motori_search)
- **API group:** Subito.it Auto API
- **Endpoint:** `GET https://scrappa.co/api/subito-motori/search`

## 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 |
| --- | --- | --- | --- |
| `c` | integer | No | Category id. 2 = Auto. |
| `q` | string | No | Free text search, e.g. panda. |
| `qso` | boolean | No | Restrict the free text search to ad titles. |
| `cb` | string | No | 6-digit brand key from the makes endpoint, e.g. 000008 = FIAT. |
| `cm` | array | No | Repeatable 6-digit model key from the models endpoint, e.g. 003415. |
| `t` | string | No | s = In vendita, k = Cercasi, g, u, h. |
| `sort` | string | No | datedesc, relevance, priceasc, pricedesc, yearasc, yeardesc, mileageasc, mileagedesc, hpasc, hpdesc, vlenasc or vlendesc. |
| `ps` | integer | No | Minimum price bucket in EUR from the filters endpoint. |
| `pe` | integer | No | Maximum price bucket in EUR from the filters endpoint. |
| `ms` | integer | No | Minimum mileage bucket in km from the filters endpoint. |
| `me` | integer | No | Maximum mileage bucket in km from the filters endpoint. |
| `ys` | integer | No | Minimum first-registration year. |
| `ye` | integer | No | Maximum first-registration year. |
| `hps` | integer | No | Minimum power in CV. |
| `hpe` | integer | No | Maximum power in CV. |
| `eps` | integer | No | Minimum power in kW. |
| `epe` | integer | No | Maximum power in kW. |
| `fl` | array | No | Repeatable fuel code: 1 petrol, 2 diesel, 3 lpg, 4 electric, 6 hybrid, 7 methane. |
| `gr` | integer | No | 1 manual, 2 automatic, 3 sequential, 4 other. |
| `ct` | array | No | Repeatable body code: 1 utilitaria, 2 berlina, 3 wagon, 4 minivan, 5 SUV, 6 cabrio, 7 coupé, 8 microcar. |
| `pl` | array | No | Repeatable emission class 1-13 (13 = euro6e). |
| `cl` | array | No | Repeatable color code 1-10. |
| `cvs` | array | No | Repeatable condition: 1 usato, 2 km0, 3 nuovo. |
| `dr` | integer | No | 1 = 2/3, 2 = 4/5, 3 = 6/7. |
| `ss` | integer | No | Minimum seat count. |
| `se` | integer | No | Maximum seat count. |
| `advt` | array | No | Repeatable seller type: 0,2 = privato, 1 = rivenditore (dealer). |
| `eq` | array | No | Repeatable equipment key from the filters endpoint. |
| `ic` | array | No | Repeatable condition code 10-50 (subitopy). |
| `r` | integer | No | Region key 1-20, e.g. 15 = Campania. |
| `ci` | integer | No | Province/city key from the geo taxonomy, e.g. 4 = Napoli. |
| `to` | string | No | 6-digit ISTAT municipality code, e.g. 063049. |
| `ndo` | boolean | No | Only listings for new drivers. |
| `urg` | boolean | No | Only urgent listings. |
| `shp` | boolean | No | Only shippable listings. |
| `vatd` | boolean | No | Only VAT-deductible listings. |
| `qltsf` | boolean | No | Only quality-certified listings. |
| `qsms` | array | No | Repeatable quality seal key from the filters endpoint. |
| `lim` | integer | No | Listings per page, 1-100. Defaults to 30. |
| `start` | integer | No | Zero-based result offset. The upstream caps at 10 000 and answers an empty result there. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/subito-motori/search?c=2&cb=000008&ps=10000&pe=20000&lim=2"
```

## Example response

```json
{
    "success": true,
    "data": {
        "count_all": 19499,
        "lines": 2,
        "start": 2,
        "has_more": true,
        "filters": {
            "c": "Auto",
            "cb": "FIAT",
            "ps": "10.000",
            "pe": "20.000"
        },
        "ads": [
            {
                "urn": "id:ad:f1b5e9e8-8ea8-48ee-84a7-03e3b697e384:list:664168473",
                "title": "Fiat 500 cabrio Dolcevita",
                "price": {
                    "amount": 16500,
                    "currency": "EUR"
                },
                "vehicle": {
                    "make": {
                        "key": "000008",
                        "value": "FIAT"
                    }
                },
                "location": {
                    "region": {
                        "key": "2",
                        "value": "Piemonte"
                    }
                },
                "seller": {
                    "user_id": "101581240",
                    "is_dealer": false
                }
            }
        ],
        "meta": {
            "endpoint_family": "search"
        }
    }
}
```

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