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
- Invoque
locations_searchcon el nombre del lugar en inglés, por ejemploBarcelona, y conserve ellocation_id. - Invoque
area-insights_get_current_datetimepara convertir "los dos últimos años" en undate_rangeconcreto.
Ejecutar area-insights_get_time_series_data una vez por cada data_point con filtros idénticos
- Invoque
area-insights_get_time_series_datacinco veces. Mantenga idénticostype_group,business_type,custom_location_boundary,date_interval,date_rangey cualquier filtro; cambie únicamente eldata_point. Las notas de la propia herramienta recomiendan reutilizar los mismos filtros con valores dedata_pointdistintos, 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
- Para cada serie, invoque
area-insights_get_time_series_operationscon el mismo objeto comosegment. Establezcaoperationsen["trend_strength", "slope_per_period", "delta_pct"]. Puede añadirinc_stepsydec_stepspara 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
- Invoque
area-insights_get_heatmapcon ellocation_idde la ciudad y eldata_pointprice_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
- Envíe
POST https://platform.casafari.com/v1/area-insights/analysiscon una API key de plataforma (API keys de plataforma), el mismocustom_location_boundary, además debusiness_type,typesy 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:
{
"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:
| Par | Serie A | Serie B | Qué revela la diferencia |
|---|---|---|---|
| Oferta frente a absorción | new | sold_or_rented | Si el stock aumenta o se está absorbiendo |
| Presión de los precios | price_down | price_up | Si 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-seriesyPOST /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.