Platform

Casafari ist die KI-Agent-native Plattform für Immobiliendatenintelligenz. Der umfassendste Immobilienindex Europas: ein bereinigter, deduplizierter Immobiliengraph für Wohn- und Gewerbeimmobilien, zum Kauf und zur Miete, in 16 Ländern.Der umfassendste Immobilienindex Europas: ein bereinigter, deduplizierter Immobiliengraph.

Wie der Graph aufgebaut ist

Legacy API · Comparables & Valuation

Search estimated prices (v1)

POSThttps://api.casafari.com/api/v1/valuation/comparables-prices
Bearer-Token58 parameters

Legacy 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_countintegererforderlich
Maximale Anzahl an vergleichbaren Immobilien in den Ergebnissen.
1–50
target_pointobject
Zielpunkt für die Umkreissuche. Kann als Koordinaten, Adresse oder Katasterreferenz der Immobilie definiert werden. Es sollte nur ein Wert angegeben werden. Dieses Feld ist veraltet und wird mit dem nächsten größeren Update entfernt. Bitte verwenden Sie stattdessen das Feld location_boundary.circle.
3 Immobilien
coordinatesobject
Koordinaten des Zielpunkts für die Umkreissuche.
2 Eigenschaften
latitudenumbererforderlich
Latitude.
-90–90
longitudenumbererforderlich
Longitude.
-180–180
addressZeichenfolge
Adresse der Immobilie zur Festlegung des Zielpunkts für die Umkreissuche.
cadastral_referenceobject
Katasterreferenz der Immobilie zur Festlegung des Zielpunkts für die Umkreissuche. Derzeit nur für Spanien verfügbar.
4 Immobilien
country_codeZeichenfolgeerforderlich
Ländercode gemäß ISO 3166-1 alpha-2.
ES
cadastral_referenceZeichenfolgeerforderlich
Katasterreferenz des Grundstücks.
provinceZeichenfolge
Name der Provinz des Grundstücks.
municipalityZeichenfolge
Name der Gemeinde des Grundstücks.
distancenumber
Maximale Entfernung in Kilometern vom angeforderten target_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.
0.05–50Standardwert 5
location_boundaryobjecterforderlich
Standort für die Suche. Kann als Polygon aus Geopunkten oder als Kreis mit einem Zielpunkt und einer Entfernung definiert werden. Es sollte nur ein Wert angegeben werden.
2 Eigenschaften
polygonobject[]
Geschlossenes Polygon aus Geopunkten für die Suche. Der erste und der letzte Punkt müssen identisch sein.
mindestens 4 Elemente
2 Eigenschaften
latitudenumbererforderlich
Latitude.
-90–90
longitudenumbererforderlich
Longitude.
-180–180
circleobject
Kreisbegrenzung für die Suche.
2 Eigenschaften
distancenumber
Maximale Entfernung in Kilometern vom angeforderten target_point zu den Immobilien.
0.05–50Standardwert 5
target_pointobjecterforderlich
Zielpunkt für die Umkreissuche. Kann als Koordinaten, Adresse oder Katasterreferenz der Immobilie definiert werden. Es sollte nur ein Wert angegeben werden.
3 Immobilien
coordinatesobject
Koordinaten des Zielpunkts für die Umkreissuche.
2 Eigenschaften
latitudenumbererforderlich
Latitude.
-90–90
longitudenumbererforderlich
Longitude.
-180–180
addressZeichenfolge
Adresse der Immobilie zur Festlegung des Zielpunkts für die Umkreissuche.
cadastral_referenceobject
Katasterreferenz der Immobilie zur Festlegung des Zielpunkts für die Umkreissuche. Derzeit nur für Spanien verfügbar.
4 Immobilien
country_codeZeichenfolgeerforderlich
Ländercode gemäß ISO 3166-1 alpha-2.
ES
cadastral_referenceZeichenfolgeerforderlich
Katasterreferenz des Grundstücks.
provinceZeichenfolge
Name der Provinz des Grundstücks.
municipalityZeichenfolge
Name der Gemeinde des Grundstücks.
sold_or_rented_afterstring (Datum)kann null sein
Immobilien, die seit diesem Datum (im Format YYYY-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.
operationZeichenfolgeerforderlich
Operationstyp.
sale rent
comparables_typeZeichenfolge
Comparables property type. This field is deprecated and will be removed in the next major update. Please, use comparables_types field instead.
40 zulässige Werteapartment 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_building
comparables_typesstring[]erforderlich
Country availability per type is available at the GET /api/v1/references/types endpoint. Property types by type groups: apartment: penthouse, dachgeschosswohnung, erdgeschosswohnung, apartment, etagenwohnung, studio, duplex house: townhouse, reihenmittelhaus, landwirtschaftliche_betriebe, country_house, family_house (DEPRECATED), villa, palace, chalet, zweifamilienhaus, country_estate, reihenendhaus, reihenhaus, bungalow, einfamilienhaus, house room: room building: office_building, apartment_building, mix_use_building investment: retail, hotel, warehouse, office, restaurant, industrial, other_commercial, werkstatt plot: rural_plot, urban_plot, plot (DEPRECATED) other: garage, other, parking Note that you can select multiple types only from one property type group.
40 zulässige Werteapartment 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_building
min_priceinteger
Mindestpreisfilter für die Ergebnisse der Vergleichsobjekte.
0–2147483647Standardwert 0
max_priceinteger
Höchstpreisfilter für die Ergebnisse der Vergleichsobjekte.
1–2147483647
conditionZeichenfolge
Objektzustand: einer der Werte used, ruin, very-good, new, other.
used ruin very-good new other
bedroomsinteger
Anzahl der Schlafzimmer (kann nicht zusammen mit rooms verwendet werden).
0–15000
roomsinteger
Anzahl der Räume (kann nicht zusammen mit bedrooms verwendet werden).
0–15000
bathroomsinteger
Anzahl der Badezimmer.
1–15000
construction_yearinteger
Gewünschtes Baujahr.
1–3000
total_areainteger
Gewünschte Gesamtfläche in Quadratmetern. Dieses Feld ist für die Immobilientypen hotel, industrial, office, other_commercial, restaurant, retail, warehouse und werkstatt erforderlich, sofern kein target_point.cadastral_reference angegeben ist.
5–10000000
plot_areainteger
Gewünschte Grundstücksfläche in Quadratmetern. Dieses Feld ist für die Immobilientypen rural_plot und urban_plot erforderlich, sofern kein target_point.cadastral_reference angegeben ist.
20–10000000
floorsstring[]
Liste der Etagen-Typen.
no_floor ground middle top
floor_numberinteger[]
Gewünschte Liste der Etagen. Negative Werte stehen für Untergeschosse (z. B. Keller). Der Mindestwert beträgt -250, der Höchstwert 250.
-250–250
orientationZeichenfolge
Ausrichtung des Ausblicks der Immobilie.
exterior interior
viewsstring[]
Liste der Ausblicke von der Immobilie.
water landscape city golf park
directionsstring[]
Liste der Himmelsrichtungen, in die das Objekt ausgerichtet ist.
north south east west
characteristicsobject
Eigenschaften der Immobilie.
3 Immobilien
must_havestring[]
Berücksichtigt nur Immobilien, die über all diese Merkmale verfügen.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuity
nice_to_havestring[]
Berücksichtigt Immobilien, die über mindestens eines dieser Merkmale verfügen.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuity
excludestring[]
Schließt Immobilien aus, die eines dieser Merkmale aufweisen.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuity
energy_certificateZeichenfolge
Energieausweis. Dieses Feld ist veraltet und wird mit dem nächsten größeren Update entfernt. Bitte verwenden Sie stattdessen das Feld energy_ratings.
Unknown A+ A B C D E F G H
energy_certificatesstring[]
Liste der Energieausweise. Dieses Feld ist veraltet und wird mit dem nächsten größeren Update entfernt. Bitte verwenden Sie stattdessen das Feld energy_ratings.
Unknown A+ A B C D E F G H
energy_ratingsstring[]
Liste der Energieeffizienzklassen.
Unknown A+ A B C D E F G H
days_on_market_frominteger
Mindestanzahl der Tage auf dem Markt.
1–10000
days_on_market_tointeger
Höchstanzahl der Tage auf dem Markt.
1–10000
with_agenciesstring[]
Return properties from specified agencies, companies or sources. To find allowed agency names use the GET /api/v1/references/agencies endpoint.
without_agenciesstring[]
Exclude properties from specified agencies, companies or sources. To find allowed agency names use the GET /api/v1/references/agencies endpoint.
exclude_outliersboolean
Schließt Immobilien aus, deren Preis im Vergleich zu ähnlichen Objekten deutlich unter- oder überbewertet ist.
Standardwert true

Beispielanfrage

Nur Platzhalter: Ersetzen Sie das Token und die Werte durch Ihre eigenen.

curl
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)
statisticsobjecterforderlich
Statistische Informationen für die gefundenen Vergleichsobjekte (für die in der Anfrage definierte operation).
5 Eigenschaften
average_priceintegererforderlich
Durchschnittspreis.
average_price_per_sqmnumbererforderlich
Average price per square meter.
average_time_on_the_marketintegererforderlich
Durchschnittliche Vermarktungsdauer in Tagen.
average_listings_per_propertynumbererforderlich
Durchschnittliche Anzahl der Inserate pro Immobilie.
sold_or_rented_in_last_six_monthsintegererforderlich
Anzahl der Immobilien, die in den letzten 6 Monaten am angefragten Standort verkauft oder vermietet wurden.
estimated_pricesobjecterforderlich
Geschätzte Preise auf Basis der gefundenen Vergleichsobjekte (für die in der Anfrage definierte operation).
6 Immobilien
fast_sell_priceintegererforderlich
Schnellverkaufspreis.
fair_market_priceintegererforderlich
Marktgerechter Preis.
out_of_market_priceintegererforderlich
Preis außerhalb des Marktbereichs.
fast_sell_price_per_sqmnumbererforderlich
Schnellverkaufspreis pro Quadratmeter.
fair_market_price_per_sqmnumbererforderlich
Marktgerechter Preis pro Quadratmeter.
out_of_market_price_per_sqmnumbererforderlich
Preis pro Quadratmeter außerhalb des Marktbereichs.
Beispiel aus der API-Beschreibung
JSON
{
  "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)
errorsobject
Beschreibung der aufgetretenen Fehler.

401 Nicht autorisiert

Typ: object.

Antwortstruktur anzeigen (1 Feld)
detailZeichenfolge
Beschreibung des aufgetretenen Fehlers.

403 Unzulässig

Typ: object.

Antwortstruktur anzeigen (1 Feld)
detailZeichenfolge
Beschreibung des aufgetretenen Fehlers.

Fragen dazu

Tipp: Fügen Sie .md an eine URL an, um den Inhalt als Markdown zu lesen.