Run with Postman

Comparabili (1.0.0)

Web service for searching for real estate advertisements.

Annunci Immobiliari

Starting from a specific position and relative radius of delimitation, this service allows you to search for real estate ads near and included in that portion of the area

List of taxonomies

This method shows you the list of all taxonomies types

Authorizations:

Responses

Response Schema: application/json
object (Tassonomie)
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

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

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

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

Specific taxonomie

This method shows you the specific type of taxonomie

Authorizations:
path Parameters
tassonomia
required
string
Default: "<string>"
Example: categoryType

Taxonomie type

Responses

Response Schema: application/json
object
success
boolean
message
string
error
integer

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://comparabili.openapi.it/tassonomie/%7Btassonomia%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

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

Method for research

Method that allows you to search for real estate ads through input values address

Authorizations:
Request Body schema: application/json
latitude
required
number <double> [ -90 .. 90 ]
Default: "<double>"

Latitude of the point where you want to center the search; should be between -90.00 and 90.00 degrees

longitude
required
number <double> [ -180 .. 180 ]
Default: "<double>"

Longitude of the point where you want to center the search; should be between -180.00 and 180.00 degrees

contractTypeID
required
integer
Default: "<integer>"

Contract type id

limit
required
integer [ 1 .. 30 ]
Default: "<integer>"

Maximum number of ads to return. The maximum limit of the ws is 30

radius
required
integer >= 500
Default: "<integer>"

Research radius expressed in meters with value >= 500

maxPrice
integer >= 0
Default: "<integer>"

The maximum price of the ads to search

minPrice
integer >= 0
Default: "<integer>"

The minimum price of the ads to search

maxMq
integer >= 0
Default: "<integer>"

The maximum area of properties to search for

minMq
integer >= 0
Default: "<integer>"

The minimum area of properties to search for

minDate
string
Default: "<string>"

Minimum date to include ads

maxDate
string
Default: "<string>"

Maximum date to include ads

categoryTypeID
integer
Default: "<integer>"

Category type id

integer or Array of integers

Property type id

integer or Array of integers

Quality of finishes id

integer or Array of integers

Property quality id

integer or Array of integers

Occupancy status id

integer or Array of integers

Maintenance status id

integer or Array of integers

Heating system id

integer or Array of integers

Exposure id

clientTypeID
integer
Default: "<integer>"

Client type id

integer or Array of integers

Centrality belt id

integer or Array of integers

Pubblication status id

Responses