Private Seller Leads · REST API
Search private-seller listings by place and date
https://platform.casafari.com/v1/private-sellers/searchSend 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 10 tokens a call (1 token = EUR 0.04).
The platform's OpenAPI file leaves the shape open; what is shown comes from the same definitions the platform publishes elsewhere: request: the MCP tool private-sellers_search's input; response 200: the hub's fragment from the platform's contract.
Over MCP: private-sellers_search (equivalent). See MCP and REST compared.
Description
Costs 10 tokens a call. Each page is a call. Page size: page_size in the body, at most 50 (a Free plan account is capped lower).
Request body
Content type application/json. Optional. Type: object.
location_idintegerrequiredsincestringrequired^\d{4}-\d{2}-\d{2}$untilstring^\d{4}-\d{2}-\d{2}$operationstringsale rentproperty_typestring^[a-z_]{1,32}$confirmed_onlybooleanpage_sizeintegercursorstringExample request
Replace the key with your own. Run on the platform before publishing: copy it, put in your key, and it works.
curl -X POST "https://platform.casafari.com/v1/private-sellers/search" \
-H "Authorization: Bearer $CASAFARI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"location_id": 11737,
"since": "2026-10-01"
}'Responses
200 Success.
Type: object.
Show the response shape (23 fields)
listingsobject[]requiredpage_size listings, newest first.15 properties
idstringrequiredpsl_ id, for GET /v1/private-sellers/listings/{id}.urlstringrequiredportalstringrequiredfirst_seenstringrequiredoperationstringrequiredsale rentproperty_typestringrequiredapartment or house.pricenumberrequiredcurrencystringrequiredareanumberrequiredbedroomsintegerrequiredbathroomsintegerrequiredlocation_idintegerrequiredcoordinatesobjectrequired2 properties
latnumberlonnumbertitlestringrequiredcontactobjectrequired3 properties
namestringrequiredphonestringrequiredemailstringrequirednextstringrequiredcursor. Null on the last page.contacts_includedbooleanrequiredExample with sample values (ids and figures are illustrative)
{
"listings": [
{
"id": "psl_MjAwMDAwMDAwMDAx",
"url": "https://portal.example/listing/000000001",
"portal": "Sample portal",
"first_seen": "2026-11-04",
"operation": "sale",
"property_type": "apartment",
"price": 389000,
"currency": "EUR",
"area": 85,
"bedrooms": 3,
"bathrooms": 2,
"location_id": 11737,
"coordinates": {
"lat": 40.434,
"lon": -3.704
},
"title": "Piso de 3 dormitorios en Chamberí, vendo sin agencia",
"contact": {
"name": "María",
"phone": "+34 600 000 001",
"email": null
}
},
{
"id": "psl_MjAwMDAwMDAwMDAy",
"url": "https://portal.example/listing/000000002",
"portal": "Sample portal",
"first_seen": "2026-11-03",
"operation": "rent",
"property_type": "apartment",
"price": 1450,
"currency": "EUR",
"area": 62,
"bedrooms": 2,
"bathrooms": 1,
"location_id": 11737,
"coordinates": {
"lat": 40.389,
"lon": -3.701
},
"title": "Alquilo piso luminoso con terraza en Arganzuela",
"contact": {
"name": null,
"phone": "+34 600 000 002",
"email": "propietario.madrid@example.com"
}
}
],
"next": "cur_kT4sQ8vN2mX7pR1wZ6yB3cH9",
"contacts_included": true
}Errors
Every error is an application/problem+json body (RFC 9457) with type (a page that explains it), title, status, detail (what to do), instance, code and request_id (what to quote to support). A 402 carries an upgrade_url, a 429 a Retry-After header. The codes each status can carry:
- 400
invalid_request,key_in_query,page_depth_exceeded(https://platform.casafari.com/errors/invalid-request, https://platform.casafari.com/errors/key-in-query, https://platform.casafari.com/errors/page-depth-exceeded) - 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)