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

Entender una zona · Caso de uso

¿Es un mercado de compradores o de vendedores en esta zona?

Casafari Area Insights muestra si un área favorece a compradores o vendedores mediante series temporales de actividad. Ejecute area-insights_get_time_series_data una vez para cada new, sold_or_rented, available_on_market, price_up y price_down sobre la misma área y filtros. Si la nueva oferta supera a las ventas, con más bajadas que subidas de precio, indica un mercado de compradores; al contrario, indica un mercado de vendedores.

Productos: Area Insights

Respuesta corta

Area Insights ofrece cinco puntos de datos de actividad:

  • new: propiedades recién anunciadas.
  • sold_or_rented: propiedades vendidas o alquiladas.
  • available_on_market: propiedades en el mercado.
  • price_up: aumentos de precio.
  • price_down: disminuciones de precio.

Las cinco proceden de los cambios de estado y de precio registrados en el grafo inmobiliario de Casafari. Cada registro de inmueble conserva cada cambio de precio, modificación de estado, aparición y retirada, junto con sus fechas. Analice las cinco series en conjunto para determinar si el stock aumenta o se absorbe, y si los vendedores están bajando o subiendo los precios.

Pasos

Definir la zona y establecer las fechas

  1. Invoque locations_search con el nombre del lugar en inglés, por ejemplo Barcelona, y conserve el location_id.
  2. Invoque area-insights_get_current_datetime para convertir "los dos últimos años" en un date_range concreto.

Ejecutar area-insights_get_time_series_data una vez por cada data_point con filtros idénticos

  1. Invoque area-insights_get_time_series_data cinco veces. Mantenga idénticos type_group, business_type, custom_location_boundary, date_interval, date_range y cualquier filtro; cambie únicamente el data_point. Las notas de la propia herramienta recomiendan reutilizar los mismos filtros con valores de data_point distintos, por ejemplo, para comparar la nueva oferta con las propiedades vendidas.

Calcular trend_strength, slope_per_period y delta_pct con area-insights_get_time_series_operations

  1. Para cada serie, invoque area-insights_get_time_series_operations con el mismo objeto como segment. Establezca operations en ["trend_strength", "slope_per_period", "delta_pct"]. Puede añadir inc_steps y dec_steps para contar los periodos de aumento y descenso.

Mapear la concentración de bajadas de precio con area-insights_get_heatmap y el data_point price_down

  1. Invoque area-insights_get_heatmap con el location_id de la ciudad y el data_point price_down. Devuelve un valor por distrito, lo que permite visualizar dónde se concentran las bajadas.

En REST, use POST /v1/area-insights/analysis para un análisis de mercado del mismo perímetro

  1. Envíe POST https://platform.casafari.com/v1/area-insights/analysis con una API key de plataforma (API keys de plataforma), el mismo custom_location_boundary, además de business_type, types y cualquier filtro de rango. Los campos de respuesta están documentados en la página de la operación; esta página no los repite.

Ejemplo: pisos en venta en Barcelona, mensual

Prompt para el asistente: "¿Se está enfriando el mercado de pisos en Barcelona? Compara la nueva oferta con las ventas y las bajadas de precio con las subidas, mes a mes desde 2024."

El asistente invoca locations_search (Barcelona), seguido de area-insights_get_current_datetime y, posteriormente, cuatro peticiones de series. Las cuatro peticiones son idénticas salvo por el data_point:

json
{
  "request_data": {
    "alias": "Barcelona apartments, sale",
    "type_group": "apartment",
    "business_type": "sale",
    "custom_location_boundary": {"location_ids": [BARCELONA_LOCATION_ID]},
    "data_point": "new",
    "date_interval": "month",
    "date_range": {"min": "2024-01-01"}
  }
}

A continuación, alinea las series por date_start:

ParSerie ASerie BQué revela la diferencia
Oferta frente a absorciónnewsold_or_rentedSi el stock aumenta o se está absorbiendo
Presión de los preciosprice_downprice_upSi los vendedores están ajustando sus precios a la baja

Por último, añade available_on_market como línea de stock y delta_pct para cada serie. Las cifras provienen de las llamadas en tiempo real; esta documentación no publica ninguna.

Cómo leer el resultado

Nueva oferta que crece más deprisa que sold_or_rented: el stock se acumula

