Compravendite Immobiliari

L'API è stata sostituita dai nuovi endpoint disponibili in Real Estate

Verifica l'effettivo valore di immobili con il reale compravenduto in una determinata area

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 Compravendite Immobiliari

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.

Compravendite Immobiliari (1.0.0)

Questo servizio permette di ricercare informazioni sugli atti di vendita di vari immobili in Italia

Search

Ottenere un elenco di tutte le categorie disponibili

Responses

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://compravenditeimmobiliari.openapi.it/categories");

CURLcode ret = curl_easy_perform(hnd);

Response samples

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

Ricerca di vendite intorno a un determinato Geopoint

Con questo endpoint è possibile cercare atti di vendita che corrispondono alla propria query. I risultati verranno sempre restituiti in ordine di distanza dal punto_di_inizio fornito e saranno dal più recente al più vecchio che corrisponde ai parametri della query.

Si prega di notare che le distanze e le aree sono sempre riportate in metri a meno che non sia specificato diversamente.
Per ottenere tutte le tipologie e le categorie _catastali disponibili si prega di utilizzare l'endpoint /categorie.

Se avete bisogno di trovare le coordinate per una specifica località, date un'occhiata alla Geocoding API

Ambiente di prova
L'ambiente di prova è caricato con un set di dati più piccolo che consente di effettuare richieste di prova durante lo sviluppo del servizio. Tutti gli atti di vendita nell'ambiente di test sono collocati intorno a 40.85571, 14.23040

Authorizations:
bearerAuth
Request Body schema: application/json
dry_run
boolean
Default: false

Permette di stimare il costo della richiesta restituendo la quantità di documenti trovati. Si veda l'esempio di risposta di Corsa a vuoto' riportato di seguito. L'array risultato` sarà vuoto.

object
limit
integer
Default: 50

Il numero di risultati che possono essere restituiti con una singola chiamata API. Verrà addebitato solo il numero di risultati restituiti.

tipologia
string (CategoriaImmobili)
Enum: "residenziale" "non_residenziale" "pertinenziale"
categorie_catastali
Array of strings

Se viene dato null, corrisponderà a tutte le categorie disponibili.

search_radius
integer

Raggio di ricerca dal "punto di partenza

max_surface
integer
min_surface
integer
max_price
integer

Valore massimo in euro

min_price
integer
Default: 0
object
object

Responses

Response Schema: application/json
Array of objects (SearchResponse)
success
boolean
message
string

Request samples

Content type
application/json
{
  • "dry_run": false,
  • "starting_point": {
    },
  • "tipologia": "residenziale",
  • "search_radius": 15000,
  • "max_surface": 100000000,
  • "max_price": 900000,
  • "from_date": {
    },
  • "to_date": {
    }
}

Response samples

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