Valutometro (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

Web service that, starting from a search by address, allows you to pull out real estate quotes, valuations and trends.

First time here? Generate a new access token

Contratti - Immobili

Methods to see all types of contracts and properties available for research

List of property types

This method shows you the list of all property types

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	Array of objects (TipoImmobile) [ items ]
success	boolean
message	string
error	integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://valutometro.altravia.com/immobili");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": [{"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"
}
],
"success": true,
"message": "",
"error": null
}

Specific property

This method shows you the specific type of property

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: 20

Property type

Responses

Response Schema: application/json

	object (TipoImmobile)
success	boolean
message	string
error	integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://valutometro.altravia.com/immobili/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
404

Content type

application/json

{"data": {"id": "20",
"label": "Abitazioni in stabili civili"
},
"success": true,
"message": "",
"error": null
}

List of contract types

This method shows you the list of all contract types

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	Array of objects (TipoContratto) [ items ]
success	boolean
message	string
error	integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://valutometro.altravia.com/contratti");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": [{"id": "rent",
"label": "Affitto"
},
{"id": "sale",
"label": "Vendita"
}
],
"success": true,
"message": "",
"error": null
}

Specific contract

This method shows you the specific type of contract

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Example: rent

Contract type

Responses

Response Schema: application/json

	object (TipoContratto)
success	boolean
message	string
error	integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://valutometro.altravia.com/contratti/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200
404

Content type

application/json

{"data": {"id": "sale",
"label": "Vendita"
},
"success": true,
"message": "",
"error": null
}

Quotazioni

Method for the quotation of a property

Quotes of a property

Method that allows you to see the price of a property starting from the address

Authorizations:

bearerAuth

Request Body schema: application/json

indirizzo required	string Default: "<string>" real estate address
tipo_immobile required	string Default: "<string>" 20
tipo_contratto required	string Default: "<string>" sale

Responses

Response Schema: application/json

	object (ResponseQuotazione)
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{"indirizzo": "via del rivo 10 Terni",
"tipo_immobile": "20",
"tipo_contratto": "sale"
}

Response samples

200
402
404
406
428

Content type

application/json

{"data": {"id": "5f842816568fa17f473718a4",
"nome": "Borgo Rivo, Campitello, Gabelletta, Citta Verde, Ponte Le Cave",
"id_citta": "7432",
"citta": "Terni",
"cod_cat": "L117",
"provincia": "TR",
"id_provincia": "96",
"id_regione": "18",
"regione": "Umbria",
"fascia": "semicentrale",
"address": "via del rivo 10 Terni",
"formatted": "Via del Rivo, 10, 05100 Terni TR, Italia",
"loc2011": "5503210016",
"coordinate": {"lat": 42.57712,
"lng": 12.62637
},
"immobile": {"type": "Abitazioni in stabili civili",
"label": "Valori di Vendita Abitazioni in stabili civili al Mq",
"id": 20
},
"quotazione": {"min": 783,
"max": 1145,
"med": 964,
"type": "sale"
},
"timestamp": 1602496534,
"owner": "[email protected]"
},
"message": "",
"success": true,
"error": null
}

Tendenze

Methods to know the market trends

Trend of a geographical area

Method that returns the trends, data and market indicators of a given geographical area

Authorizations:

bearerAuth

Request Body schema: application/json

indirizzo required	string Default: "<string>" real estate address
tipo_immobile required	string Default: "<string>" 20
tipo_contratto required	string Default: "<string>" sale

Responses

Response Schema: application/json

	object (ResponseTendenza)
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{"indirizzo": "via gabelletta 1 Terni",
"tipo_immobile": "20",
"tipo_contratto": "sale"
}

Response samples

200
402
404
406
428

Content type

application/json