Cuando new supera a sold_or_rented mes tras mes y available_on_market aumenta, la oferta supera la absorción. Esto favorece a los compradores y facilita la negociación. El patrón opuesto, con una caída del stock, favorece a los vendedores.

Si price_down supera a price_up: los vendedores ajustan precios

Un mayor número de price_down frente a price_up muestra que los precios de venta se encuentran con resistencia. Compruebe dónde sucede con el mapa de calor de price_down antes de generalizar a toda la ciudad.

Los recuentos son propiedades, no anuncios

El grafo inmobiliario fusiona cada anuncio de la misma propiedad en un único registro. Por tanto, una vivienda anunciada por tres agencias cuenta una sola vez en new, available_on_market y en los demás recuentos. Consulte Por qué Casafari cuenta propiedades.

Límites

Disponibilidad:

  • Todas las herramientas MCP de Area Insights, además de las operaciones REST POST /v1/area-insights/time-series y POST /v1/area-insights/analysis, funcionan mediante autoservicio en la API y la plataforma MCP de Casafari, utilizando una API key de plataforma.
  • Los clientes actuales de Casafari también se registran allí; los clientes con contrato se configuran en el plan Custom. Los clientes actuales de la Legacy API mantienen las mismas operaciones bajo /market-analytics-api/.

Cobertura y datos:

  • Las descripciones de las herramientas no especifican ningún mercado concreto.
  • Los recuentos de actividad provienen de las propiedades anunciadas y sus cambios de estado. No son registros del registro de la propiedad ni notariales.

Precios, cuotas y actualización:

  • Las fuentes no ofrecen cifras sobre precios, cuotas o frecuencia de actualización. Consulte a Casafari.

Un data_point por petición

Cada solicitud de area-insights_get_time_series_data o area-insights_get_time_series_operations contiene un único data_point, type_group y business_type. Una vista de cinco señales requiere, por tanto, cinco solicitudes de serie, además de una solicitud de operaciones por serie.

Los campos del cuerpo de análisis REST son los publicados en su página de operación

El cuerpo de la solicitud POST /v1/area-insights/analysis acepta estos campos:

  • custom_location_boundary, business_type, types.
  • conditions, energy_ratings, orientations, views, directions, floors, characteristics.
  • price_range, rooms_range, bedrooms_range, bathrooms_range, total_area_range, plot_area_range, construction_year_range.

Su respuesta se describe únicamente en la página de la operación.

Preguntas

¿Qué cuenta exactamente sold_or_rented?

sold_or_rented cuenta las propiedades vendidas o alquiladas en cada periodo, tal como indica la descripción de la herramienta. El recuento proviene de los cambios de estado a vendido o alquilado registrados en el grafo inmobiliario de Casafari, y cada propiedad cuenta una sola vez. No se trata de datos del registro de la propiedad ni notariales. La documentación no publica más detalles sobre cómo se confirma un cambio de estado, por lo que debe considerar el recuento como actividad en propiedades anunciadas.

¿Puedo separar las ventas de los alquileres?

Sí. Cada solicitud de serie temporal de Area Insights admite business_type, ya sea sale o rent. Con sale, la serie describe el mercado de ventas; con rent, el mercado de alquiler. Cada solicitud cubre uno de los dos mercados; ejecute el mismo conjunto de puntos de datos dos veces para compararlos. Mantenga todos los demás filtros idénticos para que ambas vistas sigan siendo comparables.

¿Puedo filtrar por obra nueva o estado muy bueno?

Sí, por estado de la propiedad. Establezca conditions en ["new"] o ["very-good"]. Los valores permitidos son used, ruin, very-good, new y other. Tenga en cuenta que esto es un filtro de estado, no un indicador de obra nueva. El esquema de series temporales de Area Insights no tiene un campo independiente para obra nueva.

¿Cómo se contabiliza una propiedad si varias agencias la anuncian?

Se contabiliza una vez. Casafari elimina los anuncios duplicados de portales y webs inmobiliarias, fusionándolos en un único registro por propiedad con su historial completo de precios y estados. Area Insights contabiliza esos registros, por lo que una vivienda anunciada por varias agencias suma una unidad a new, available_on_market o price_down, y no una por anuncio. Consulte /docs/property-graph.

Todos los casos de uso

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