Platform

Casafari is the AI agent-native real estate data intelligence platform. The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries.The most complete property index in Europe: a deduplicated, cleaned property graph.

How the graph is built

Private Seller Leads · REST API

Search private-seller listings by place and date

POSThttps://platform.casafari.com/v1/private-sellers/search
API key10 tokens a call8 parameters

Send 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_idintegerrequired
Location id of a country, city, district or neighbourhood, from locations_search (Location Lookup).
≥ 1
sincestringrequired
Only listings first seen on or after this date, YYYY-MM-DD, at most 90 days back.
pattern ^\d{4}-\d{2}-\d{2}$
untilstring
Only listings first seen on or before this date, YYYY-MM-DD. Optional.
pattern ^\d{4}-\d{2}-\d{2}$
operationstring
Homes for sale or for rent. Optional: both.
sale rent
property_typestring
Property type group, lower case, e.g. "apartment" or "house". Optional.
pattern ^[a-z_]{1,32}$
confirmed_onlyboolean
true: only listings whose private seller is confirmed. Default false.
page_sizeinteger
Listings per page, 1 to 50 (default 20). Every page costs the same.
1–50
cursorstring
The next value of the previous page, as it came. Valid for an hour. Leave out for the first page.
1–4096 characters

Example request

Replace the key with your own. Run on the platform before publishing: copy it, put in your key, and it works.

curl
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[]required
Up to page_size listings, newest first.
15 properties
idstringrequired
The listing's psl_ id, for GET /v1/private-sellers/listings/{id}.
urlstringrequired
The listing's page on the portal.
portalstringrequired
The portal the listing was found on.
first_seenstringrequired
The date the listing was first seen, YYYY-MM-DD.
operationstringrequired
For sale or for rent.
sale rent
property_typestringrequired
Property type group, e.g. apartment or house.
pricenumberrequired
Asking price (a month's rent for a rental); null when the listing gives none.
currencystringrequired
Currency of the price, ISO 4217.
areanumberrequired
Living area in square metres, else total area.
bedroomsintegerrequired
Number of bedrooms; null when the listing gives none (a studio, for example).
bathroomsintegerrequired
Number of bathrooms.
location_idintegerrequired
The listing's location id (Location Lookup).
coordinatesobjectrequired
Rounded to 3 decimals (about 100 metres), never the exact address.
2 properties
latnumber
lonnumber
titlestringrequired
The listing's title as the seller wrote it, in the portal's language.
contactobjectrequired
The seller's contact as published on the portal; each field null where the portal shows none.
3 properties
namestringrequired
The seller's name; null when the portal shows only a word such as "Particular".
phonestringrequired
The seller's phone number, as published.
emailstringrequired
The seller's email address, as published.
nextstringrequired
Cursor of the next page (valid one hour): send it as cursor. Null on the last page.
contacts_includedbooleanrequired
true: every listing carries the seller's published contact.
Example with sample values (ids and figures are illustrative)
JSON
{
  "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:

Tip: add .md to any URL to read it as Markdown.