Italian Real Estate Sales

  1. Home
  2. API Library
  3. Italian Real Estate Sales
The API was replaced by the new endpoints available in Real Estate

Check the actual value of real estate with the actual buying and selling in a given area

Deprecated starting from 2024-12-31

All the knowledge you need

Here you can find some advice to consider to approach this API. If you prefer, we provide code samples, OAS3 documentation, the ability to try the API live via the Swagger UI or import the entire collection into Postman. We also offer a Sandbox environment where you can experiment with all kinds of requests completely free of charge.

Useful tips to start with Italian Real Estate Sales

Get the token in the appropriate section before you start.

Use the the online tool or generate it via API. Set the expire date, a usefull name and now add a bunch of scopes to limit the possible actions your token can do.
Read more on oauth API Manage my tokens
API docs 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)
Enum: "residenziale" "non_residenziale" "pertinenziale"
categorie_catastali
Array of strings

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

search_radius
integer

Search radius from the 'starting point'

max_surface
integer
min_surface
integer
max_price
integer

Maximum worth 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": ""
}
Web Service Revision: 2.0.0