Platform
CA
Get started

Casafari is the AI agent-native real estate data intelligence platform. The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries.The most complete property index in Europe: a deduplicated, cleaned property graph.

How the graph is built
Markdown Open in Claude Open in ChatGPT

Area Insights · REST API

Market analysis of an area

POSThttps://platform.casafari.com/v1/area-insights/analysis
API key25 tokens a call42 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).

The platform's OpenAPI file leaves the shape open; what is shown comes from the same definitions the platform publishes elsewhere: request: the existing API's POST /market-analytics-api/analysis, the same backend; response 200: the existing API's POST /market-analytics-api/analysis.

Over MCP: no tool does this.

Description

Costs 25 tokens a call.

Request body

Content type application/json. Optional. Type: object.

custom_location_boundaryobjectrequired
3 properties
location_idsinteger[]
List of location IDs.
1–10 items1–2147483647
polygonobject[]
List of geo-points to search within. Polygon must contain at least 4 points. First and last points must match.
at least 4 items
2 properties
latitudenumberrequired
-90–90
longitudenumberrequired
-180–180
circleobject
Circle boundary to search within.
2 properties
distanceintegerrequired
Maximum distance in meters from the requested target_point to the properties.
50–50000
target_pointobjectrequired
Target point coordinates to search around.
2 properties
latitudenumberrequired
-90–90
longitudenumberrequired
-180–180
business_typestringrequired
Operation type for which the property is available.
sale rent
typesstring[]required
The list of property types by type groups: 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"] Note that you can select multiple types only from one property type group. Some types exist only in some countries: Germany: dachgeschosswohnung, etagenwohnung, erdgeschosswohnung, family_house, reihenhaus, reihenendhaus, reihenmittelhaus, einfamilienhaus, zweifamilienhaus, landwirtschaftliche_betriebe, restaurant, werkstatt; France, Germany, Italy, Portugal, Spain: urban_plot, rural_plot.
42 allowed valuesapartment 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
at least 1 item
conditionsstring[]nullable
Property conditions, as returned by the GET /api/v1/references/conditions endpoint.
used ruin very-good new other
at least 1 item
energy_ratingsstring[]nullable
List of energy ratings that attests to the energy efficiency of the property.
Unknown A+ A B C D E F G H
at least 1 item
orientationsstring[]nullable
Property view orientation.
exterior interior
at least 1 item
viewsstring[]nullable
List of views from the property.
water landscape city golf park
at least 1 item
directionsstring[]nullable
List of cardinal directions the property faces.
north south east west
at least 1 item
floorsstring[]nullable
List of floor types.
no_floor ground middle top
at least 1 item
price_rangeobjectnullable
2 properties
minintegernullable
1–2147483647
maxintegernullable
1–2147483647
rooms_rangeobjectnullable
2 properties
minintegernullable
1–15000
maxintegernullable
1–15000
bedrooms_rangeobjectnullable
2 properties
minintegernullable
0–15000
maxintegernullable
0–15000
bathrooms_rangeobjectnullable
2 properties
minintegernullable
1–15000
maxintegernullable
1–15000
total_area_rangeobjectnullable
2 properties
minintegernullable
1–1000000
maxintegernullable
1–1000000
plot_area_rangeobjectnullable
2 properties
minintegernullable
1–1000000
maxintegernullable
1–1000000
construction_year_rangeobjectnullable
2 properties
minintegernullable
1–3000
maxintegernullable
1–3000
characteristicsobjectnullable
2 properties
must_havestring[]
Include only properties that have all these characteristics.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuity
excludestring[]
Exclude properties that contain any of these characteristics.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuity

Example request

Placeholders only: replace the token and the values with your own.

curl
curl -X POST "https://platform.casafari.com/v1/area-insights/analysis" \
  -H "Authorization: Bearer $CASAFARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "types": [
    "apartment"
  ],
  "business_type": "sale",
  "custom_location_boundary": {
    "location_ids": [
      11737
    ]
  }
}'

Responses

200 Success.

Type: object.

Show the response shape (33 fields)
price_statisticsobjectrequired
Statistics including the average price and average price per square meter for properties matching the requested filters.
2 properties
average_priceintegerrequired
average_price_per_sqmintegerrequired
price_estimationobjectrequired
Provides estimated prices, including a quick sale price fast_market_price and an inflated price out_of_market_price.
2 properties
fast_market_priceintegerrequired
out_of_market_priceintegerrequired
price_evolutionobjectrequired
Represents time series data showing how average prices and prices per square meter have changed over time for inactive properties.
2 properties
avg_priceobjectrequired
5 properties
for_the_last_1_monthintegerrequired
for_the_last_3_monthintegerrequired
for_the_last_6_monthintegerrequired
for_the_last_9_monthintegerrequired
for_the_last_12_monthintegerrequired
avg_price_per_sqmobjectrequired
5 properties
for_the_last_1_monthintegerrequired
for_the_last_3_monthintegerrequired
for_the_last_6_monthintegerrequired
for_the_last_9_monthintegerrequired
for_the_last_12_monthintegerrequired
summary_price_evolutionobjectrequired
Represents time series data showing how average prices and prices per square meter have changed over time for both active and inactive properties.
2 properties
avg_priceobjectrequired
5 properties
for_the_last_1_monthintegerrequired
for_the_last_3_monthintegerrequired
for_the_last_6_monthintegerrequired
for_the_last_9_monthintegerrequired
for_the_last_12_monthintegerrequired
avg_price_per_sqmobjectrequired
5 properties
for_the_last_1_monthintegerrequired
for_the_last_3_monthintegerrequired
for_the_last_6_monthintegerrequired
for_the_last_9_monthintegerrequired
for_the_last_12_monthintegerrequired
average_days_on_the_marketintegerrequired
Indicates the average number of days properties remain listed on the market before being sold or removed.
Example from a real call (Madrid, apartments for sale)
JSON
{
  "price_statistics": {
    "average_price": 1011690,
    "average_price_per_sqm": 7305
  },
  "price_estimation": {
    "fast_market_price": 539298,
    "out_of_market_price": 596067
  },
  "price_evolution": {
    "avg_price": {
      "for_the_last_1_month": 578551,
      "for_the_last_3_month": 577572,
      "for_the_last_6_month": 574922,
      "for_the_last_9_month": 571344,
      "for_the_last_12_month": 567683
    },
    "avg_price_per_sqm": {
      "for_the_last_1_month": 4820,
      "for_the_last_3_month": 4802,
      "for_the_last_6_month": 4771,
      "for_the_last_9_month": 4733,
      "for_the_last_12_month": 4693
    }
  },
  "summary_price_evolution": {
    "avg_price": {
      "for_the_last_1_month": 615491,
      "for_the_last_3_month": 613654,
      "for_the_last_6_month": 613816,
      "for_the_last_9_month": 611901,
      "for_the_last_12_month": 608941
    },
    "avg_price_per_sqm": {
      "for_the_last_1_month": 5071,
      "for_the_last_3_month": 5038,
      "for_the_last_6_month": 5024,
      "for_the_last_9_month": 4992,
      "for_the_last_12_month": 4953
    }
  },
  "average_days_on_the_market": 133
}

Errors

Every error is an application/problem+json body (RFC 9457) with type (a page that explains it), title, status, detail (what to do), instance, code and request_id (what to quote to support). A 402 carries an upgrade_url, a 429 a Retry-After header. The codes each status can carry:

Esc

Tip: add .md to any URL to read it as Markdown.