API QUOTAZIONI IMMOBILIARI GEOREFERENZIATE

Il servizio fornisce quotazioni immobiliari a livello di singola via, di tutte le principali tipologie presenti nel territorio nazionale.

Il servizio offre quotazioni immobiliari dettagliate per singola via, coprendo tutte le principali tipologie di immobili presenti sul territorio nazionale. La qualità dei dati forniti è assicurata da un sistema statistico e informativo all'avanguardia per la gestione e la verifica dei valori.

DATI INPUT

Indirizzo immobile
Tipologia immobiliare
Contratto (vendita/affitto)

DATI OUTPUT

Nome zona immobiliare
Valore minimo €/m2
Valore medio €/m2
Valore massino €/m2

TIPOLOGIE QUOTATE

Abitazioni Economiche
Abitazioni Civili
Abitazioni Signorili
Ville e Villini
Negozi
Uffici
Box auto
Posti Auto coperti
Posti Auto scoperti
Laboratori
Magazzini
Capannoni artigianali
Capannoni industriali

Informazioni & Preventivi

API Quotazioni

Importa la nostra API in Postman Download

METODI API QUOTAZIONI

Metodo

getImmobiliType()

Per recuperare l'elenco delle tipologie immobiliari di cui è possibile eseguire una Valuazione.

(Questo metodo, non necessita della chiave identificativa Api Key)

$immobili = file_get_contents("https://api.borsinopro.it/rest/standard-v1/getImmobiliType/");

Nell'esempio appena descritto, utiliziamo una semplice funzione del php "file_get_contents"

Se invece stai utilizzando la nostra Classe PHP Borsino.class.php puoi invocare lo stesso metodo in questo modo:

$immobili = $Borsino->getImmobiliType();

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

                        {"method":"getImmobiliType","response":{"name":"type","label":"Tipologia immobiliare","type":"select","options":[{"id":"20","label":"Abitazioni in stabili civili"},{"id":"19","label":"Abitazioni in stabili signorili"},{"id":"21","label":"Abitazioni in stabili economici"},{"id":"1","label":"Ville e Villini"},{"id":"6","label":"Uffici"},{"id":"5","label":"Negozi"},{"id":"13","label":"Box e Autorimesse"},{"id":"14","label":"Posto auto coperti"},{"id":"15","label":"Posto auto scoperti"},{"id":"9","label":"Magazzini"},{"id":"10","label":"Laboratori"},{"id":"7","label":"Capannoni tipici"},{"id":"8","label":"Capannoni industriali"}],"required":true}}
                    

Metodo

getContractType()

Per recuperare l'elenco delle formule di contratto immobiliare di cui è possibile eseguire una Valuazione.

(Questo metodo, non necessita della chiave identificativa Api Key)

$contratti = file_get_contents("https://api.borsinopro.it/rest/standard-v1/getContractType/");

Come nella precedente chiamata, l'esempio appena descritto, utiliziamo una semplice funzione del php "file_get_contents",

Se invece stai utilizzando la nostra Classe PHP Borsino.class.php puoi invocare lo stesso metodo in questo modo:

$contratti = $Borsino->getContractType();

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

                        {"method":"getContractType","response":{"name":"for","label":"Tipo contratto","type":"select","options":{"rent":{"id":"rent","label":"Affitto"},"sale":{"id":"sale","label":"Vendita"}},"required":true}}
                    

Metodo

getAddress()

- Per identificare l'esatta ubicazione dell'immobile oggetto valutazione.

- Per recuperare l'elenco dei campi e select necessari ad effettuare valutazione.

IMPORTANTE: Per il metodo getAddress() và obbligatoriamente indicata la chiave identificativa Api Key.

Di seguito, la sintassi dimostrativa e semplificata, scritta in PHP Languages, da invocare dopo che l'utente ha indicato i campi preliminari obbligatori:

