# Subito.it Listing API Documentation

<p><strong>Subito.it Listing API Documentation</strong> Read a single Subito.it ad by its urn from search: subject, body, public url, category, price in EUR, features, location with coordinates, images, publish and expiry dates (ISO 8601 UTC) and public advertiser info. Private contact data is never returned. An ad that no longer exists answers 404 NOT_FOUND and is not billable.</p>

- **Documentation:** [https://scrappa.co/docs/subito-api/subito_listing](https://scrappa.co/docs/subito-api/subito_listing)
- **API group:** Subito.it API
- **Endpoint:** `GET https://scrappa.co/api/subito/listing`

## 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 | Full ad urn from search, e.g. id:ad:612919294:list:664696487. |

## Example response

```json
{
    "data": {
        "id": "612919294",
        "url": "https://www.subito.it/appartamenti/appartamento-milano-g-b-stoppanivrg-milano-664696487.htm",
        "urn": "id:ad:612919294:list:664696487",
        "body": "In elegante stabile d'epoca, dotato di servizio di portineria, la nostra Agenzia propone in vendita un ampio bilocale caratterizzato da generose metrature e da una piacevole vivibilit\u00e0 degli spazi.\n\nL'immobile composto da ingresso, luminoso soggiorno living con cucina a vista, camera matrimoniale, doppi servizi entrambi finestrati e pratico ripostiglio in quota.\n\nPunto di forza della propriet\u00e0 \u00e8 l'ampio terrazzo di circa 30 mq. Data la sua esposizione interna rende l'ambiente unico e silenzioso,",
        "type": {
            "key": "s",
            "value": "In vendita"
        },
        "dates": {
            "expires_at": "2027-10-15T19:08:06Z",
            "published_at": "2026-10-15T19:08:06Z"
        },
        "price": {
            "amount": 565000,
            "currency": "EUR"
        },
        "images": [
            "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/85/85e5c2ef-9274-4b64-a07b-0a14be284a44?rule=gallery-desktop-2x-auto",
            "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/19/192f6bec-73a7-4dbc-bc7f-d8f90e9d18f8?rule=gallery-desktop-2x-auto",
            "https://images.sbito.it/api/v1/sbt-ads-images-pro/images/9e/9eee0298-7a22-45e0-a4c6-e3df4ec2d72a?rule=gallery-desktop-2x-auto"
        ],
        "subject": "Appartamento Milano [G.B. - STOPPANIVRG]",
        "category": {
            "key": 7,
            "value": "Appartamenti",
            "friendly_name": "appartamenti",
            "macrocategory_id": 6
        },
        "features": {
            "room": {
                "label": "Locali",
                "value": "2"
            },
            "size": {
                "label": "Superficie",
                "value": 81,
                "display": "81 mq"
            },
            "floor": {
                "label": "Piano",
                "value": "1"
            },
            "heating": {
                "label": "Riscaldamento",
                "value": "Centralizzato"
            },
            "bathrooms": {
                "label": "Bagni",
                "value": "2"
            },
            "nosalesman": {
                "label": "Agenzie/Tmkg",
                "value": true
            },
            "energy_class": {
                "label": "Classe energetica",
                "value": "F"
            },
            "air_conditioning": {
                "label": "Aria condizionata",
                "value": true
            },
            "building_condition": {
                "label": "Stato",
                "value": "Ottimo - ristrutturato"
            }
        },
        "location": {
            "lat": 45.466647,
            "lon": 9.190648,
            "town": "Milano",
            "region": "Lombardia",
            "province": "Milano",
            "region_key": 4,
            "town_istat": "015146",
            "province_key": 8,
            "province_code": "MI"
        },
        "advertiser": {
            "name": "Milano Piazzale Abbiategrasso",
            "type": 1,
            "company": true,
            "shop_id": 14475,
            "shop_name": "Gabetti Milano Piazzale Abbiategrasso"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable and makes no upstream call. |
| 404 | Resource Not Found | The ad no longer exists or the urn is unknown. This response is not billable. |
| 503 | Invalid Source Response | Subito answered with a shape that no longer matches the documented contract. This response is not billable. |
| 503 | Service 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)