Alle Daten zur korrekten Schätzung einer Immobilie

Zugriff auf den umfassendsten Datensatz von Immobilienangeboten

Nützliche Tipps für den Einstieg Comparable

Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.

Verwenden Sie das Online-Tool oder generieren Sie es über die API. Legen Sie das Ablaufdatum, einen nützlichen Namen fest und fügen Sie jetzt eine Vielzahl von Scopes hinzu, um die möglichen Aktionen Ihres Tokens zu begrenzen.

Oas file url https://console.openapi.com/oas/de/comparabili.openapi.json
Fork or import with Postman
Production domain comparabili.openapi.it
Sandbox domain test.comparabili.openapi.it
Production Scopes 3
Sandbox Scopes 3
- POST test.comparabili.openapi.it/ricerca
- GET test.comparabili.openapi.it/immobile
- GET test.comparabili.openapi.it/tassonomie

Comparabili (1.0.0)

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

Webdienst für die Suche nach Immobilienanzeigen.

Zum ersten Mal hier? Generierung eines neuen Zugangstokens

Annunci Immobiliari

Ausgehend von einem bestimmten Ort und seinem Umkreis können Sie mit diesem Dienst nach Immobilienangeboten in der Nähe und innerhalb dieses Teils des Gebiets suchen

Liste der Taxonomien

Diese Methode zeigt die Liste aller Taxonomietypen an

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": {
- "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

}

Spezifische Taxonomie

Diese Methode zeigt die spezifische Art der Taxonomie

Authorizations:

bearerAuth

path Parameters

tassonomia

required

string

Example: categoryType

Art der Taxonomie

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": {
- "categoryType": [
  - {
    "categoryType": "Residenziale",
    "categoryTypeID": 1
    },
  - {
    "categoryType": "Commerciale",
    "categoryTypeID": 2
    },
  - {
    "categoryType": "Terreni",
    "categoryTypeID": 3
    },
  - {
    "categoryType": "Altro",
    "categoryTypeID": 4
    }
  ]
},
"success": true,
"message": "",
"error": null

}

Suchmethode

Verfahren zur Suche nach Immobilienanzeigen durch Eingabe von Adresswerten

Authorizations:

bearerAuth

Request Body schema: application/json

latitude required	number <double> [ -90 .. 90 ] Breitengrad des Punktes, an dem Sie die Suche zentrieren wollen; er muss zwischen -90,00 und 90,00 Grad liegen.
longitude required	number <double> [ -180 .. 180 ] Längengrad des Punktes, an dem Sie die Suche zentrieren möchten; er sollte zwischen -180,00 und 180,00 Grad liegen.
contractTypeID required	integer Art der Vertragskennung
limit required	integer [ 1 .. 30 ] Maximale Anzahl von Anzeigen, die zurückgegeben werden sollen. Die maximale Anzahl von Anzeigen beträgt 30
radius required	integer >= 500 Suchradius in Metern mit einem Wert >= 500
maxPrice	integer >= 0 Der Höchstpreis der zu suchenden Anzeigen
minPrice	integer >= 0 Der Mindestpreis der zu durchsuchenden Anzeigen
maxMq	integer >= 0 Die maximale Fläche des zu durchsuchenden Grundstücks
minMq	integer >= 0 Die Mindestfläche des zu durchsuchenden Grundstücks
minDate	string Mindesttermin für die Aufnahme von Anzeigen
maxDate	string Maximaler Termin für die Schaltung von Anzeigen
categoryTypeID	integer Kategorie Typ id
	integer or Array of integers Eigenschaftstyp id
	integer or Array of integers Qualität der Ausführung id
	integer or Array of integers Identifizierung der Objektqualität
	integer or Array of integers Identifizierung des Beschäftigungsstatus
	integer or Array of integers Id Wartungsstatus
	integer or Array of integers Id der Heizungsanlage
	integer or Array of integers Identifizierung der Exposition
clientTypeID	integer Kundentyp id
	integer or Array of integers Gürtel der Zentralität id
	integer or Array of integers Veröffentlichungsstatus id

Responses

Response Schema: application/json

	object (ResponseRicerca)
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{

"latitude": 42,
"longitude": 12,
"contractTypeID": 1,
"limit": 15,
"radius": 1500,
"categoryTypeID": 1

}

Response samples

Content type

application/json

{

"data": {
- "count": 4,
- "map": "https://dev.comparabili.openapi.it/map/40599uhkyemn0d6",
- "ads": [
  - {
    "id": "6e092a9b-969e-40d9-842a-d1baa1191fc5",
    "address": "Via Aurelia",
    "propertyType": "Appartamento"
    },
  - {
    "id": "bd9885ee-def4-4b56-92cb-6e12bebd3b41",
    "address": "Via Aurelia",
    "propertyType": "Appartamento"
    },
  - {
    "id": "a1e63e37-b13a-4558-834c-63f3c0c5f2ab",
    "address": "Via Della Repubblica",
    "propertyType": "Appartamento"
    },
  - {
    "id": "dc8d9d57-a9f3-4868-8ead-ca72309fdfb0",
    "address": "Via San Bernardino",
    "propertyType": "Appartamento"
    }
  ]
},
"message": "",
"success": true,
"error": null

}