STEP One È il nome con cui identificheremo la schermata iniziale di inserimento dati, prevista dal flusso Api di Elaborazione Stima Immobiliare.

    
    # Struttura della chiamata:

    End-Point: https://api.borsinopro.it/rest/standard-v1/getAddress/

      $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-v1/getAddress/"); 
      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

    * address     indirizzo immobile
    Tipo Valore:    String
    Criteri:        Min 5 e Max 255 caratteri alfanumerici
    Esempio:        Via Asmara 24 Roma

    * type         tipo di immobile
    Tipo Valore:    Integer
    Criteri:        Option Integer - Selezionato dalla lista restituita da getImmobiliType()
    Esempio:        6 => "Uffici" , 20 => "Abitazioni in stabili civili"

    * for          tipo di contratto
    Tipo Valore:    String
    Criteri:        Option String - Selezionato dalla lista restituita da getContractType()
    Esempio:        sale => "Vendita" , rent => "Affitto"

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

                        {"method":"getAddress","response":{"id":"17686","nome":"Salario Africano - Viale Libia","id_citta":"2167","citta":"Roma","cod_cat":"H501","provincia":"RM","id_provincia":"86","id_regione":"7","regione":"Lazio","fascia":"semicentrale","address":"Via Asmara 24, Roma","formatted":"Via Asmara, 24, 00199 Roma RM, Italia","loc2011":"580912","coordinate":{"lat":41.92745,"lng":12.51875},"immobile":{"type":"Abitazioni in stabili civili","label":"Valori di Vendita Abitazioni in stabili civili al Mq","id":20},"quotazione":{"min":"2990","max":"4410","med":3700,"type":"sale"},"form":{"mq_coperti":{"name":"mq_coperti","label":"Mq Coperti","type":"number","max_length":"5","required":true,"note":"Comprese mura perimetrali"},"mq_balconi":{"name":"mq_balconi","label":"Mq Balconi","type":"number","max_length":"5","required":false},"mq_terrazzo":{"name":"mq_terrazzo","label":"Mq Terrazzo","type":"number","max_length":"5","required":false},"mq_giardino":{"name":"mq_giardino","label":"Mq Giardino","type":"number","max_length":"5","required":false},"cantina":{"name":"cantina","label":"Cantina","type":"select","options":{"2|0.00":"...","3|1.00":"Piccola","4|1.50":"Normale","5|2.00":"Grande","6|3.00":"Doppia","7|4.50":"Tripla","8|6.00":"Quadrupla","9|0.00":"Presente"},"required":false},"soffitta":{"name":"soffitta","label":"Soffitta","type":"select","options":{"2|0.00":"...","3|1.00":"Piccola","4|1.50":"Normale","5|2.00":"Grande","6|3.00":"Doppia","7|4.50":"Tripla","8|6.00":"Quadrupla","9|6.00":"Presente"},"required":false},"box_auto":{"name":"box_auto","label":"Box Auto","type":"select","options":{"2|0.00":"...","10|0.00":"Presente","3|6.00":"Molto piccolo (citycar)","4|7.00":"Piccolo (utilitaria)","5|9.00":"Normale (auto normale)","6|12.00":"Grande (auto grande)","7|16.00":"Doppio (2 auto normali)","8|20.00":"Triplo (3 auto normali)","9|25.00":"Quadruplo (4 auto normali)"},"required":false},"posto_auto_coperto":{"name":"posto_auto_coperto","label":"Posto Auto coperto","type":"select","options":{"2|0.00":"...","3|2.52":"Molto piccolo (citycar)","4|3.36":"Piccolo (utilitaria)","5|5.04":"Normale (auto normale)","6|6.30":"Grande (auto grande)","7|9.24":"Doppio (2 auto normali)","8|11.76":"Triplo (3 auto normali)"},"required":false},"posto_auto_scoperto":{"name":"posto_auto_scoperto","label":"Posto Auto Scoperto","type":"select","options":{"2|0.00":"...","3|1.68":"Molto piccolo (citycar)","4|2.24":"Piccolo (utilitaria)","5|3.36":"Normale (auto normale)","6|4.20":"Grande (auto grande)","7|6.16":"Doppio (2 auto normali)","8|7.84":"Triplo (3 auto normali)"},"required":false},"disponibilita_parcheggio":{"name":"disponibilita_parcheggio","label":"Disponibilita Parcheggio","type":"select","options":{"3|1.00":"Nella media di zona","2|0.85":"Più facile della media di zona","4|1.15":"Più difficoltosa della media di zona","5|1.35":"Molto più difficoltosa della media di zona"},"required":false},"piano":{"name":"piano","label":"Piano","type":"select","options":{"2":"Piano Interrato ","3":"Piano Seminterrato","4":"Piano Terra","5":"Piano Rialzato","6":"1 Piano","7":"1 Piano (piu alto dello standard)","8":"2 Piano ","9":"3 Piano","10":"4 Piano ","11":"5 Piano ","12":"6 Piano ","13":"7 Piano ","14":"8 Piano ","15":"9 Piano ","16":"10 Piano ","17":"Oltre il 10 Piano ","18":"Intero stabile fino a 3 piani","19":"Intero stabile 4 piani ed oltre"},"required":true},"ascensore":{"name":"ascensore","label":"Ascensore","type":"select","options":{"con_ascensore":"Con ascensore","senza_ascensore":"Senza ascensore","non_influente":"Non influente"},"required":false},"attico":{"name":"attico","label":"Attico","type":"select","options":{"1|1.00":"...","2|1.17":"Attico","3|1.17":"Superattico","4|1.07":"Attico con superattico","5|1.05":"Mansarda","6|1.10":"Ultimo piano"},"required":false},"stato_conservativo_interno":{"name":"stato_conservativo_interno","label":"Stato Conservativo Interni","type":"select","options":{"5":"Buono stato","2":"Completamente da ristrutturare","3":"Da ristrutturare","4":"Parzialmente da ristrutturare","6":"Ottimo stato","7":"Ristrutturato","8":"Nuova costruzione","9":"Parzialmente ristrutturato"},"required":false},"tipologia_edificio":{"name":"tipologia_edificio","label":"Tipologia Edificio","type":"select","options":{"6|1.00":"Civile","51|1.08":"Signorile","5|0.94":"Civile-Economico","7|1.06":"Medio-Signorile"},"required":false},"eta_dell_edificio":{"name":"eta_dell_edificio","label":"Periodo di Costruzione","type":"select","options":{"3|20_40_anni":"20-40 anni","1|1_5_anni":"1-5 anni","2|5_20_anni":"5-20 anni","4|Oltre_40_anni":"Oltre 40 anni","5|Epoca_ante_1930":"D'epoca antecedente 1930","6|Storico_ante_1900":"Storico antecedente 1900"},"required":false},"stato_di_conservazione_edificio":{"name":"stato_di_conservazione_edificio","label":"Stato Conservativo Edificio","type":"select","options":{"4":"Buono stato","2":"Da ristrutturare","3":"Da ripulire","5":"Ottimo stato","6":"Ristrutturato","7":"Nuova costruzione","8":"Parzialmente ristrutturato"},"required":false},"univoco":{"name":"univoco","type":"hidden","value":"20190624192117_5d11068db127c_20_223","required":true}}},"account":{"id":"223","name":"App Admin","license_id":"20","type":"admin","expiration":"2020-04-30 00:00:00","call_performed":67,"call_limit":"500","call_remain":433},"univoco":"20190624192117_5d11068db127c_20_223"}
                    

