Real Estate Valuer

  1. Home
  2. API Library
  3. Real Estate Valuer
The API was replaced by the new endpoints available in Real Estate

Get valuations, listings and demographic and market information on all properties in Italy via API

Deprecated starting from 2024-12-31

All the knowledge you need

Here you can find some advice to consider to approach this API. If you prefer, we provide code samples, OAS3 documentation, the ability to try the API live via the Swagger UI or import the entire collection into Postman. We also offer a Sandbox environment where you can experiment with all kinds of requests completely free of charge.

Useful tips to start with Real Estate Valuer

Get the token in the appropriate section before you start.

Use the the online tool or generate it via API. Set the expire date, a usefull name and now add a bunch of scopes to limit the possible actions your token can do.
Read more on oauth API Manage my tokens
API docs by Redocly

Valutometro (1.0.0)

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

Service web qui permet, à partir d'une recherche d'adresses, d'extraire des offres immobilières, des évaluations et des tendances.

Première fois ici ? Génération d'un nouveau jeton d'accès

Contratti - Immobili

Méthodes d'affichage de tous les types de contrats et de propriétés disponibles pour la recherche

Liste des types de propriétés

Cette méthode affiche la liste de tous les types de propriétés

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
}

Propriété spécifique

Cette méthode indique le type spécifique de la propriété

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 20

Type de bien immobilier

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
}

Liste des types de contrats

Cette méthode affiche la liste de tous les types de contrats

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
}

Contrat spécifique

Cette méthode indique la nature spécifique du contrat

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: rent

Type de contrat

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

Méthode pour lister un bien immobilier

Offres immobilières

Méthode d'affichage du prix d'un bien immobilier à partir de son adresse

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

Immobilienadresse

tipo_immobile
required
string

20

tipo_contratto
required
string

à vendre

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

Méthodes d'identification des tendances du marché

Développement d'une zone géographique

Une méthode qui fournit des tendances, des données et des indicateurs de marché pour une zone géographique donnée.

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

Immobilienadresse

tipo_immobile
required
string

20

tipo_contratto
required
string

à vendre

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
}

Données démographiques

Une méthode de représentation des données démographiques d'une zone donnée par rapport au marché du logement.

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

Code objet recherché

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
}

Résistance au marché

Méthode permettant de voir depuis combien de temps les biens immobiliers de la région sont sur le marché

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

Code objet recherché

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

Recherche de biens immobiliers

une méthode permettant d'afficher à la fois la liste et l'emplacement exact de l'objet recherché, ainsi que les paramètres pertinents nécessaires à l'évaluation

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

Immobilienadresse

tipo_immobile
required
string

20

tipo_contratto
required
string

à vendre

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
}

Évaluation des biens immobiliers

Méthode d'évaluation d'une propriété unique recherchée par la méthode POST/address

Authorizations:
bearerAuth
Request Body schema: application/json

Outre le paramètre "unique", les autres paramètres requis varient en fonction de la recherche effectuée avec la méthode POST/address. Dans la réponse à l'appel, un formulaire est fourni avec tous les paramètres et valeurs acceptés et leur caractère obligatoire

univoco
required
string

Code objet recherché

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