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

Bedrooms Distribution

POSThttps://api.casafari.com/market-analytics-api/distributions/bedrooms
Token Bearer44 parámetros

En la API existente en https://api.casafari.com (clientes con contrato): envíe Authorization: Bearer $CASAFARI_TOKEN; consulte cómo obtener un token. Usuarios nuevos: la API REST de la plataforma, claves de API de la plataforma.

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

Description

Returns property distribution based on the number of bedrooms.

Each distribution unit includes the bedroom count, number of matching properties, and related analysis.

Cuerpo de la solicitud

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

typesstring[]obligatorio
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"] development: ["apartment_development", "house_development"] 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.
apartment 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 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–10
maxintegernullable
0–10
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 conservación de la propiedad, tal y como los devuelve el endpoint GET /api/v1/references/conditions.
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

Solo marcadores de posición: reemplace el token y los valores por los suyos.

curl
curl -X POST "https://api.casafari.com/market-analytics-api/distributions/bedrooms" \
  -H "Authorization: Bearer $CASAFARI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "types": [
    "apartment"
  ],
  "business_type": "sale",
  "custom_location_boundary": {
    "location_ids": [
      11737
    ]
  }
}'

Respuestas

200 Respuesta correcta

Tipo: object[].

Mostrar la estructura de respuesta (4 campos)
bedroomsstringobligatorio
The number of bedrooms in the properties that participated in the distribution.
properties_countintegerobligatorio
Número de inmuebles que participaron en la distribución.
average_pricenumberobligatorio
Average price of properties with a specific number of bedrooms.
average_price_per_sqmnumberobligatorio
Average price per square meter of properties with a specific number of bedrooms.
Ejemplo de una llamada real (Madrid, pisos en venta) (arrays largos abreviados)
JSON
[
  {
    "bedrooms": "0",
    "properties_count": 0,
    "average_price": 0,
    "average_price_per_sqm": 0
  },
  {
    "bedrooms": "1",
    "properties_count": 2313,
    "average_price": 412966,
    "average_price_per_sqm": 7111
  }
]

204 Sin contenido

Sin cuerpo.

400 Solicitud incorrecta

Tipo: object.

Mostrar la estructura de la respuesta (3 campos)
messagestringobligatorio
errorsstring[]nullable
detailsstringnullable

422 Error de validación

Tipo: object.

Mostrar la estructura de respuesta (6 campos)
detailobject[]
5 propiedades
loc(string | integer)[]obligatorio
msgstringobligatorio
typestringobligatorio
inputany
ctxobject

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