Metodo

getValutazione()

- Per recuperare i risultati della valutazione.

IMPORTANTE: Per il metodo getValutazione() và obbligatoriamente indicata la chiave identificativa Api Key.

Di seguito, la sintassi dimostrativa e semplificata, scritta in PHP Languages, da invocare:

STEP Two È il nome con cui identificheremo la schermata iniziale di inserimento dati, prevista dal flusso Api di Elaborazione Stima Immobiliare.

    
    # Struttura della chiamata:

    End-Point: https://api.borsinopro.it/rest/standard-v1/getValutazione/

      $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-v1/getValutazione/"); 
      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

    * i campi obbligatori sono indicati nella risposta $response->form restituiti nello Step One

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

                        {"method":"getValutazione","univoco":"20190624192117_5d11068db127c_20_223","account":{"id":"223","name":"App Admin","license_id":"20","type":"admin","expiration":"2020-04-30 00:00:00","call_performed":"72","call_limit":"500","call_remain":"428"},"response":{"zona":"Salario Africano - Viale Libia","citta":"Roma","address":"Via Asmara, 24, 00199 Roma RM, Italia","coordinate":{"lng":"12.51875","lat":"41.92745"},"contract":"sale","type":{"id":"20","label":"Abitazioni in stabili civili"},"mq_commerciali":128,"valore":{"basso":"246.873","mediobasso":"276.184","medio":"305.495","medioalto":"334.806","alto":"364.117"}}}
                    

Metodo

getQuotazione()

- Per identificare l'esatta ubicazione della zona immobiliare.

- Per recuperare le quotazioni risultanti.

IMPORTANTE: Per il metodo getQuotazioni() và obbligatoriamente indicata la chiave identificativa Api Key.

Di seguito, la sintassi dimostrativa e semplificata, scritta in PHP Languages, da invocare dopo che l'utente ha indicato i campi preliminari obbligatori:

