Valutometro Immobiliare

  1. Home
  2. Libreria API
  3. Valutometro Immobiliare
L'API è stata sostituita dai nuovi endpoint disponibili in Real Estate

Ottieni valutazioni, quotazioni ed informazioni demografiche e di mercato su tutti gli immobili tramite API

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.

Utili consigli per iniziare con Valutometro Immobiliare

Prendi il token nell'apposita sezione prima di cominciare.

Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.
Approfondisci Oauth Gestisci i tokens
API docs by Redocly

Valutometro (1.0.0)

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

Servizio web che, partendo da una ricerca per indirizzo, permette di estrarre quotazioni immobiliari, valutazioni e tendenze.

Prima volta qui? Generare un nuovo token di accesso

Contratti - Immobili

Metodi per visualizzare tutti i tipi di contratti e proprietà disponibili per la ricerca

Elenco dei tipi di proprietà

Questo metodo mostra l'elenco di tutti i tipi di proprietà

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects (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");

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

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Proprietà specifica

Questo metodo mostra il tipo specifico di proprietà

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 20

Tipo di proprietà

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

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Elenco dei tipi di contratto

Questo metodo mostra l'elenco di tutti i tipi di contratto

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects (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");

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

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Contratto specifico

Questo metodo mostra il tipo specifico di contratto

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: rent

Tipo di contratto

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

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Quotazioni

Metodo per la quotazione di una proprietà

Quotazioni di un immobile

Metodo che consente di visualizzare il prezzo di un immobile a partire dall'indirizzo

Authorizations:
bearerAuth
Request Body schema: application/json
indirizzo
required
string

indirizzo immobiliare

tipo_immobile
required
string

20

tipo_contratto
required
string

vendita

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

Content type
application/json
{
  • "data": {
    },
  • "message": "",
  • "success": true,
  • "error": null
}

Tendenze

Metodi per conoscere le tendenze del mercato

Tendenza di un'area geografica

Metodo che restituisce le tendenze, i dati e gli indicatori di mercato di una determinata area geografica.

Authorizations:
bearerAuth
Request Body schema: application/json
indirizzo
required
string

indirizzo immobiliare

tipo_immobile
required
string

20

tipo_contratto
required
string

vendita

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

Content type
application/json
{
  • "data": {
    },
  • "message": "default quote for testing",
  • "success": true,
  • "error": null
}

Dati demografici

Metodo che consente di visualizzare i dati demografici di una determinata area in relazione al mercato immobiliare.

Authorizations:
bearerAuth
Request Body schema: application/json
univoco
required
string

codice dell'immobile ricercato

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

Content type
application/json
{
  • "data": {
    },
  • "message": "default quote for testing",
  • "success": true,
  • "error": null
}

Permanenza sul mercato

Metodo che permette di vedere il tempo di permanenza sul mercato delle proprietà immobiliari della zona

Authorizations:
bearerAuth
Request Body schema: application/json
univoco
required
string

codice dell'immobile ricercato

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

Content type
application/json
{
  • "data": {
    },
  • "message": "default quote for testing",
  • "success": true,
  • "error": null
}

Valutazioni

Ricerca di proprietà

Metodo che consente di visualizzare sia la quotazione che la posizione esatta della proprietà ricercata e i relativi parametri necessari per effettuare una valutazione

Authorizations:
bearerAuth
Request Body schema: application/json
indirizzo
required
string

indirizzo immobiliare

tipo_immobile
required
string

20

tipo_contratto
required
string

vendita

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

Content type
application/json
{
  • "data": {
    },
  • "message": "",
  • "success": true,
  • "error": null
}

Valutazione della proprietà

Metodo che consente di valutare una proprietà univoca cercata attraverso il metodo POST/indirizzo

Authorizations:
bearerAuth
Request Body schema: application/json

Oltre al parametro "univoco", gli altri parametri richiesti variano a seconda della ricerca effettuata con il metodo POST/indirizzo. Infatti, nella risposta alla chiamata viene fornito un modulo con tutti i parametri e i valori accettati e la loro obbligatorietà

univoco
required
string

codice dell'immobile ricercato

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

Content type
application/json
{
  • "data": {
    },
  • "message": "",
  • "success": true,
  • "error": null
}
Web Service Revision: 2.0.0