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 · MCP-Tool

area-insights_get_heatmap

Get Heatmap

Schreibgeschützt40 parametersTypisierte Antwort

Call it as area-insights_get_heatmap on the Area Insights MCP server, https://platform.casafari.com/mcp/area-insights (how to connect).

Over REST: POST /v1/area-insights/heatmap (equivalent). MCP and REST compared.

What does Get Heatmap do?

Generate an area insights heatmap showing property distribution and price dynamics across geographic areas.

This tool aggregates active real estate listings for the child locations of the given location_id (e.g., districts of a city), returning the selected data_point metric for each of them. It supports a wide range of property filters, including estate type, price range, construction year, and location hierarchy.

Use Cases

Retrieve geographic insights for real estate analytics:

  • Visualize market activity intensity across a city or region.
  • Identify hotspots of high property density or high average price.
  • Compare neighborhoods based on average price per sqm.
  • Analyze supply distribution and property trends over time.
  • Combine with time-series data to understand historical evolution by area.

Parameters

NameTypeRequiredDescription
request_dataMCPHeatMapRequestSchemaYesDefines filters, metrics, and date range for heatmap generation.

Important Notes

  • Only ACTIVE listings are included.
  • The tool automatically resolves child locations (e.g., neighborhoods within a city).
  • If no matching data is found, a ToolError will be raised.
  • Use returned data for map visualization or spatial analytics dashboards.

Returns

json
[
  {
    "location_id": 12345,
    "location_name": "Lisbon",
    "value": 5200.5
  }
]

Each item represents one geographic unit with aggregated metric value.

Which parameters does area-insights_get_heatmap take?

request_dataobjecterforderlich
19 properties
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, wie sie vom Endpunkt GET /api/v1/references/conditions zurückgegeben werden.
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

Was wird zurückgegeben?

Returned as result.

Antwortstruktur anzeigen (3 Felder)
location_idintegererforderlich
location_nameZeichenfolgeerforderlich
valuenumbererforderlich

How do I call area-insights_get_heatmap?

Ein Beispiel, das vor der Veröffentlichung auf der Plattform ausgeführt wurde: Es funktioniert so wie es ist. Ihr Assistent füllt Ihre eigenen Werte basierend auf den oben genannten Parametern aus.

JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "area-insights_get_heatmap",
    "arguments": {
      "request_data": {
        "type_group": "apartment",
        "business_type": "sale",
        "location_id": 544116,
        "data_point": "avg_price_psqm",
        "date_range": {
          "min": "2025-01-01",
          "max": "2025-12-31"
        }
      }
    }
  }
}

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