Bedrooms Distribution
POST
https://api.casafari.com/market-analytics-api/distributions/bedroomsBearer token44 parameters
Send Authorization: Bearer $CASAFARI_TOKEN; see how to get a token.
Over MCP: ma_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.
Request body
Content type application/json. Required. Type: object.
typesstring[]requiredThe 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. The list of property types specific to certain countries: apartment: ○ dachgeschosswohnung: Germany ○ etagenwohnung: Germany ○ erdgeschosswohnung: Germany house: ○ family_house: Germany ○ reihenhaus: Germany ○ reihenendhaus: Germany ○ reihenmittelhaus: Germany ○ einfamilienhaus: Germany ○ zweifamilienhaus: Germany ○ landwirtschaftliche_betriebe: Germany
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_developmentat least 1 item
business_typestringrequiredsale rentprice_rangeobjectnullable2 properties
minintegernullable1–2147483647
maxintegernullable1–2147483647
price_per_sqm_rangeobjectnullable2 properties
minintegernullable1–2147483647
maxintegernullable1–2147483647
rooms_rangeobjectnullable2 properties
minintegernullable1–15000
maxintegernullable1–15000
bedrooms_rangeobjectnullable2 properties
minintegernullable0–10
maxintegernullable0–10
bathrooms_rangeobjectnullable2 properties
minintegernullable1–15000
maxintegernullable1–15000
total_area_rangeobjectnullable2 properties
minintegernullable1–1000000
maxintegernullable1–1000000
plot_area_rangeobjectnullable2 properties
minintegernullable1–1000000
maxintegernullable1–1000000
construction_year_rangeobjectnullable2 properties
minintegernullable1–3000
maxintegernullable1–3000
characteristicsobjectnullable2 properties
must_havestring[]Include only properties that have all these characteristics.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityexcludestring[]Exclude properties that contain any of these characteristics.
balcony elevator no_elevator garage garden parking storage swimming_pool terrace rental_license furniture rented_out life_annuityconditionsstring[]Property conditions, as returned by the GET /api/v1/references/conditions endpoint.
used ruin very-good new otherat least 1 item
privatebooleanWhether the property is listed by a private individual, as opposed to an agent or a professional.
bankbooleanWhether the property is owned by the bank.
auctionbooleanWhether the property is the subject of an auction.
default false
exclude_outliersbooleanExclude properties that are significantly underpriced or overpriced compared to similar properties.
default false
custom_location_boundaryobjectrequired3 properties
location_idsinteger[]List of location IDs.
1–10 items1–2147483647
polygonobject[]List of geo-points to search within. Polygon must contain at least 4 points. First and last points must match.
at least 4 items
2 properties
latitudenumberrequired-90–90
longitudenumberrequired-180–180
circleobjectCircle boundary to search within.
2 properties
distanceintegerrequiredMaximum distance in meters from the requested
target_point to the properties.50–50000
target_pointobjectrequiredTarget point coordinates to search around.
2 properties
latitudenumberrequired-90–90
longitudenumberrequired-180–180
Example request
Placeholders only: replace the token and the values with your own.
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": [
1
]
}
}'Responses
200 Successful Response
Type: object[].
Show the response shape (4 fields)
bedroomsstringrequiredThe number of bedrooms in the properties that participated in the distribution.
properties_countintegerrequiredThe number of properties that participated in the distribution.
average_pricenumberrequiredAverage price of properties with a specific number of bedrooms.
average_price_per_sqmnumberrequiredAverage price per square meter of properties with a specific number of bedrooms.
204 No Content
No body.
400 Bad Request
Type: object.
Show the response shape (3 fields)
messagestringrequirederrorsstring[]nullabledetailsstringnullable422 Validation Error
Type: object.
Show the response shape (6 fields)
detailobject[]5 properties
loc(string | integer)[]requiredmsgstringrequiredtypestringrequiredinputanyctxobject