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

Registered sale price trend in an area, week by week

POSThttps://platform.casafari.com/v1/area-insights/sales/time-series
API key10 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 10 tokens a call (1 token = EUR 0.04). In an AI assistant, the same call as an MCP tool costs 5 tokens a call.

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

Description

Cuesta 10 tokens por llamada.

Cuerpo de la solicitud

Tipo de contenido application/json. Obligatorio. Tipo: object.

countrystringobligatorio
ES (España), FR (Francia), IT (Italia), PL (Polonia) o PT (Portugal: mediana oficial por m² del INE por municipio y trimestre; el área como location_ids, un círculo o un polígono, solo tipos y sold_at_range como filtros, sin recuentos) o AT (Austria: precios anuales de datos abiertos por m² por municipio, distrito o estado; solo location_ids; sin recuentos; no disponible hasta que Casafari indique su fuente).
ES FR IT PL PT AT
location_boundaryobjectobligatorio
El área: exactamente uno de los valores siguientes: location_ids (de Location Lookup), circle o polygon.
3 propiedades
location_idsinteger[]
ID de ubicación de Location Lookup (locations_search), todos en el país de la solicitud.
1–100 elementos≥ 1
circleobject
Un círculo: su centro y radio en metros (de 1 a 50 000).
2 propiedades
coordinatesobjectobligatorio
2 propiedades
latnumberobligatorio
-90–90
lonnumberobligatorio
-180–180
radius_in_metersnumberobligatorio
1–50000
polygonobject[]
Un polígono cerrado: al menos 4 puntos, con el último igual al primero.
De 4 a 1000 elementos
2 propiedades
latnumberobligatorio
-90–90
lonnumberobligatorio
-180–180
sold_at_rangeobjectobligatorio
Sale dates, YYYY-MM-DD, both bounds required: {"gte": "2024-01-01", "lte": "2025-12-31"} (or gt / lt).
4 propiedades
gtecadena (fecha)
patrón ^\d{4}-\d{2}-\d{2}$
gtcadena (fecha)
patrón ^\d{4}-\d{2}-\d{2}$
ltecadena (fecha)
patrón ^\d{4}-\d{2}-\d{2}$
ltcadena (fecha)
patrón ^\d{4}-\d{2}-\d{2}$
typesstring[]
Tipos de propiedad, en minúsculas, p. ej. ["apartment", "penthouse"] o ["house", "villa"].
1–40 elementosmáximo 40 caracterespatrón ^[a-z][a-z_]*$
conditionsstring[]
Solo para España, Italia y Polonia: estado de la propiedad, cualquiera de estos valores: used, ruin, very-good, new, other.
used ruin very-good new other
De 1 a 5 elementos
with_mortgageboolean
Solo para España: true para compraventas financiadas con hipoteca, false para compraventas sin ella.
price_rangeobject
Precio de venta registrado en euros: {"gte": n, "lte": n} (o gt / lt); al menos un límite.
4 propiedades
gtenumber
≥ 0
gtnumber
≥ 0
ltenumber
≥ 0
ltnumber
≥ 0
price_per_sqm_rangeobject
Precio de venta registrado por metro cuadrado en euros: {"gte": n, "lte": n} (o gt / lt); al menos un límite.
4 propiedades
gtenumber
≥ 0
gtnumber
≥ 0
ltenumber
≥ 0
ltnumber
≥ 0
total_area_rangeobject
Built area in square metres: {"gte": n, "lte": n} (or gt / lt); at least one bound.
4 propiedades
gtenumber
≥ 0
gtnumber
≥ 0
ltenumber
≥ 0
ltnumber
≥ 0
plot_area_rangeobject
France and Poland only: plot area in square metres: {"gte": n, "lte": n} (or gt / lt); at least one bound.
4 propiedades
gtenumber
≥ 0
gtnumber
≥ 0
ltenumber
≥ 0
ltnumber
≥ 0
bedrooms_rangeobject
France only: bedrooms: {"gte": n, "lte": n} (or gt / lt); at least one bound.
4 propiedades
gteinteger
≥ 0
gtinteger
≥ 0
lteinteger
≥ 0
ltinteger
≥ 0

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/sales/time-series" \
  -H "Authorization: Bearer $CASAFARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "country": "ES",
  "location_boundary": {
    "location_ids": [
      11737
    ]
  },
  "sold_at_range": {
    "gte": "2024-01-01",
    "lte": "2025-12-31"
  }
}'

Respuestas

200 Success.

Tipo: object.

Example from a real call (any ids, addresses and links are illustrative) (long arrays shortened)
JSON
{
  "country": "ES",
  "prices": "registered_sale",
  "source": "Registered sale prices from Spanish notary deeds",
  "currency": "EUR",
  "interval": "week",
  "total_properties": 163141,
  "average_sold_price_series": [
    {
      "date": "2023-12-31",
      "value": 300043.78
    },
    {
      "date": "2024-01-07",
      "value": 316950.33
    }
  ],
  "average_sold_price_per_sqm_series": [
    {
      "date": "2023-12-31",
      "value": 3308.02
    },
    {
      "date": "2024-01-07",
      "value": 3395.07
    }
  ]
}

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.