Legacy API · Comparables & Valuation
Search estimated prices (v1)
https://api.casafari.com/api/v1/valuation/comparables-pricesLegacy API (api.casafari.com). A route of the existing API for Casafari clients with a contract, not of the platform. On the platform: POST /v1/comparables/search (its answer carries the estimated prices).
Für die Legacy API unter https://api.casafari.com (Vertragskunden): Senden Sie Authorization: Bearer $CASAFARI_TOKEN; siehe wie Sie ein Token erhalten. Für neue Nutzer: die REST API der Plattform, Plattform-API-Schlüssel.
Description
Returns estimated prices by the given parameters.
Request-Body
Content-Type application/json. Optional. Typ: object.
comparables_countintegererforderlichtarget_pointobjectlocation_boundary.circle.3 Immobilien
coordinatesobject2 Eigenschaften
latitudenumbererforderlichlongitudenumbererforderlichaddressZeichenfolgecadastral_referenceobject4 Immobilien
country_codeZeichenfolgeerforderlichEScadastral_referenceZeichenfolgeerforderlichprovinceZeichenfolgemunicipalityZeichenfolgedistancenumbertarget_point zu vergleichbaren Immobilien. Dieses Feld ist veraltet und wird mit dem nächsten größeren Update entfernt. Bitte verwenden Sie stattdessen das Feld location_boundary.circle.location_boundaryobjecterforderlich2 Eigenschaften
polygonobject[]2 Eigenschaften
latitudenumbererforderlichlongitudenumbererforderlichcircleobject2 Eigenschaften
distancenumbertarget_point zu den Immobilien.target_pointobjecterforderlich3 Immobilien
coordinatesobject2 Eigenschaften
latitudenumbererforderlichlongitudenumbererforderlichaddressZeichenfolgecadastral_referenceobject4 Immobilien
country_codeZeichenfolgeerforderlichEScadastral_referenceZeichenfolgeerforderlichprovinceZeichenfolgemunicipalityZeichenfolgesold_or_rented_afterstring (Datum)kann null seinYYYY-MM-DD) verkauft oder vermietet wurden, werden als mögliche Vergleichsobjekte berücksichtigt. Standardwert: 9 Monate ab heute. Bei Übergabe von null werden nur aktive Immobilien berücksichtigt.operationZeichenfolgeerforderlichsale rentcomparables_typeZeichenfolgecomparables_types field instead.40 zulässige Werte
apartment studio duplex penthouse dachgeschosswohnung etagenwohnung erdgeschosswohnung country_house house palace townhouse villa country_estate chalet bungalow family_house reihenhaus reihenendhaus reihenmittelhaus einfamilienhaus zweifamilienhaus landwirtschaftliche_betriebe retail office industrial warehouse hotel other_commercial restaurant werkstatt plot urban_plot rural_plot room other garage parking apartment_building office_building mix_use_buildingcomparables_typesstring[]erforderlich40 zulässige Werte
apartment studio duplex penthouse dachgeschosswohnung etagenwohnung erdgeschosswohnung country_house house palace townhouse villa country_estate chalet bungalow family_house reihenhaus reihenendhaus reihenmittelhaus einfamilienhaus zweifamilienhaus landwirtschaftliche_betriebe retail office industrial warehouse hotel other_commercial restaurant werkstatt plot urban_plot rural_plot room other garage parking apartment_building office_building mix_use_buildingmin_priceintegermax_priceintegerconditionZeichenfolgeused, ruin, very-good, new, other.used ruin very-good new otherbedroomsintegerrooms verwendet werden).roomsintegerbedrooms verwendet werden).bathroomsintegerconstruction_yearintegertotal_areaintegerhotel, industrial, office, other_commercial, restaurant, retail, warehouse und werkstatt erforderlich, sofern kein target_point.cadastral_reference angegeben ist.plot_areaintegerrural_plot und urban_plot erforderlich, sofern kein target_point.cadastral_reference angegeben ist.floorsstring[]no_floor ground middle topfloor_numberinteger[]orientationZeichenfolgeexterior interiorviewsstring[]water landscape city golf parkdirectionsstring[]north south east westcharacteristicsobject3 Immobilien
must_havestring[]balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuitynice_to_havestring[]balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityexcludestring[]balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityenergy_certificateZeichenfolgeenergy_ratings.Unknown A+ A B C D E F G Henergy_certificatesstring[]energy_ratings.Unknown A+ A B C D E F G Henergy_ratingsstring[]Unknown A+ A B C D E F G Hdays_on_market_fromintegerdays_on_market_tointegerwith_agenciesstring[]without_agenciesstring[]exclude_outliersbooleanBeispielanfrage
Nur Platzhalter: Ersetzen Sie das Token und die Werte durch Ihre eigenen.
curl -X POST "https://api.casafari.com/api/v1/valuation/comparables-prices" \
-H "Authorization: Bearer $CASAFARI_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"comparables_count": 20,
"location_boundary": {
"circle": {
"distance": 3.5,
"target_point": {
"coordinates": {
"latitude": 38.74,
"longitude": -9.17
}
}
}
},
"sold_or_rented_after": "2020-06-01",
"days_on_market_from": 10,
"days_on_market_to": 1000,
"operation": "sale",
"comparables_types": [
"apartment"
],
"bedrooms": 2,
"construction_year": 2010,
"total_area": 125,
"condition": "used",
"floors": [
"middle",
"top"
],
"floor_number": [
3,
5
],
"views": [
"city",
"landscape"
],
"directions": [
"west",
"north"
],
"characteristics": {
"must_have": [
"balcony",
"elevator"
],
"nice_to_have": [
"garage",
"parking",
"storage"
]
},
"energy_ratings": [
"A",
"B",
"C"
]
}'Antworten
200 OK
Typ: object.
Show the response shape (13 fields)
statisticsobjecterforderlichoperation).5 Eigenschaften
average_priceintegererforderlichaverage_price_per_sqmnumbererforderlichaverage_time_on_the_marketintegererforderlichaverage_listings_per_propertynumbererforderlichsold_or_rented_in_last_six_monthsintegererforderlichestimated_pricesobjecterforderlichoperation).6 Immobilien
fast_sell_priceintegererforderlichfair_market_priceintegererforderlichout_of_market_priceintegererforderlichfast_sell_price_per_sqmnumbererforderlichfair_market_price_per_sqmnumbererforderlichout_of_market_price_per_sqmnumbererforderlichBeispiel aus der API-Beschreibung
{
"statistics": {
"average_price": 767950,
"average_price_per_sqm": 6376,
"average_time_on_the_market": 169,
"average_listings_per_property": 6.2,
"sold_or_rented_in_last_six_months": 453
},
"estimated_prices": {
"fast_sell_price": 741210,
"fair_market_price": 797000,
"out_of_market_price": 852790,
"fast_sell_price_per_sqm": 5929.68,
"fair_market_price_per_sqm": 6376,
"out_of_market_price_per_sqm": 6822.32
}
}400 Ungültige Anfrage
Typ: object.
Antwortstruktur anzeigen (1 Feld)
errorsobject401 Nicht autorisiert
Typ: object.
Antwortstruktur anzeigen (1 Feld)
detailZeichenfolge403 Unzulässig
Typ: object.
Antwortstruktur anzeigen (1 Feld)
detailZeichenfolge