Run with Postman
Documentation Powered by Redocly

Comparabili (1.0.0)

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

Web service for searching for real estate advertisements.

First time here? Generate a new access token

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:
bearerAuth

    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:
    bearerAuth
      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:
      bearerAuth
        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