L'API è stata sostituita dai nuovi endpoint disponibili in Real Estate
Verifica l'effettivo valore di immobili con il reale compravenduto in una determinata area
Deprecated starting from 2024-12-31
Tutte le informazioni di cui hai bisogno
Qui trovi qualche consiglio da prendere in considerazione per approcciare a questa API. Se preferisci forniamo esempi di codice, documentazione in OAS3, la possibilità di provare l'API dal vivo con la Swagger UI oppure importare l'intera collezione in Postman. Offriamo inoltre un ambiente di Sandbox dove puoi sperimentare tutte le API gratuitamente.
Prendi il token nell'apposita sezione prima di cominciare.
- Oas file url https://console.openapi.com/oas/it/compravenditeimmobiliari.openapi.json
- Fork or import with Postman
- Production domain compravenditeimmobiliari.openapi.it
- Sandbox domain test.compravenditeimmobiliari.openapi.it
- Production Scopes 2
-
Sandbox Scopes 2
- POST test.compravenditeimmobiliari.openapi.it/search
- GET test.compravenditeimmobiliari.openapi.it/categories
Compravendite Immobiliari (1.0.0)
Questo servizio permette di ricercare informazioni sugli atti di vendita di vari immobili in Italia
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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);
Response samples
- 200
- "data": [
- {
- "tipologia": "residenziale",
- "categorie_catastali": [
- "A01",
- "A02",
- "A03"
- {
- "tipologia": "pertinenziale",
- "categorie_catastali": [
- "C02",
- "C06"
- "success": true,
- "message": "",
- "error": null
Ricerca di vendite intorno a un determinato Geopoint
Con questo endpoint è possibile cercare atti di vendita che corrispondono alla propria query. I risultati verranno sempre restituiti in ordine di distanza dal punto_di_inizio fornito e saranno dal più recente al più vecchio che corrisponde ai parametri della query.
Si prega di notare che le distanze e le aree sono sempre riportate in metri a meno che non sia specificato diversamente.
Per ottenere tutte le tipologie e le categorie _catastali disponibili si prega di utilizzare l'endpoint /categorie.
Se avete bisogno di trovare le coordinate per una specifica località, date un'occhiata alla Geocoding API
Ambiente di prova
L'ambiente di prova è caricato con un set di dati più piccolo che consente di effettuare richieste di prova durante lo sviluppo del servizio. Tutti gli atti di vendita nell'ambiente di test sono collocati intorno a 40.85571, 14.23040
Authorizations:
Request Body schema: application/json
dry_run | boolean Default: false Permette di stimare il costo della richiesta restituendo la quantità di documenti trovati. Si veda l'esempio di risposta di Corsa a vuoto' riportato di seguito. L'array risultato` sarà vuoto. |
object | |
limit | integer Default: 50 Il numero di risultati che possono essere restituiti con una singola chiamata API. Verrà addebitato solo il numero di risultati restituiti. |
tipologia | string (CategoriaImmobili) Enum: "residenziale" "non_residenziale" "pertinenziale" |
categorie_catastali | Array of strings Se viene dato null, corrisponderà a tutte le categorie disponibili. |
search_radius | integer Raggio di ricerca dal "punto di partenza |
max_surface | integer |
min_surface | integer |
max_price | integer Valore massimo in euro |
min_price | integer Default: 0 |
object | |
object |
Responses
Response Schema: application/json
Array of objects (SearchResponse) | |
success | boolean |
message | string |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "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
Response samples
- 200
- 401
- 404
- "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": ""