Run with Postman

Compravendite Immobiliari

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

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://test.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:
Request Body schema: application/json
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
{
  • "starting_point": {
    },
  • "tipologia": "residenziale",
  • "search_radius": 15000,
  • "max_surface": 100000000,
  • "max_price": 900000,
  • "from_date": {
    },
  • "to_date": {
    }
}

Response samples

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