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

Area Insights · REST API

Heatmap of an area by district

POSThttps://platform.casafari.com/v1/area-insights/heatmap
API-Key25 Tokens pro Aufruf39 parameters

Send Authorization: Bearer $CASAFARI_API_KEY: a platform API key (cf_sk_...) from the console, or an OAuth access token; X-API-Key carries the key too. See platform API keys. Costs 25 tokens a call (1 token = EUR 0.04). In an AI assistant, the same call as an MCP tool costs 5 tokens a call.

The platform's OpenAPI file leaves the shape open; what is shown comes from the same definitions the platform publishes elsewhere: request: the MCP tool area-insights_get_heatmap's input (its request_data object).

Over MCP: area-insights_get_heatmap (equivalent). See MCP and REST compared.

Description

Kostet 25 Tokens pro Aufruf.

Request-Body

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

type_groupZeichenfolgeerforderlich
Immobilientypgruppe.
apartment house
business_typeZeichenfolgeerforderlich
Operationstyp, für den das Objekt verfügbar ist.
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 true
location_idintegererforderlich
1–2147483647
data_pointZeichenfolgeerforderlich
Gibt die Art der Immobiliendaten an, die für einen bestimmten Zeitraum abgerufen werden sollen.
avg_price avg_price_psqm available_on_market new sold_or_rented price_up price_down
date_rangeobjecterforderlich
2 Eigenschaften
minstring (Datum)erforderlich
Start date in the format YYYY-MM-DD. If the specified date is not Monday - the closest previous Monday will be selected
maxstring (Datum)kann null sein
End date in the format YYYY-MM-DD. If the specified date is not Sunday - the closest previous Sunday will be selected

Beispielanfrage

Ersetzen Sie den Schlüssel durch Ihren eigenen. Führen Sie ihn vor der Veröffentlichung auf der Plattform aus: Kopieren Sie ihn, fügen Sie Ihren Schlüssel ein, und er funktioniert.

curl
curl -X POST "https://platform.casafari.com/v1/area-insights/heatmap" \
  -H "Authorization: Bearer $CASAFARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type_group": "apartment",
  "business_type": "sale",
  "location_id": 544116,
  "data_point": "avg_price_psqm",
  "date_range": {
    "min": "2025-01-01",
    "max": "2025-12-31"
  }
}'

Antworten

200 Success.

Typ: object.

Fehler

Jeder Fehler erfolgt als application/problem+json-Body (RFC 9457) mit type (eine Seite zur Erläuterung), title, status, detail (Handlungsempfehlung), instance, code und request_id (bitte bei Supportanfragen angeben). Ein 402-Status enthält eine upgrade_url, ein 429-Status einen Retry-After-Header. Die Codes pro Status:

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