# Subito.it Auto Listing

Full detail for a single listing by ad URN. Includes all vehicle specs (make/model/version pack, fuel, gearbox, body, doors, seats, emission class, color, year, registration date, power, mileage), price with currency, images, location and public seller info. Private seller contact data is never surfaced. A gone listing answers with an empty result, which is valid and billable.

- **Documentation:** [https://scrappa.co/docs/subito-motori-api/subito_motori_listing](https://scrappa.co/docs/subito-motori-api/subito_motori_listing)
- **API group:** Subito.it Auto API
- **Endpoint:** `GET https://scrappa.co/api/subito-motori/listings/{urn}`

## 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 |
| --- | --- | --- | --- |
| `urn` | string | Yes | Ad URN from search, e.g. id:ad:1dee1017-23f7-4f79-a4ca-ebf584d0e26b:list:664155445. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/subito-motori/listings/{urn}?urn=id%3Aad%3A1dee1017-23f7-4f79-a4ca-ebf584d0e26b%3Alist%3A664155445"
```

## Example response

```json
{
    "success": true,
    "data": {
        "count_all": 1,
        "lines": 1,
        "ads": [
            {
                "urn": "id:ad:1dee1017-23f7-4f79-a4ca-ebf584d0e26b:list:664155445",
                "title": "Nissan Patrol GR 2.8 TD",
                "price": {
                    "amount": 13000,
                    "currency": "EUR"
                },
                "vehicle": {
                    "make": {
                        "key": "000149",
                        "value": "NISSAN"
                    },
                    "model": {
                        "key": "003009",
                        "value": "Patrol GR 2\u00aa serie"
                    },
                    "version": {
                        "key": "046129",
                        "value": "Patrol GR 2.8 TD 3 porte SE Hard Top"
                    }
                },
                "fuel": {
                    "key": "2",
                    "value": "Diesel"
                },
                "mileage": {
                    "km": 202000,
                    "unit": "km"
                },
                "power": {
                    "kw": 95,
                    "cv": 129
                },
                "location": {
                    "region": {
                        "key": "2",
                        "value": "Piemonte"
                    },
                    "province": {
                        "key": "3",
                        "value": "Biella"
                    },
                    "municipality": {
                        "key": "096009",
                        "value": "Camandona"
                    }
                },
                "url": "https://www.subito.it/auto/nissan-patrol-se-del-1999-cc2800-biella-664155445.htm"
            }
        ]
    },
    "meta": {
        "endpoint_family": "listing"
    }
}
```

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