{"data": {"id": "61b363107c658f6dcc18eae7",
"nome": "Borgo Rivo, Campitello, Gabelletta, Citta Verde, Ponte Le Cave",
"id_citta": "7432",
"citta": "Terni",
"cod_cat": "L117",
"provincia": "TR",
"id_provincia": "96",
"id_regione": "18",
"regione": "Umbria",
"fascia": "semicentrale",
"address": "via gabelletta 1 Terni",
"formatted": "Via Gabelletta, 1, 05100 Terni TR, Italia",
"loc2011": "5503210016",
"coordinate": {"lat": 42.59134,
"lng": 12.57363
},
"immobile": {"type": "Abitazioni in stabili civili",
"label": "Valori di Vendita Abitazioni in stabili civili al Mq",
"id": 20
},
"quotazione": {"min": 599,
"max": 876,
"med": 737,
"type": "sale"
},
"ripartizione_annunci": {"vendita": {"1": {"tipologia": "Appartamenti",
"percentuale": 77.27000000000001
},
"2": {"tipologia": "Locali ed Uffici",
"percentuale": 6.819999999999999
},
"12": {"tipologia": "Ville e Villini",
"percentuale": 15.4
},
"14": {"tipologia": "Box e Garage",
"percentuale": 0.51
}
},
"affitto": {"1": {"tipologia": "Appartamenti",
"percentuale": 59.089999999999996
},
"2": {"tipologia": "Locali ed Uffici",
"percentuale": 33.33
},
"12": {"tipologia": "Ville e Villini",
"percentuale": 4.55
},
"14": {"tipologia": "Box e Garage",
"percentuale": 3.0300000000000002
}
}
},
"dimensioni": [{"label": "0-50 Mq",
"percentuale": 3.59
},
{"label": "50-85 Mq",
"percentuale": 32.35
},
{"label": "85-115 Mq",
"percentuale": 38.56
},
{"label": "115-145 Mq",
"percentuale": 11.44
},
{"label": "Oltre 145 Mq",
"percentuale": 14.05
}
],
"capoluogi_vendite_zona": {"2017": {"num_abitazioni_zona": "9225",
"numero_abitazioni_vendute": "131",
"perc_variazione_annuale": "-23.8",
"dinamicita_mercato_residenziale": "medio bassa"
},
"2018": {"num_abitazioni_zona": "9149",
"numero_abitazioni_vendute": "166",
"perc_variazione_annuale": "26.7",
"dinamicita_mercato_residenziale": "media"
},
"2019": {"num_abitazioni_zona": "9251",
"numero_abitazioni_vendute": "173",
"perc_variazione_annuale": "4.217",
"dinamicita_mercato_residenziale": "media"
},
"2020": {"num_abitazioni_zona": "9251",
"numero_abitazioni_vendute": "0",
"perc_variazione_annuale": "#N/D",
"dinamicita_mercato_residenziale": "#N/D"
}
},
"timestamp": 1639146256,
"owner": "[email protected]",
"univoco": "20211210152415_61b3630f90877_20_1898"
},
"message": "default quote for testing",
"success": true,
"error": null
}

Demographics data

Method that allows you to see the demographics of a given area related to the real estate market

Authorizations:

bearerAuth

Request Body schema: application/json

univoco

required

string

Default: "<string>"

code of the property sought

Responses

Response Schema: application/json

	object (ResponseDemografico)
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{"univoco": "20201014115409_5f86cac1985da_20_1898"
}

Response samples

200
402
428

Content type

application/json

{"data": {"pop": {"media_componenti_famiglia": "2.13",
"dimensione_nuclei_familiari": "medi",
"livello_anzianita": "medio alto",
"livello_istruzione": "superiore alla media",
"livello_disoccupazione": "media"
},
"stock": {"abitanti_per_edificio": "8.92",
"abitazioni_per_edificio": "4.32",
"prc_edifici_produttivi_commerciali": "16.000",
"prc_edifici_residenziali": "82.000",
"mq_abitazione_media": "96.94",
"prc_abitazioni_di_proprieta": "70.000",
"prc_abitazioni_vuote_o_2_case": "10.000"
},
"geo": {"id": "43131",
"loc2011": "5503210016",
"id_provincia": "96",
"cod_cat": "L117",
"tipo_localita": "centro principale",
"nome_localita": "Terni",
"altitudine": "130"
},
"rischio_sismico": "inferiore alla media",
"capoluogo": [{"media_num_abitazioni_zona": "9205.0000",
"media_numero_abitazioni_vendute": "128.4000",
"dinamicita_mercato_residenziale": "media"
}
],
"mappa": "https://test.valutometro.altravia.com/map/20201014115409_5f86cac1985da_20_1898",
"timestamp": 1639147322,
"owner": "[email protected]",
"id": "61b3673a0749bf6b83210238",
"univoco": "20201014115409_5f86cac1985da_20_1898"
},
"message": "default quote for testing",
"success": true,
"error": null
}

Permanence on the market

Method that allows you to see the time spent on the market for real estate properties in the area

Authorizations:

bearerAuth

Request Body schema: application/json

univoco

required

string

Default: "<string>"

code of the property sought

Responses

Response Schema: application/json

	object (ResponseTempistica)
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{"univoco": "20211210152415_61b3630f90877_20_1898"
}

Response samples

200
402
428

Content type

application/json

{"data": {"0": [{"label": "0 50 Mq",
"media_giorni": 210
},
{"label": "50 85 Mq",
"media_giorni": 159
},
{"label": "85 115 Mq",
"media_giorni": 177
},
{"label": "115 145 Mq",
"media_giorni": 184
},
{"label": "Oltre 145 Mq",
"media_giorni": 192
}
],
"timestamp": 1639148062,
"owner": "[email protected]",
"id": "61b36a1e7c658f6dcc18eaeb",
"univoco": "20211210152415_61b3630f90877_20_1898"
},
"message": "default quote for testing",
"success": true,
"error": null
}

