Resolve a link or reference to its property
POST
https://platform.casafari.com/v1/property-sourcing/properties/resolveAPI key25 units4 parameters
Send Authorization: Bearer $CASAFARI_API_KEY: a platform API key or OAuth access token; see platform sign-in. Costs 25 units (1 unit = EUR 0.04).
Over MCP: none; this product is REST only.
Description
Send exactly one of url (a portal or agency link to one home), reference (the reference an agency gives the home) or listing_id, and get back the property it belongs to, with its prop_ id. The country comes from country, else from the link's domain, else from the account's only country. 25 units.
Request body
Content type application/json. Required. Type: object.
urlstringAn http(s) link to one listing, on a portal or an agency website.
at most 2000 characters
referencestringThe listing's reference.
at most 100 characters
listing_idintegerA listing id.
≥ 1
countrystringISO 3166-1 alpha-2 code; read from the link's domain when left out.
Example request
Placeholders only: replace the token and the values with your own.
curl -X POST "https://platform.casafari.com/v1/property-sourcing/properties/resolve" \
-H "Authorization: Bearer $CASAFARI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://agency.example/listing/123",
"country": "ES"
}'Responses
200 The matching properties.
Type: object.
Show the response shape (20 fields)
resultsobject[]10 properties
idstringOpaque property id,
prop_....typestringnullableProperty type.
operationstringsale rentpriceobject3 properties
amountnumbernullableAsking price; null when the price is on request.
currencystringnullableISO 4217 currency code.
per_sqmnumbernullableAsking price per m².
bedroomsnumbernullableliving_area_sqmnumbernullablelocationobject3 properties
idintegernullableLocation id.
namestringnullableLocation name.
coordinatesobjectnullableLatitude and longitude.
2 properties
latnumberlonnumberfirst_seenstringnullableWhen the property came on the market for this operation.
listings_countintegernullableHow many listings advertise it; known on a property read with expand=listings, null in search results.
matched_tagsstring[]nullableThe phrases of a plain-language search this property matched; null for structured searches.
totalintegerExample with sample values (ids and figures are illustrative)
{
"results": [
{
"id": "prop_7Hq2pZk1vY0sW4nB8cR3tL",
"type": "apartment",
"operation": "sale",
"price": {
"amount": 425000,
"currency": "EUR",
"per_sqm": 4474
},
"bedrooms": 3,
"living_area_sqm": 95,
"location": {
"id": 12345,
"name": "Sample district",
"coordinates": {
"lat": 39.462,
"lon": -0.376
}
},
"first_seen": "2026-09-28",
"listings_count": null,
"matched_tags": null
}
],
"total": 1
}400 Not exactly one of url, reference or listing_id, or the country cannot be told (`invalid_request`).
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring401 Missing or unknown API key or token.
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring402 No units left to fund the call (`payment_required`).
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring403 The account is not entitled to this country (`not_entitled`).
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring404 No property matches (`not_found`).
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring