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

This service allows you to seek information about deeds of sale of various real estates in Italy

First time here? Generate a new access token

Search

Get a list all all the available categories

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
}

Search for sales around a given Geopoint

With this endpoint you can search for deeds of sales that match your query. The results will always be returned in order of distance from the starting_point that you provided and will be from the most recent to the oldest that match the query parameters.

Please note that distances and areas are always reported in meters unless specified differently.
To get all the available tipologie and categorie _catastali please use the /categories endpoint.

If you need to find out the coordinates for a specific locaiton, please take a look at the Geocoding API

Test environment
The test environment is loaded with a smaller dataset which allows you to make test requests while developing the service. All the deeds of sales in the test environment are placed around 40.85571, 14.23040

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

    Allows you to estimate the cost of the request by returning the amount of documents found. Please see the Dry run example response below. The result array will be empty.

    object
    limit
    integer
    Default: 50

    The amount of results that can be returned on a single API call. You will be billed only on the number of the returned results

    tipologia
    string (CategoriaImmobili)
    Default: "<string>"
    Enum: "residenziale" "non_residenziale" "pertinenziale"
    categorie_catastali
    Array of strings <= 2 items

    If null is given, it will match all the available categories.

    search_radius
    integer
    Default: "<integer>"

    Search radius from the 'starting point'

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

    Maximum worth 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": ""
    }