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_time_series_data

Get Time Series Data

Schreibgeschützt48 parametersTypisierte Antwort

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

Over REST: POST /v1/area-insights/time-series (equivalent), POST /market-analytics-api/time-series (equivalent). MCP and REST compared.

What does Get Time Series Data do?

Retrieve time series data for the real estate market. Each data point in the series represents an aggregated metric (data_point) for a specific period, defined by the chosen date_interval and property filters.

This tool provides consistent, interval-based historical data for various real estate indicators.

Use Cases

Retrieve historical market information, such as:

  • Average property prices.
  • Average price per square meter.
  • Number of properties sold or rented over time.
  • Number of newly listed properties.
  • Number of properties available on the market.
  • Number of price increases or decreases for listings.

Parameters

NameTypeRequiredDescription
request_dataMCPTimeSeriesRequestSchemaYesDefines filters, time interval, and data metric (data_point) for aggregation.

Filter highlights

  • data_point: defines which metric to retrieve (e.g. price, listings, sold count, etc.).
  • date_interval: defines the frequency of data points in the response (WEEK, MONTH, QUARTER, YEAR).
  • custom_location_boundary: spatial boundary (circle or list of location IDs).
  • type_group: group of property types to analyze.
  • business_type: "sale" or "rent".
  • exclude_outliers: optionally exclude statistical outliers from the results.
  • optional property filters: price range, area, bedrooms, bathrooms, etc.

Important Notes

  • If you need to compare different property types, send separate requests for each type group.
  • For broader analyses, prefer using AVERAGE_PRICE_PER_SQM over total price.
  • You can reuse the same filters with different data_point values to analyze multiple aspects of the market (e.g. compare new listings vs. sold properties).
  • Use the exclude_outliers flag to remove extreme values and improve analytical accuracy.

Returns

json
[
  {
    "date_start": "2024-01-01",
    "value": 4350.5
  }
]

Which parameters does area-insights_get_time_series_data take?

request_dataobjecterforderlich
One analytical segment defining a specific filter or location boundary. Alias (name) is generated automatically on the server based on the location definition.
21 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
aliasZeichenfolgeerforderlich
Alias (name) of the segment that was analyzed.
custom_location_boundaryobjecterforderlich
Geographic boundary definition (circle, or location ID list).
2 Eigenschaften
location_idsinteger[]
Liste der Standort-IDs.
1–10 Ergebnisse1–2147483647
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
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_intervalZeichenfolgeerforderlich
Defines the time interval for aggregating data points. Determines the frequency at which data is reported in the response.
week month quarter year
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 (2 Felder)
date_startstring (Datum)erforderlich
The starting date of the period associated with the passed date_interval field value. The format follows YYYY-MM-DD.
valuenumbererforderlich
The numerical value corresponding to the passed data_point field value for the given date_start.

How do I call area-insights_get_time_series_data?

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_time_series_data",
    "arguments": {
      "request_data": {
        "type_group": "apartment",
        "business_type": "sale",
        "custom_location_boundary": {
          "location_ids": [
            544116
          ]
        },
        "alias": "Berlin",
        "data_point": "avg_price_psqm",
        "date_interval": "quarter",
        "date_range": {
          "min": "2024-01-01",
          "max": "2025-12-31"
        }
      }
    }
  }
}

Fragen dazu

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