This service allows you to seek information about deeds of sale of various real estates in Italy
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://compravenditeimmobiliari.openapi.it/categories"); CURLcode ret = curl_easy_perform(hnd);
{- "data": [
- {
- "tipologia": "residenziale",
- "categorie_catastali": [
- "A01",
- "A02",
- "A03"
]
}, - {
- "tipologia": "pertinenziale",
- "categorie_catastali": [
- "C02",
- "C06"
]
}
], - "success": true,
- "message": "",
- "error": null
}
With this endpoint you can search for deeds of sales that match your query. The results will always be returned in order of distance from the starting_point that you provided and will be from the most recent to the oldest that match the query parameters.
Please note that distances and areas are always reported in meters unless specified differently.
To get all the available tipologie and categorie _catastali please use the /categories endpoint.
If you need to find out the coordinates for a specific locaiton, please take a look at the Geocoding API
Test environment
The test environment is loaded with a smaller dataset which allows you to make test requests while developing the service. All the deeds of sales in the test environment are placed around 40.85571, 14.23040
dry_run | boolean Default: false Allows you to estimate the cost of the request by returning the amount of documents found. Please see the |
object | |
limit | integer Default: 50 The amount of results that can be returned on a single API call. You will be billed only on the number of the returned results |
tipologia | string (CategoriaImmobili) Default: "<string>" Enum: "residenziale" "non_residenziale" "pertinenziale" |
categorie_catastali | Array of strings <= 2 items If null is given, it will match all the available categories. |
search_radius | integer Default: "<integer>" Search radius from the 'starting point' |
max_surface | integer Default: "<integer>" |
min_surface | integer Default: "<integer>" |
max_price | integer Default: "<integer>" Maximum worth in Euro |
min_price | integer Default: 0 |
object | |
object |
Array of objects (SearchResponse) [ items ] | |
success | boolean |
message | string |
{- "dry_run": false,
- "starting_point": {
- "lat": 40.8582,
- "long": 14.169901
}, - "tipologia": "residenziale",
- "search_radius": 15000,
- "max_surface": 100000000,
- "max_price": 900000,
- "from_date": {
- "year": 2019,
- "month": 1
}, - "to_date": {
- "year": 2021,
- "month": 12
}
}
{- "data": {
- "found": 1,
- "result": [
- {
- "immobili": [
- {
- "CODCAT": "B285",
- "dizione": "BUSCA",
- "tipologiaAtto": "Residenziale",
- "zonaOmi": "C1",
- "decodificaAtto": "Residenziale singolo",
- "tipologia": "Residenziale",
- "categoriaCat": "C06",
- "settoreMercato": "PER",
- "anno": 2019,
- "coduff": "CN00",
- "regpart": "720",
- "totaleImmobili": 2,
- "quotaFavore": "1",
- "indirizzo": "CORSO GIUSEPPE ROMITA 000051",
- "consistenza": "23 mq",
- "regione": "Piemonte",
- "provincia": "CN",
- "citta": "Busca",
- "zona": "ZONA SEMICENTRALE NORD-OVEST",
- "superfice": 23,
- "location_point": {
- "type": "Point",
- "coordinates": [
- 44.519777036017324,
- 7.477693098507002
]
}, - "distanza": 0.849734280082744,
- "mese": 1
}, - {
- "CODCAT": "B285",
- "dizione": "BUSCA",
- "tipologiaAtto": "Residenziale",
- "zonaOmi": "C1",
- "decodificaAtto": "Residenziale singolo",
- "tipologia": "Residenziale",
- "categoriaCat": "A02",
- "settoreMercato": "RES",
- "anno": 2019,
- "coduff": "CN00",
- "regpart": "720",
- "totaleImmobili": 2,
- "quotaFavore": "1",
- "indirizzo": "CORSO GIUSEPPE ROMITA 000051",
- "consistenza": "4 vani",
- "regione": "Piemonte",
- "provincia": "CN",
- "citta": "Busca",
- "zona": "ZONA SEMICENTRALE NORD-OVEST",
- "superfice": 64,
- "location_point": {
- "type": "Point",
- "coordinates": [
- 44.519777036017324,
- 7.477693098507002
]
}, - "distanza": 0.849734280082744,
- "mese": 1
}
], - "atto_vendita": "CN002019000720",
- "totale_immobili": 2,
- "prezzo": 111797
}
]
}, - "success": true,
- "message": ""
}