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 · Area Insights

Price Distribution

POSThttps://api.casafari.com/market-analytics-api/distributions/prices
Bearer-Token44 Parameter

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/area-insights/distributions/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 the number of properties distributed across price ranges.

Each range is defined by price boundaries and shows the number of properties with prices falling within those boundaries.

Request-Body

Content-Type application/json. Erforderlich. Typ: object.

typesstring[]erforderlich
Die Liste der Immobilienarten nach Typgruppen: apartment: ["apartment", "studio", "duplex", "penthouse", "dachgeschosswohnung", "etagenwohnung", "erdgeschosswohnung"] house: ["country_house", "house", "palace", "townhouse", "villa", "country_estate", "chalet", "bungalow", "family_house", "reihenhaus", "reihenendhaus", "reihenmittelhaus", "einfamilienhaus", "zweifamilienhaus", "landwirtschaftliche_betriebe"] room: ["room"] building: ["apartment_building", "office_building", "mix_use_building"] investment: ["retail", "office", "industrial", "warehouse", "hotel", "building", "other_commercial", "restaurant", "werkstatt"] development: ["apartment_development", "house_development"] plot: ["urban_plot", "rural_plot"] other: ["parking", "garage", "other"] Beachten Sie, dass Sie mehrere Typen nur aus einer Immobilienartengruppe auswählen können. Einige Typen sind nur in bestimmten Ländern verfügbar: Deutschland: dachgeschosswohnung, etagenwohnung, erdgeschosswohnung, family_house, reihenhaus, reihenendhaus, reihenmittelhaus, einfamilienhaus, zweifamilienhaus, landwirtschaftliche_betriebe, restaurant, werkstatt; Frankreich, Deutschland, Italien, Portugal, Spanien: urban_plot, rural_plot.
42 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 building other_commercial restaurant werkstatt urban_plot rural_plot room parking garage other apartment_building office_building mix_use_building apartment_development house_development
mindestens 1 Element
business_typeZeichenfolgeerforderlich
sale rent
price_rangeobjectkann null sein
2 Eigenschaften
minintegerkann null sein
1–2147483647
maxintegerkann null sein
1–2147483647
price_per_sqm_rangeobjectkann null sein
2 Eigenschaften
minintegerkann null sein
1–2147483647
maxintegerkann null sein
1–2147483647
rooms_rangeobjectkann null sein
2 Eigenschaften
minintegerkann null sein
1–15000
maxintegerkann null sein
1–15000
bedrooms_rangeobjectkann null sein
2 Eigenschaften
minintegerkann null sein
0–15000
maxintegerkann null sein
0–15000
bathrooms_rangeobjectkann null sein
2 Eigenschaften
minintegerkann null sein
1–15000
maxintegerkann null sein
1–15000
total_area_rangeobjectkann null sein
2 Eigenschaften
minintegerkann null sein
1–1000000
maxintegerkann null sein
1–1000000
plot_area_rangeobjectkann null sein
2 Eigenschaften
minintegerkann null sein
1–1000000
maxintegerkann null sein
1–1000000
construction_year_rangeobjectkann null sein
2 Eigenschaften
minintegerkann null sein
1–3000
maxintegerkann null sein
1–3000
characteristicsobjectkann null sein
2 Eigenschaften
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
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
conditionsstring[]
Objektzustände: einer der Werte used, ruin, very-good, new, other.
used ruin very-good new other
mindestens 1 Element
privateboolean
Angabe, ob das Objekt von einer Privatperson inseriert wurde, im Gegensatz zu einem Makler oder einem gewerblichen Anbieter.
bankboolean
Ob sich die Immobilie im Besitz einer Bank befindet.
auctionboolean
Ob die Immobilie zwangsversteigert wird.
Standardwert falsch
exclude_outliersboolean
Schließt Immobilien aus, deren Preis im Vergleich zu ähnlichen Objekten deutlich unter- oder überbewertet ist.
Standardwert falsch
custom_location_boundaryobjecterforderlich
3 Immobilien
location_idsinteger[]
Liste der Standort-IDs.
1–10 Ergebnisse1–2147483647
polygonobject[]
Liste der Geo-Punkte für die Suche. Ein Polygon muss mindestens 4 Punkte enthalten. Der erste und der letzte Punkt müssen übereinstimmen.
mindestens 4 Elemente
2 Eigenschaften
latitudenumbererforderlich
-90–90
longitudenumbererforderlich
-180–180
circleobject
Kreisbegrenzung für die Suche.
2 Eigenschaften
distanceintegererforderlich
Maximale Entfernung in Metern vom angeforderten target_point zu den Immobilien.
50–50000
target_pointobjecterforderlich
Koordinaten des Zielpunkts für die Umkreissuche.
2 Eigenschaften
latitudenumbererforderlich
-90–90
longitudenumbererforderlich
-180–180

Beispielanfrage

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

curl
curl -X POST "https://api.casafari.com/market-analytics-api/distributions/prices" \
  -H "Authorization: Bearer $CASAFARI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "types": [
    "apartment"
  ],
  "business_type": "sale",
  "custom_location_boundary": {
    "location_ids": [
      11737
    ]
  }
}'

Antworten

200 Erfolgreiche Antwort

Typ: object[].

Antwortstruktur anzeigen (4 Felder)
lower_boundintegererforderlich
Die untere Preisgrenze der Verteilungseinheit.
upper_boundintegererforderlich
Die obere Preisgrenze der Verteilungseinheit.
properties_countintegererforderlich
Die Anzahl der Immobilien, die in die Verteilung eingeflossen sind.
is_meanbooleanerforderlich
Indicates whether the mean value is within this distribution unit.
Beispiel eines realen Aufrufs (Madrid, Wohnungen zum Kauf) (lange Arrays gekürzt)
JSON
[
  {
    "lower_bound": 1,
    "upper_bound": 50001,
    "properties_count": 10,
    "is_mean": false
  },
  {
    "lower_bound": 50001,
    "upper_bound": 100001,
    "properties_count": 39,
    "is_mean": false
  }
]

204 Kein Inhalt

Kein Body.

400 Ungültige Anfrage

Typ: object.

Antwortstruktur anzeigen (3 Felder)
messageZeichenfolgeerforderlich
errorsstring[]kann null sein
detailsZeichenfolgekann null sein

422 Validierungsfehler

Typ: object.

Antwortstruktur anzeigen (6 Felder)
detailobject[]
5 Eigenschaften
loc(string | integer)[]erforderlich
msgZeichenfolgeerforderlich
typeZeichenfolgeerforderlich
inputany
ctxobject

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