Area Insights
Insights for an area: price, supply and activity over time, distributions by price, bedrooms and time on market, and market analysis. Over MCP also growth and volatility measures and heatmaps by district.
MCP server
https://platform.casafari.com/mcp/area-insights: Streamable HTTP, OAuth 2.1 sign-in in the browser with a Casafari API and MCP Platform account, or a platform API key. Its tools are named area-insights_<tool>, and it also has account_status. Also on the one server for every product, https://platform.casafari.com/mcp. Place names become location ids with Location Lookup's locations_search (https://platform.casafari.com/mcp/locations, free). How to connect.
How the service describes itself
The backend service's own initialize instructions, from its source:
Area Insights: market statistics for places and segments (price and time-on-market distributions, time series, heatmaps). Three more tools give registered sale prices, what homes actually sold for, instead of asking prices (area-insights_get_sales_time_series, area-insights_get_sales_average_prices, area-insights_count_sales_by_type): Spain from notary deeds, France from DVF (the public register of property sales), Italy from registered sales recorded by Agenzia delle Entrate, Poland from RCN (Poland's official register of property prices) and Portugal as INE's official medians per municipality and quarter (a circle or polygon, no counts); every call names its country. Call locations_search first to turn a place name into a location id; it is free and on this server, so no other connector is needed. Circle radius is in metres on this server. account_status is free and shows remaining Casafari tokens and, when they run out, a link to top up.
MCP tools
area-insights_get_current_datetimeGet Current DatetimeReturns the current system date and time.area-insights_get_time_series_dataGet Time Series DataRetrieve time series data for the real estate market.area-insights_get_time_series_operationsGet Time Series OperationsPerforms analytical time-series operations (e.g., mean, delta_pct, CAGR, cv, std, etc.) for a single geographic or analytical segment using real-estate historical data.area-insights_get_price_distributionGet Price DistributionReturns a distribution of property prices based on the provided filters.area-insights_get_bedrooms_distributionGet Bedrooms DistributionReturns a distribution of properties grouped by the number of bedrooms.area-insights_get_time_on_market_distributionGet Time on Market DistributionReturns a distribution of properties by their time on the market, grouped by price intervals.area-insights_get_heatmapGet HeatmapGenerate an area insights heatmap showing property distribution and price dynamics across geographic areas.area-insights_get_sales_time_seriesRegistered sale price trend in an areaHow registered sale prices moved in an area of Spain, France, Italy, Poland or Portugal: weekly average sale price and average price per square metre, plus…area-insights_get_sales_average_pricesAverage registered sale prices by locationAverage registered sale price and average price per square metre in Spain, France, Italy, Poland or Portugal, one row per location inside the area: with location_ids,…area-insights_count_sales_by_typeNumber of registered sales by property typeHow many registered sales an area of Spain, France, Italy or Poland had (Portugal has no sales counts), by property type: what kind of properties actually sell there.REST API
10 operations on the platform's REST API, base https://platform.casafari.com/v1/area-insights, with a platform API key from the console (platform API keys), billed in tokens (1 token = EUR 0.04). Casafari clients with a contract also have 6 operations on the existing API at https://api.casafari.com (bearer token), listed after them under Existing API (contract clients). The same list with more detail: Area Insights REST API.
/v1/area-insights/analysisMarket analysis of an areaCosts 25 tokens a call.POST/v1/area-insights/distributions/propertiesProperty type distribution in an areaCosts 25 tokens a call.POST/v1/area-insights/distributions/pricesPrice distribution in an areaCosts 25 tokens a call.POST/v1/area-insights/distributions/bedroomsBedrooms distribution in an areaCosts 25 tokens a call.POST/v1/area-insights/distributions/time-on-marketTime on market distribution in an areaCosts 25 tokens a call.POST/v1/area-insights/time-seriesPrice and activity time series for an areaCosts 25 tokens a call.POST/v1/area-insights/heatmapHeatmap of an area by districtCosts 25 tokens a call.POST/v1/area-insights/sales/time-seriesRegistered sale price trend in an area, week by weekCosts 10 tokens a call.POST/v1/area-insights/sales/average-pricesAverage registered sale prices by locationCosts 10 tokens a call.POST/v1/area-insights/sales/count-by-typeNumber of registered sales by property typeCosts 10 tokens a call.Existing API (contract clients)
On the existing REST API at https://api.casafari.com, with a bearer token from your account's email and password (how to get one): for Casafari clients with a contract. The existing API.
Time Series
/market-analytics-api/time-seriesTime SeriesReturns time series data for the real estate market.Distributions, paths under /market-analytics-api/distributions.
/market-analytics-api/distributions/bedroomsBedrooms DistributionReturns property distribution based on the number of bedrooms.POST/market-analytics-api/distributions/pricesPrice DistributionReturns the number of properties distributed across price ranges.POST/market-analytics-api/distributions/propertiesProperties DistributionReturns the properties lightweight data sample and distribution quartiles.POST/market-analytics-api/distributions/time-on-marketTime On Market DistributionReturns time on market (days and months) distribution by price ranges.Analysis
Pricing
| Operation | Tokens | EUR |
|---|---|---|
POST /v1/area-insights/analysis | 25 tokens a call | 1.00 |
POST /v1/area-insights/distributions/properties | 25 tokens a call | 1.00 |
POST /v1/area-insights/distributions/prices | 25 tokens a call | 1.00 |
POST /v1/area-insights/distributions/bedrooms | 25 tokens a call | 1.00 |
POST /v1/area-insights/distributions/time-on-market | 25 tokens a call | 1.00 |
POST /v1/area-insights/time-series | 25 tokens a call | 1.00 |
POST /v1/area-insights/heatmap | 25 tokens a call | 1.00 |
POST /v1/area-insights/sales/time-series | 10 tokens a call | 0.40 |
POST /v1/area-insights/sales/average-prices | 10 tokens a call | 0.40 |
POST /v1/area-insights/sales/count-by-type | 10 tokens a call | 0.40 |
1 token = EUR 0.04. Free: 1,000 tokens for 30 days; pay as you go: prepaid credits; Agent: EUR 49 a month, or EUR 39 a month billed yearly, with 1,500 tokens a month; Agency: EUR 149 a month, or EUR 119 a month billed yearly, with 5,000 tokens a month; Custom: talk to Casafari. See Pricing and platform API keys.
MCP and REST compared
Over MCP: 10 tools. Over REST: 16 operations. Available over both.
- Equivalent:
area-insights_get_time_series_dataandPOST /v1/area-insights/time-series. - Equivalent:
area-insights_get_time_series_dataandPOST /market-analytics-api/time-series(existing API). - Equivalent:
area-insights_get_price_distributionandPOST /v1/area-insights/distributions/prices. - Equivalent:
area-insights_get_price_distributionandPOST /market-analytics-api/distributions/prices(existing API). - Equivalent:
area-insights_get_bedrooms_distributionandPOST /v1/area-insights/distributions/bedrooms. - Equivalent:
area-insights_get_bedrooms_distributionandPOST /market-analytics-api/distributions/bedrooms(existing API). - Equivalent:
area-insights_get_time_on_market_distributionandPOST /v1/area-insights/distributions/time-on-market. - Equivalent:
area-insights_get_time_on_market_distributionandPOST /market-analytics-api/distributions/time-on-market(existing API). - Equivalent:
area-insights_get_heatmapandPOST /v1/area-insights/heatmap. - Equivalent:
area-insights_get_sales_time_seriesandPOST /v1/area-insights/sales/time-series. - Equivalent:
area-insights_get_sales_average_pricesandPOST /v1/area-insights/sales/average-prices. - Equivalent:
area-insights_count_sales_by_typeandPOST /v1/area-insights/sales/count-by-type.
Only over MCP: area-insights_get_current_datetime, area-insights_get_time_series_operations.
Only over REST: POST /v1/area-insights/analysis, POST /v1/area-insights/distributions/properties, POST /market-analytics-api/distributions/properties (existing API), POST /market-analytics-api/analysis (existing API).
Details: MCP and REST compared.