Run with Postman
Documentation Powered by Redocly

Compravendite Immobiliari (1.0.0)

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

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

First time here? Generate a new access token

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 località specifica, 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)
    Default: "<string>"
    Enum: "residenziale" "non_residenziale" "pertinenziale"
    categorie_catastali
    Array of strings <= 2 items

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

    search_radius
    integer
    Default: "<integer>"

    Raggio di ricerca dal "punto di partenza

    max_surface
    integer
    Default: "<integer>"
    min_surface
    integer
    Default: "<integer>"
    max_price
    integer
    Default: "<integer>"

    Valore massimo in euro

    min_price
    integer
    Default: 0
    object
    object

    Responses

    Response Schema: application/json
    Array of objects (SearchResponse) [ items ]
    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
    Full response
    Full response
    Dry run
    {
    • "data": {
      },
    • "success": true,
    • "message": ""
    }