API COMPARABILI
Partendo da un indirizzo (o coordinate) e il servizio fornisce la lista di 10 compravendite limitrofe avvenute, con ubicazione esatta, prezzo dichiarato in atto, dimensione immobile e data di vendita.
Il nostro servizio API Comparabili offre un database esteso di immobili effettivamente venduti, permettendo agli utenti di effettuare analisi comparative dettagliate. Questo strumento è indispensabile per valutare il valore di mercato di un immobile in base a vendite simili nell'area di interesse. Ideale per valutatori, agenti immobiliari e analisti, le API Comparabili forniscono dati concreti e verificabili per supportare valutazioni e decisioni immobiliari.
- Tipologia immobile
- Indirizzo immobile
- Tipologia immobiliare
- Raggio di ricerca
- Importo minimo
- Importo massimo
- Anno inizio ricerca
- Mese inizio ricerca
- Anno fine ricerca
- Mese fine ricerca
- Categoria catastale
- Altri dati (differenziati per tipologia)
- Nome zona immobiliare
- M2 Superficie commerciale
- Coordinate Geografiche
- Prezzo Vendita €
- Anno stipula
- Mese stipula
- Zona OMI
- Categoria Catastale
- Settore di mercato
- Immobili Residenziali
- Immobili Non Residenziali
- Pertinenziali
METODI API COMPARABILI
Metodo
getCategCatastale()
Per recuperare l'elenco delle Categorie Catastali di cui è possibile eseguire una ricerca dei comparabili.
(Questo metodo, non necessita della chiave identificativa
Api Key)
$immobili = file_get_contents("https://api.borsinopro.it/rest/standard-v5/getCategCatastale/");
Nell'esempio appena descritto, utiliziamo una semplice funzione del php "file_get_contents"
Cosa Restituisce
La chiamata alla Api Services restituirà un pacchetto dati di tipo Content-Type: application/json, che andremo successivamente a suddividere ed analizzare nel dettaglio
Metodo
getComparabili()
- Per recuperare i risultati degli immobili venduti.
IMPORTANTE: Per il metodo getComparabili() và obbligatoriamente indicata la chiave identificativa Api Key.
Di seguito, la sintassi dimostrativa e semplificata, scritta in PHP Languages, da invocare:
# Struttura della chiamata:
End-Point: https://api.borsinopro.it/rest/standard-v5/getComparabili/
$curl_call = curl_init();
curl_setopt($curl_call, CURLOPT_HEADER, false);
curl_setopt($curl_call, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl_call, CURLOPT_USERPWD, "Api Key");
curl_setopt($curl_call, CURLOPT_URL, "https://api.borsinopro.it/rest/standard-v5/getComparabili/");
curl_setopt($curl_call, CURLOPT_POST, true);
curl_setopt($curl_call, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl_call, CURLOPT_POSTFIELDS, $_POST);
curl_setopt($curl_call, CURLOPT_SSL_VERIFYPEER, false);
$result = curl_exec($curl_call);
curl_close($curl_call);
# Campi * obbligatori da inviare in POST
* decodificaAtto tipo di immobile
Tipo Valore: Integer
Criteri: valori consentiti 1, 2, 3
Esempio: 1 => "Immobili Residenziali", 2 => "Immobili Non Residenziali", 3 => "Pertinenziali"
raggio_ricerca area di ricerca espressa in metri
Tipo Valore: Integer
Criteri: valore minimo 50, valore massimo 20000
(se non dichiarato, default: 250)
Esempio: 250, 500, 1000, 2000
amount_min importo minimo di ricerca
Tipo Valore: Integer
Criteri: esprimere i valori interi in euro senza punteggiatura
(se non dichiarato, non viene utilizzato come criterio selettivo)
Esempio: 100000
amount_max importo massimo di ricerca
Tipo Valore: Integer
Criteri: esprimere i valori interi in euro senza punteggiatura
(se non dichiarato, non viene utilizzato come criterio selettivo)
Esempio: 900000
annoS anno di inizio ricerca
Tipo Valore: Integer
Criteri: valore intero partendo dal 2019
(se non dichiarato, vengono presi in considerazione gli ultimi 2 anni)
Esempio: 2019
meseS mese di inizio ricerca
Tipo Valore: String
Criteri: valore intero compreso tra 1 e 12
(se non dichiarato, vengono presi in considerazione il mese corrente degli ultimi 2 anni)
Esempio: 01, 02, 03, .. , 12
annoE anno di fine ricerca
Tipo Valore: Integer
Criteri: valore intero corrispondente all'anno di fine ricerca
(se non dichiarato, vengono presi in considerazione gli ultimi 2 anni)
Esempio: 2023
meseE mese di fine ricerca
Tipo Valore: String
Criteri: valore intero compreso tra 1 e 12
(se non dichiarato, vengono presi in considerazione il mese corrente degli ultimi 2 anni)
Esempio: 01, 02, 03, .. , 12
cc[] tipo di contratto
Tipo Valore: String
Criteri: Valore Catastale Selezionato dalla lista restituita da getCategCatastale()
Esempio: A01, A02.., C01, C02.., D01, D02..
# È possibile effettuare la ricerca per *indirizzo o per *geo-coordinate
** indirizzo indirizzo immobile
Tipo Valore: String
Criteri: Min 5 e Max 255 caratteri alfanumerici
Esempio: Via Asmara 24 Roma
** lat latitudine coordinate
Tipo Valore: String
Criteri: valore latitudine tipo Decimal-degree(WGS84)
Esempio: 49.887009
** lng longitudine coordinate
Tipo Valore: String
Criteri: valore longitudine tipo Decimal-degree(WGS84)
Esempio: 12.512859
Cosa Restituisce
La chiamata alla Api Services restituirà un pacchetto dati di tipo Content-Type: application/json, che andremo successivamente a suddividere ed analizzare nel dettaglio