Details zur Anzeige

Methode zur Beschaffung aller Details einer Immobilienanzeige

Authorizations:

bearerAuth

path Parameters

required

string

Example: 69281343-4e8f-4b77-910c-b81ca1fe4898

Anzeigen-ID

Responses

Response Schema: application/json

	Array of objects (ResponseImmobile)
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/immobile/%7Bid%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": {
- "cadastralData": [
  - {
    "cadastralClass": null,
    "cadastralCompartments": null,
    "cadastralIncome": null,
    "cadastralMapSheetNumber": null,
    "cadastralMunicipality": null,
    "cadastralParceSubParcelNumber": null,
    "cadastralParcelNumber": null,
    "cadastralPmCode": null,
    "cadastralPropertyType": null,
    "cadastralRegistry": null,
    "cadastralSectionCode": null
    }
  ],
- "collectionDate": "18/01/2022",
- "comparableType": "Offerta",
- "extra": {
  - "condoFees": 0,
  - "lastCommercialUse": null,
  - "showCases": null,
  - "showCasesSize": null,
  - "title": "TERNI VIA TRE VENEZIE"
  },
- "features": {
  - "box": null,
  - "brightness": null,
  - "centralityBelt": "Semicentrale",
  - "constructionYear": 1950,
  - "contructionYearNote": null,
  - "description": "Wohnung mit eigenem Eingang und angrenzendem Garten von ca. 30m². Das Anwesen besteht aus Wohnzimmer mit Kochnische, Schlafzimmer mit Doppelbett, Arbeitszimmer, Bad. Zum Anwesen gehört ein kleines Grundstück von ca. 80m² mit Garage, die nicht direkt mit dem Haus verbunden ist, sondern hinter dem Anwesen verbleibt. Ausgezeichnete Lösung auch für Investitionen.",
  - "elevator": null,
  - "energyClass": "G",
  - "exposure": null,
  - "facilityList": [
    "Caminetto",
    "Esposizione interna",
    "Esposizione esterna"
    ],
  - "fitnessForPurpose": null,
  - "gardenType": null,
  - "heatingSystem": "Autonomo",
  - "maintenanceStatus": "Buono / Abitabile",
  - "numberOfBalconies": null,
  - "numberOfBathrooms": "1",
  - "numberOfBuildingFloor": "1",
  - "numberOfGarages": 1,
  - "occupancyStatus": "Libero",
  - "propertyQuality": "Media",
  - "qualityOfFinishes": null,
  - "unitFloor": "piano terra",
  - "viewQuality": null
  },
- "grossSquareFootage": 81,
- "lastUpdateDate": "18/01/2022",
- "location": {
  - "address": "Via Tre Venezie",
  - "district": null,
  - "latitude": 42.5745,
  - "longitude": 12.671,
  - "marketZone": "Borgo Bovio",
  - "municipality": "Terni",
  - "province": "Terni",
  - "region": "Umbria",
  - "streetNumber": "127",
  - "zipCode": "05100"
  },
- "marketData": {
  - "askingReductionRate": null,
  - "askingReductionSteps": null,
  - "municipalityVisibilityIndex": 5,
  - "quarterMacroareaTrend": null,
  - "quarterMicroareaTrend": null,
  - "quarterMunicipalityTrend": null,
  - "semesterMacroareaTrend": null,
  - "semesterMicroareaTrend": null,
  - "semesterMunicipalityTrend": null,
  - "timeOnTheMarket": null,
  - "zonalVisibilityIndex": 3
  },
- "propertyType": "Appartamento",
- "pubblicationStatus": "Nuovo",
- "realEstateRegisters": {
  - "deedDate": null,
  - "deedType": null,
  - "folder": null,
  - "generalNumber": null,
  - "inventory": null,
  - "notary": null,
  - "particularNumber": null,
  - "pdfFileUrl": null,
  - "propertyRegistryId": null
  },
- "rooms": "3",
- "unitGrossSquareFootage": [
  - {
    "floor": "piano terra",
    "main_surface": true,
    "surface_percentage": 100,
    "total_surface": 61,
    "type": "Abitazione"
    },
  - {
    "floor": "piano terra",
    "main_surface": true,
    "surface_percentage": 60,
    "total_surface": 15,
    "type": "Garage - box"
    },
  - {
    "floor": "piano terra",
    "main_surface": true,
    "surface_percentage": 10,
    "total_surface": 30,
    "type": "Giardino"
    },
  - {
    "floor": "piano terra",
    "main_surface": true,
    "surface_percentage": 10,
    "total_surface": 80,
    "type": "Terreno"
    }
  ],
- "value": {
  - "askingPrice": 47000,
  - "askingPricePsm": 580,
  - "discount": null,
  - "price": null,
  - "pricePsm": null,
  - "value": null,
  - "valuePsm": null
  },
- "energyClass": null,
- "id": "69281343-4e8f-4b77-910c-b81ca1fe4898"
},
"success": true,
"message": "",
"error": null

}

Web Service Revision: 2.0.0