Valutazioni

Property search

Method that allows you to see both the quotation and the exact position of the searched property and the related parameters necessary to make an evaluation

Authorizations:

bearerAuth

Request Body schema: application/json

indirizzo required	string Default: "<string>" real estate address
tipo_immobile required	string Default: "<string>" 20
tipo_contratto required	string Default: "<string>" sale

Responses

Response Schema: application/json

	object (ResponseIndirizzo)
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{"indirizzo": "via del rivo 10 Terni",
"tipo_immobile": "20",
"tipo_contratto": "sale"
}

Response samples

200
402
404
406
428

Content type

application/json

{"data": {"id": "5f842846568fa1575d602c1d",
"nome": "Borgo Rivo, Campitello, Gabelletta, Citta Verde, Ponte Le Cave",
"id_citta": "7432",
"citta": "Terni",
"cod_cat": "L117",
"provincia": "TR",
"id_provincia": "96",
"id_regione": "18",
"regione": "Umbria",
"fascia": "semicentrale",
"address": "via del rivo 10 Terni",
"formatted": "Via del Rivo, 10, 05100 Terni TR, Italia",
"loc2011": "5503210016",
"coordinate": {"lat": 42.57712,
"lng": 12.62637
},
"immobile": {"type": "Abitazioni in stabili civili",
"label": "Valori di Vendita Abitazioni in stabili civili al Mq",
"id": 20
},
"quotazione": {"min": 783,
"max": 1145,
"med": 964,
"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&ugrave; facile della media di zona",
"4|1.15": "Pi&ugrave; difficoltosa della media di zona",
"5|1.35": "Molto pi&ugrave; 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": {"2": "Completamente da ristrutturare",
"3": "Da ristrutturare",
"4": "Parzialmente da ristrutturare",
"5": "Buono stato",
"6": "Ottimo stato",
"7": "Parzialmente ristrutturato",
"8": "Ristrutturato",
"9": "Nuova costruzione",
"10": "Discreto",
"11": "Fatiscente"
},
"required": false
},
"tipologia_edificio": {"name": "tipologia_edificio",
"label": "Tipologia Edificio",
"type": "select",
"options": {"48|1.00": "Civile &#40;medio di zona&#41;",
"47|0.94": "Civile-Economico",
"49|1.06": "Medio-Signorile",
"50|1.08": "Signorile",
"51|1.16": "Molto signorile",
"52|1.24": "Di pregio",
"56|1.32": "Straordinario"
},
"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": {"2": "Da ristrutturare",
"3": "Discrete condizioni",
"4": "Buono stato",
"5": "Ottimo stato",
"6": "Ristrutturato",
"7": "Nuova costruzione",
"8": "Parzialmente ristrutturato",
"9": "Da ripulire",
"10": "Nuova costruzione (mai abitato)"
},
"required": false
},
"univoco": {"name": "univoco",
"type": "hidden",
"value": "20201012115622_5f84284653bbc_20_1898",
"required": true
}
},
"timestamp": 1602496582,
"owner": "[email protected]"
},
"message": "",
"success": true,
"error": null
}

Property valuation

Method that allows you to evaluate a unique property searched through the POST/indirizzo method

Authorizations:

bearerAuth

Request Body schema: application/json

In addition to the 'univoco' parameter, the other parameters required vary according to the search made using the POST/indirizzo method. In fact, in the response to the call a form is provided with all the parameters and values accepted and their mandatory nature

univoco

required

string

Default: "<string>"

code of the property sought

Responses

Response Schema: application/json

	object (ResponseValutazione)
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{"univoco": "20201012115622_5f84284653bbc_20_1898",
"mq_coperti": "100",
"piano": 5,
"accessibilita_box": "6|1.05"
}

Response samples

200
402
404
406
428

Content type

application/json

{"data": {"zona": "Borgo Rivo, Campitello, Gabelletta, Citta Verde, Ponte Le Cave",
"citta": "Terni",
"address": "Via del Rivo, 10, 05100 Terni TR, Italia",
"coordinate": {"lng": "12.62637",
"lat": "42.57712"
},
"contract": "sale",
"type": {"id": "20",
"label": "Abitazioni in stabili civili"
},
"mq_commerciali": 100,
"valore": {"basso": 54494,
"mediobasso": 60798,
"medio": 67101,
"medioalto": 73404,
"alto": 79708
},
"timestamp": 1602498502,
"owner": "[email protected]",
"id": "5f842fc6568fa1433a3389c3"
},
"message": "",
"success": true,
"error": null
}