Bedrooms Distribution
https://api.casafari.com/market-analytics-api/distributions/bedroomsEn 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[]obligatorioapartment 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_developmentbusiness_typestringobligatoriosale rentprice_rangeobjectnullable2 propiedades
minintegernullablemaxintegernullableprice_per_sqm_rangeobjectnullable2 propiedades
minintegernullablemaxintegernullablerooms_rangeobjectnullable2 propiedades
minintegernullablemaxintegernullablebedrooms_rangeobjectnullable2 propiedades
minintegernullablemaxintegernullablebathrooms_rangeobjectnullable2 propiedades
minintegernullablemaxintegernullabletotal_area_rangeobjectnullable2 propiedades
minintegernullablemaxintegernullableplot_area_rangeobjectnullable2 propiedades
minintegernullablemaxintegernullableconstruction_year_rangeobjectnullable2 propiedades
minintegernullablemaxintegernullablecharacteristicsobjectnullable2 propiedades
must_havestring[]balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityexcludestring[]balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityconditionsstring[]used ruin very-good new otherprivatebooleanbankbooleanauctionbooleanexclude_outliersbooleancustom_location_boundaryobjectobligatorio3 propiedades
location_idsinteger[]polygonobject[]2 propiedades
latitudenumberobligatoriolongitudenumberobligatoriocircleobject2 propiedades
distanceintegerobligatoriotarget_point solicitado hasta los inmuebles.target_pointobjectobligatorio2 propiedades
latitudenumberobligatoriolongitudenumberobligatorioEjemplo de solicitud
Solo marcadores de posición: reemplace el token y los valores por los suyos.
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)
bedroomsstringobligatorioproperties_countintegerobligatorioaverage_pricenumberobligatorioaverage_price_per_sqmnumberobligatorioEjemplo de una llamada real (Madrid, pisos en venta) (arrays largos abreviados)
[
{
"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)
messagestringobligatorioerrorsstring[]nullabledetailsstringnullable422 Error de validación
Tipo: object.
Mostrar la estructura de respuesta (6 campos)
detailobject[]5 propiedades
loc(string | integer)[]obligatoriomsgstringobligatoriotypestringobligatorioinputanyctxobject