Platform

Casafari es la plataforma de inteligencia de datos inmobiliarios nativa para agentes de IA. El índice inmobiliario más completo de Europa: un grafo inmobiliario limpio y deduplicado de propiedades residenciales y comerciales, en venta y alquiler, en 16 países.El índice inmobiliario más completo de Europa: un grafo inmobiliario limpio y deduplicado.

Cómo se construye el grafo

Area Insights · REST API

Price distribution in an area

POSThttps://platform.casafari.com/v1/area-insights/distributions/prices
API key25 tokens por llamada44 parámetros

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.

El archivo OpenAPI de la plataforma no define la forma; lo que se muestra proviene de las mismas definiciones que la plataforma publica en otros lugares: request: la descripción del mismo backend; response 200: la descripción del mismo backend.

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

Description

Cuesta 25 tokens por llamada.

Cuerpo de la solicitud

Content type application/json. Opcional. Tipo: object.

typesstring[]obligatorio
Lista de tipos de propiedad por grupos: 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"] Tenga en cuenta que solo puede seleccionar varios tipos dentro de un mismo grupo de tipos de propiedad. Algunos tipos solo existen en determinados países: Alemania: dachgeschosswohnung, etagenwohnung, erdgeschosswohnung, family_house, reihenhaus, reihenendhaus, reihenmittelhaus, einfamilienhaus, zweifamilienhaus, landwirtschaftliche_betriebe, restaurant, werkstatt; Francia, Alemania, Italia, Portugal, España: urban_plot, rural_plot.
42 valores permitidosapartment 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
al menos 1 elemento
business_typestringobligatorio
sale rent
price_rangeobjectnullable
2 propiedades
minintegernullable
1–2147483647
maxintegernullable
1–2147483647
price_per_sqm_rangeobjectnullable
2 propiedades
minintegernullable
1–2147483647
maxintegernullable
1–2147483647
rooms_rangeobjectnullable
2 propiedades
minintegernullable
1–15000
maxintegernullable
1–15000
bedrooms_rangeobjectnullable
2 propiedades
minintegernullable
0–15000
maxintegernullable
0–15000
bathrooms_rangeobjectnullable
2 propiedades
minintegernullable
1–15000
maxintegernullable
1–15000
total_area_rangeobjectnullable
2 propiedades
minintegernullable
1–1000000
maxintegernullable
1–1000000
plot_area_rangeobjectnullable
2 propiedades
minintegernullable
1–1000000
maxintegernullable
1–1000000
construction_year_rangeobjectnullable
2 propiedades
minintegernullable
1–3000
maxintegernullable
1–3000
characteristicsobjectnullable
2 propiedades
must_havestring[]
Incluir solo los inmuebles que posean todas estas características.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuity
excludestring[]
Excluir los inmuebles que contengan alguna de estas características.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuity
conditionsstring[]
Estados de la propiedad: cualquiera de used, ruin, very-good, new, other.
used ruin very-good new other
al menos 1 elemento
privateboolean
Indica si el anuncio es de un particular o de un profesional o agencia inmobiliaria.
bankboolean
Si el inmueble es propiedad del banco.
auctionboolean
Si el inmueble está sujeto a subasta.
por defecto false
exclude_outliersboolean
Excluir inmuebles cuyo precio esté significativamente fuera de mercado en comparación con propiedades similares.
por defecto false
custom_location_boundaryobjectobligatorio
3 propiedades
location_idsinteger[]
Lista de ID de ubicación.
1–10 elementos1–2147483647
polygonobject[]
Lista de puntos geográficos en los que realizar la búsqueda. El polígono debe contener al menos 4 puntos. El primer y el último punto deben coincidir.
al menos 4 elementos
2 propiedades
latitudenumberobligatorio
-90–90
longitudenumberobligatorio
-180–180
circleobject
Dibuja un círculo para delimitar el área de búsqueda.
2 propiedades
distanceintegerobligatorio
Distancia máxima en metros desde el target_point solicitado hasta los inmuebles.
50–50000
target_pointobjectobligatorio
Coordenadas del punto objetivo alrededor del cual buscar.
2 propiedades
latitudenumberobligatorio
-90–90
longitudenumberobligatorio
-180–180

Ejemplo de solicitud

Sustituya la clave por la suya. Ejecútelo en la plataforma antes de publicarlo: cópiela, inserte su clave y funcionará.

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

Respuestas

200 Success.

Tipo: object[].

Mostrar la estructura de respuesta (4 campos)
lower_boundintegerobligatorio
Límite inferior de precio de la unidad de distribución.
upper_boundintegerobligatorio
Límite superior de precio de la unidad de distribución.
properties_countintegerobligatorio
Número de inmuebles que participaron en la distribución.
is_meanbooleanobligatorio
Indicates whether the mean value is within this distribution unit.
Ejemplo de una llamada real (Madrid, pisos en venta) (arrays largos abreviados)
JSON
[
  {
    "lower_bound": 1,
    "upper_bound": 50001,
    "properties_count": 10,
    "is_mean": false
  },
  {
    "lower_bound": 50001,
    "upper_bound": 100001,
    "properties_count": 39,
    "is_mean": false
  }
]

Errores

Cada error devuelve un cuerpo application/problem+json (RFC 9457) con type (la página donde se explica), title, status, detail (qué hacer), instance, code y request_id (indíquelo al solicitar soporte). Un error 402 incluye una upgrade_url, y un 429 una cabecera Retry-After. Códigos asociados a cada estado:

Consejo: añada .md a cualquier URL para leerla como Markdown.