Compare premises
https://platform.casafari.com/v1/claro/compareSend Authorization: Bearer $CASAFARI_API_KEY: a platform API key or OAuth access token, metered in platform units; see platform sign-in and Claro AI. On the platform this is POST https://platform.casafari.com/v1/claro/compare; POST /v1/compare is Claro's own path, which the platform adds /claro to. The platform forwards the call to Claro unchanged: Claro's Claro-Version header and its error bodies ({"error":{"code","message"}}, with rate_limited and quota_reached on a 429) pass through.
Over MCP: compare_premises (equivalent). MCP and REST compared.
Description
2 to 10 premises side by side, by the ids a search returned.
Request body
Content type application/json. Required. Type: object.
idsstring[]requiredExample request
Placeholders only: replace the token and the values with your own.
curl -X POST "https://platform.casafari.com/v1/claro/compare" \
-H "Authorization: Bearer $CASAFARI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"<ids>"
]
}'Responses
200 Compare premises
No body.
Example from the API description
{
"premises": [
{
"id": "pm_3kX9vQ2LmT8a",
"title": "Local comercial en esquina",
"type": "retail",
"city": "madrid",
"city_name": "Madrid",
"district": "Centro",
"address": null,
"location_precision": "approximate",
"coordinates": {
"lat": 40.42,
"lon": -3.705,
"precision": "approximate"
},
"for_rent": true,
"for_sale": false,
"rent_eur_month": 5000,
"sale_eur": null,
"area_m2": 200,
"floor_number": 0,
"street_level": true,
"floors": 1,
"frontage_m": null,
"smoke_outlet": true,
"business_transfer": false,
"criteria": [
{
"criterion": "smoke_extraction",
"status": "met",
"evidence": "con salida de humos"
}
],
"photos": [
"https://st2.retelligence.co/c/1234/c/de/abcde350.jpg"
],
"excerpt": "Local en esquina con salida de humos. Zona de mucho paso.",
"agency": {
"name": "Agencia Sol",
"listing_url": "https://agenciasol.es/1"
}
}
],
"missing": []
}400 Invalid request
Type: object.
Show the response shape (3 fields)
errorobject2 properties
codestringrequiredmessagestringrequired401 Missing or invalid key
Type: object.
Show the response shape (3 fields)
errorobject2 properties
codestringrequiredmessagestringrequired403 No access
Type: object.
Show the response shape (3 fields)
errorobject2 properties
codestringrequiredmessagestringrequired429 Rate limited
Type: object.
Show the response shape (3 fields)
errorobject2 properties
codestringrequiredmessagestringrequired