STEP Quote È il nome con cui identificheremo la schermata iniziale di inserimento dati, prevista dal flusso Api di Elaborazione Stima Immobiliare.

    
    # Struttura della chiamata:

    End-Point: https://api.borsinopro.it/rest/standard-v1/getQuotazione/

      $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-v1/getQuotazione/"); 
      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

    * address     indirizzo immobile
    Tipo Valore:    String
    Criteri:        Min 5 e Max 255 caratteri alfanumerici
    Esempio:        Via Asmara 24 Roma

    * type         tipo di immobile
    Tipo Valore:    Integer
    Criteri:        Option Integer - Selezionato dalla lista restituita da getImmobiliType()
    Esempio:        6 => "Uffici" , 20 => "Abitazioni in stabili civili"

    * for          tipo di contratto
    Tipo Valore:    String
    Criteri:        Option String - Selezionato dalla lista restituita da getContractType()
    Esempio:        sale => "Vendita" , rent => "Affitto"

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

                        {"method":"getQuotazione","response":{"id":"17686","nome":"Salario Africano - Viale Libia","id_citta":"2167","citta":"Roma","cod_cat":"H501","provincia":"RM","id_provincia":"86","id_regione":"7","regione":"Lazio","fascia":"semicentrale","address":"via asmara 24 roma","formatted":"Via Asmara, 24, 00199 Roma RM, Italia","loc2011":"580912","coordinate":{"lat":41.92745,"lng":12.51875},"immobile":{"type":"Abitazioni in stabili civili","label":"Valori di Vendita Abitazioni in stabili civili al Mq","id":20},"quotazione":{"min":"2990","max":"4410","med":"3700","type":"sale","anno":2020,"semestre":2}},"account":{"id":"223","name":"App Admin","license_id":"20","type":"admin","expiration":"2020-04-30 00:00:00","call_performed":79,"call_limit":"500","call_remain":421},"univoco":"20190624192117_5d11068db127c_20_223"}
                    

Metodo

getConsoData()

IMPORTANTE: Per il metodo getConsoData() di seguito descritta in questa Guida allo Sviluppo, và obbligatoriamente indicata la chiave identificativa Api Key.

Di seguito, la sintassi dimostrativa e semplificata, scritta in PHP Languages, da invocare con i relativi campi obbligatori:

    
    # Struttura della chiamata:

    End-Point: https://api.borsinopro.it/rest/standard-v1/getConsoData/

      $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-v1/getConsoData/"); 
      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 facoltativi in ordine di priorità

    codcat     codice catastale
    Tipo Valore:    String
    Criteri:        Min 3 e Max 7 caratteri alfanumerici
    Esempio:        H501

    citta     nome Comune
    Tipo Valore:    String
    Criteri:        Min 2 e Max 100 caratteri alfanumerici
    Esempio:        Fiano Romano
    
    address     indirizzo immobile
    Tipo Valore:    String
    Criteri:        Min 5 e Max 255 caratteri alfanumerici
    Esempio:        Via Asmara 24 Roma

    
    
    # Campi * obbligatori da inviare in POST

    * type         tipo di immobile
    Tipo Valore:    Integer
    Criteri:        Option Integer - Selezionato dalla lista restituita da getImmobiliType()
    Esempio:        6 => "Uffici" , 20 => "Abitazioni in stabili civili"

    * for          tipo di contratto
    Tipo Valore:    String
    Criteri:        Option String - Selezionato dalla lista restituita da getContractType()
    Esempio:        sale => "Vendita" , rent => "Affitto"

Cosa Restituisce

La chiamata alla Api Services restituirà un pacchetto dati di tipo Content-Type: application/json

                        {"estimate":{"min_db":7.4,"max_db":10.98,"med_db":9.19},"contract":"Valori di Affitto al M²","unique":"20190718130308_5d3051ecb33c4_20_223","account":{"id":"223","name":"Conso Data","expiration":"2020-04-30 00:00:00","call_performed":127},"message":"Media Quotazione Valori Affitto - Comune: Roma - Identificato con Codice Catastale H501"}
                    

Le varianti del campo "message" in base ai criteri di ricerca

"Media Quotazione Valori Affitto - Comune: Fiano Romano - Tipologia: Abitazioni in stabili civili"

"Media Quotazione Valori Affitto - Via Asmara, 24, 00199 Roma RM - Abitazioni in stabili civili"