Price distribution in an area
https://platform.casafari.com/v1/area-insights/distributions/pricesSend 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 25 tokens a call (1 token = EUR 0.04). In an AI assistant, the same call as an MCP tool costs 5 tokens a call.
El archivo OpenAPI de la plataforma no define la forma; lo que se muestra proviene de las mismas definiciones que la plataforma publica en otros lugares: request: la descripción del mismo backend; response 200: la descripción del mismo backend.
Over MCP: area-insights_get_price_distribution (equivalent). See MCP and REST compared.
Description
Cuesta 25 tokens por llamada.
Cuerpo de la solicitud
Content type application/json. Opcional. Tipo: object.
typesstring[]obligatorio42 valores permitidos
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 retail office industrial warehouse hotel building other_commercial restaurant werkstatt urban_plot rural_plot room parking garage other apartment_building office_building mix_use_building 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, other.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
Sustituya la clave por la suya. Ejecútelo en la plataforma antes de publicarlo: cópiela, inserte su clave y funcionará.
curl -X POST "https://platform.casafari.com/v1/area-insights/distributions/prices" \
-H "Authorization: Bearer $CASAFARI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"types": [
"apartment"
],
"business_type": "sale",
"custom_location_boundary": {
"location_ids": [
11737
]
}
}'Respuestas
200 Success.
Tipo: object[].
Mostrar la estructura de respuesta (4 campos)
lower_boundintegerobligatorioupper_boundintegerobligatorioproperties_countintegerobligatoriois_meanbooleanobligatorioEjemplo de una llamada real (Madrid, pisos en venta) (arrays largos abreviados)
[
{
"lower_bound": 1,
"upper_bound": 50001,
"properties_count": 10,
"is_mean": false
},
{
"lower_bound": 50001,
"upper_bound": 100001,
"properties_count": 39,
"is_mean": false
}
]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:
- 400
invalid_request,key_in_query(https://platform.casafari.com/errors/invalid-request, https://platform.casafari.com/errors/key-in-query) - 401
unauthorized,invalid_credential,credential_revoked,token_expired(https://platform.casafari.com/errors/unauthorized, https://platform.casafari.com/errors/invalid-credential, https://platform.casafari.com/errors/credential-revoked, https://platform.casafari.com/errors/token-expired) - 402
payment_required(https://platform.casafari.com/errors/payment-required) - 403
insufficient_scope,not_entitled,account_suspended(https://platform.casafari.com/errors/insufficient-scope, https://platform.casafari.com/errors/not-entitled, https://platform.casafari.com/errors/account-suspended) - 404
not_found(https://platform.casafari.com/errors/not-found) - 405
method_not_allowed(https://platform.casafari.com/errors/method-not-allowed) - 409
conflict(https://platform.casafari.com/errors/conflict) - 413
payload_too_large(https://platform.casafari.com/errors/payload-too-large) - 415
unsupported_media_type(https://platform.casafari.com/errors/unsupported-media-type) - 422
validation_failed(https://platform.casafari.com/errors/validation-failed) - 429
rate_limited,daily_limit_reached,request_limit_reached,usage_limit_reached(https://platform.casafari.com/errors/rate-limited, https://platform.casafari.com/errors/daily-limit-reached, https://platform.casafari.com/errors/request-limit-reached, https://platform.casafari.com/errors/usage-limit-reached) - 500
internal_error(https://platform.casafari.com/errors/internal-error) - 502
upstream_error(https://platform.casafari.com/errors/upstream-error) - 503
capacity_exhausted,unavailable(https://platform.casafari.com/errors/capacity-exhausted, https://platform.casafari.com/errors/unavailable) - 504
upstream_timeout(https://platform.casafari.com/errors/upstream-timeout)