Comparabili

  1. Home
  2. Libreria API
  3. Comparabili
Tutti i dati per effettuare la stima corretta di un immobile

Accedi al più completo dataset di annunci immobiliari

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 Comparabili

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

Comparabili (1.0.0)

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

Servizio web per la ricerca di annunci immobiliari.

Prima volta qui? Generare un nuovo token di accesso

Annunci Immobiliari

Partendo da una specifica posizione e relativo raggio di delimitazione, questo servizio consente di ricercare gli annunci immobiliari vicini e compresi in quella porzione di area

Elenco delle tassonomie

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

Authorizations:
bearerAuth

Responses

Response Schema: application/json
object (Tassonomie)
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://comparabili.openapi.it/tassonomie");

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
}

Tassonomia specifica

Questo metodo mostra il tipo specifico di tassonomia

Authorizations:
bearerAuth
path Parameters
tassonomia
required
string
Example: categoryType

Tipo di tassonomia

Responses

Response Schema: application/json
object
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://comparabili.openapi.it/tassonomie/%7Btassonomia%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
}

Metodo di ricerca

Metodo che consente di ricercare gli annunci immobiliari attraverso l'inserimento di valori di indirizzo

Authorizations:
bearerAuth
Request Body schema: application/json
latitude
required
number <double> [ -90 .. 90 ]

Latitudine del punto in cui si vuole centrare la ricerca; deve essere compresa tra -90,00 e 90,00 gradi.

longitude
required
number <double> [ -180 .. 180 ]

Longitudine del punto in cui si desidera centrare la ricerca; dovrebbe essere compresa tra -180,00 e 180,00 gradi.

contractTypeID
required
integer

Tipo di contratto id

limit
required
integer [ 1 .. 30 ]

Numero massimo di annunci da restituire. Il limite massimo del ws è 30

radius
required
integer >= 500

Raggio di ricerca espresso in metri con valore >= 500

maxPrice
integer >= 0

Il prezzo massimo degli annunci da ricercare

minPrice
integer >= 0

Il prezzo minimo degli annunci da ricercare

maxMq
integer >= 0

L'area massima di proprietà da ricercare

minMq
integer >= 0

L'area minima di proprietà da ricercare

minDate
string

Data minima per includere gli annunci

maxDate
string

Data massima di inserimento degli annunci

categoryTypeID
integer

Tipo di categoria id

integer or Array of integers

Tipo di proprietà id

integer or Array of integers

Qualità delle finiture id

integer or Array of integers

Identificazione della qualità della proprietà

integer or Array of integers

Identificazione dello stato di occupazione

integer or Array of integers

Id stato di manutenzione

integer or Array of integers

Id del sistema di riscaldamento

integer or Array of integers

Identificazione dell'esposizione

clientTypeID
integer

Tipo di cliente id

integer or Array of integers

Cintura di centralità id

integer or Array of integers

Stato di pubblicazione id

Responses

Response Schema: application/json
object (ResponseRicerca)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "latitude": 42,
  • "longitude": 12,
  • "contractTypeID": 1,
  • "limit": 15,
  • "radius": 1500,
  • "categoryTypeID": 1
}

Response samples

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

Dettagli annuncio

Metodo che consente di ottenere tutti i dettagli di un annuncio immobiliare

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 69281343-4e8f-4b77-910c-b81ca1fe4898

ID annuncio

Responses

Response Schema: application/json
Array of objects (ResponseImmobile)
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://comparabili.openapi.it/immobile/%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
}
Web Service Revision: 2.0.0