Web service for searching for real estate advertisements.
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
This method shows you the list of all taxonomies types
object (Tassonomie) | |
success | boolean |
message | string |
error | integer |
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);
{- "data": {
- "categoryType": [
- {
- "categoryType": "Residenziale",
- "categoryTypeID": 1
}, - {
- "categoryType": "Commerciale",
- "categoryTypeID": 2
}, - {
- "categoryType": "Terreni",
- "categoryTypeID": 3
}, - {
- "categoryType": "Altro",
- "categoryTypeID": 4
}
], - "centralityBelt": [
- {
- "centralityBelt": "Centrale",
- "centralityBeltID": 1
}, - {
- "centralityBelt": "Semicentrale",
- "centralityBeltID": 2
}, - {
- "centralityBelt": "Periferica",
- "centralityBeltID": 3
}, - {
- "centralityBelt": "Suburbana",
- "centralityBeltID": 4
}, - {
- "centralityBelt": "Extra-urbana",
- "centralityBeltID": 5
}
], - "clientType": [
- {
- "clientType": "Privato",
- "clientTypeID": 1
}, - {
- "clientType": "Professionista",
- "clientTypeID": 2
}
], - "contractType": [
- {
- "contractType": "Vendita",
- "contractTypeID": 1
}, - {
- "contractType": "Affitto",
- "contractTypeID": 2
}
], - "exposure": [
- {
- "exposure": "Nord",
- "exposureID": 1
}, - {
- "exposure": "Sud",
- "exposureID": 2
}, - {
- "exposure": "Ovest",
- "exposureID": 3
}, - {
- "exposure": "Est",
- "exposureID": 4
}, - {
- "exposure": "Interna",
- "exposureID": 5
}
], - "heatingSystem": [
- {
- "heatingSystem": "Autonomo",
- "heatingSystemID": 1
}, - {
- "heatingSystem": "Condominiale",
- "heatingSystemID": 2
}, - {
- "heatingSystem": "Assente",
- "heatingSystemID": 3
}, - {
- "heatingSystem": "Pompe di calore",
- "heatingSystemID": 4
}
], - "maintenanceStatus": [
- {
- "maintenanceStatus": "Nuovo / In costruzione",
- "maintenanceStatusID": 1
}, - {
- "maintenanceStatus": "Ottimo / Ristrutturato",
- "maintenanceStatusID": 2
}, - {
- "maintenanceStatus": "Buono / Abitabile",
- "maintenanceStatusID": 3
}, - {
- "maintenanceStatus": "Da ristrutturare",
- "maintenanceStatusID": 4
}
], - "occupancyStatus": [
- {
- "occupancyStatus": "Libero",
- "occupancyStatusID": 1
}, - {
- "occupancyStatus": "Occupato",
- "occupancyStatusID": 2
}, - {
- "occupancyStatus": "Affittato",
- "occupancyStatusID": 3
}
], - "propertyQuality": [
- {
- "propertyQuality": "Economica",
- "propertyQualityID": 1
}, - {
- "propertyQuality": "Media",
- "propertyQualityID": 2
}, - {
- "propertyQuality": "Signorile",
- "propertyQualityID": 3
}, - {
- "propertyQuality": "Lusso",
- "propertyQualityID": 4
}
], - "propertyType": [
- {
- "propertyType": "Appartamento",
- "propertyTypeID": 1
}, - {
- "propertyType": "Abitazione economica",
- "propertyTypeID": 2
}, - {
- "propertyType": "Villa",
- "propertyTypeID": 5
}, - {
- "propertyType": "Loft/Open space",
- "propertyTypeID": 6
}, - {
- "propertyType": "Mansarda",
- "propertyTypeID": 8
}, - {
- "propertyType": "Rustico/Casale",
- "propertyTypeID": 12
}, - {
- "propertyType": "Attico",
- "propertyTypeID": 13
}, - {
- "propertyType": "Casa indipendente",
- "propertyTypeID": 43
}, - {
- "propertyType": "Villetta a schiera",
- "propertyTypeID": 15
}, - {
- "propertyType": "Appartamento di lusso",
- "propertyTypeID": 16
}, - {
- "propertyType": "Agriturismo",
- "propertyTypeID": 23
}, - {
- "propertyType": "Bed and Breakfast",
- "propertyTypeID": 25
}, - {
- "propertyType": "Hotel",
- "propertyTypeID": 26
}, - {
- "propertyType": "Azienda agricola",
- "propertyTypeID": 27
}, - {
- "propertyType": "Magazzino",
- "propertyTypeID": 31
}, - {
- "propertyType": "Negozio",
- "propertyTypeID": 32
}, - {
- "propertyType": "Capannone",
- "propertyTypeID": 34
}, - {
- "propertyType": "Laboratorio",
- "propertyTypeID": 36
}, - {
- "propertyType": "Ufficio",
- "propertyTypeID": 37
}, - {
- "propertyType": "Stabile/Palazzo",
- "propertyTypeID": 11
}, - {
- "propertyType": "Box",
- "propertyTypeID": 40
}, - {
- "propertyType": "Posto auto",
- "propertyTypeID": 42
}, - {
- "propertyType": "Terreno agricolo",
- "propertyTypeID": 50
}, - {
- "propertyType": "Terreno edificabile",
- "propertyTypeID": 51
}
], - "pubblicationStatus": [
- {
- "pubblicationStatus": "Nuovo",
- "pubblicationStatusID": 1
}, - {
- "pubblicationStatus": "Pubblicato",
- "pubblicationStatusID": 2
}, - {
- "pubblicationStatus": "Rimosso",
- "pubblicationStatusID": 3
}, - {
- "pubblicationStatus": "Inattivo",
- "pubblicationStatusID": 4
}
], - "qualityOfFinishes": [
- {
- "qualityOfFinishes": "Economica",
- "qualityOfFinishesID": 1
}, - {
- "qualityOfFinishes": "Media",
- "qualityOfFinishesID": 2
}, - {
- "qualityOfFinishes": "Lusso",
- "qualityOfFinishesID": 3
}, - {
- "qualityOfFinishes": "Signorile",
- "qualityOfFinishesID": 4
}
]
}, - "success": true,
- "message": "",
- "error": null
}
This method shows you the specific type of taxonomie
tassonomia required | string Default: "<string>" Example: categoryType Taxonomie type |
object | |
success | boolean |
message | string |
error | integer |
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);
{- "data": {
- "categoryType": [
- {
- "categoryType": "Residenziale",
- "categoryTypeID": 1
}, - {
- "categoryType": "Commerciale",
- "categoryTypeID": 2
}, - {
- "categoryType": "Terreni",
- "categoryTypeID": 3
}, - {
- "categoryType": "Altro",
- "categoryTypeID": 4
}
]
}, - "success": true,
- "message": "",
- "error": null
}
Method that allows you to search for real estate ads through input values address
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 |