Platform

Η Casafari είναι η πλατφόρμα ευφυΐας δεδομένων ακινήτων για AI πράκτορες. Ο πληρέστερος δείκτης ακινήτων στην Ευρώπη: ένας αποδιπλότυπος, καθαρισμένος γράφος ακινήτων για οικιστικά και εμπορικά ακίνητα, προς πώληση και προς ενοικίαση, σε 16 χώρες.Ο πληρέστερος δείκτης ακινήτων στην Ευρώπη: ένας αποδιπλότυπος, καθαρισμένος γράφος ακινήτων.

Πώς δομείται ο γράφος

Claro AI · REST API

Export the results of a search you ran as CSV or Excel

POSThttps://platform.casafari.com/v1/claro/exports
API key5 parameters

Send Authorization: Bearer $CASAFARI_API_KEY: a platform API key or OAuth access token, metered in platform tokens; see platform sign-in and Claro AI. On the platform this is POST https://platform.casafari.com/v1/claro/exports; POST /v1/exports 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: no tool does this. MCP and REST compared.

Description

The stored results of a search this account ran, or of a Compare set, as a file. Scope claro:read. It only re-reads: never a new search, a model call or a read-through, so it is not billed as a search (the platform prices it at 0 tokens) and has no monthly cap. search_id exports that search's ranked matches (the first 500; stated_only keeps only those that state every criterion). A plots search_id (it starts with plots-) exports its plots with their own columns. search_id with ids exports only those 2 to 5 matches of that search. ids alone exports a Compare set this account ran with POST /v1/compare in the last 24 hours, the same ids and no others. A search_id that does not belong to the calling account, never existed or is older than 24 hours (searches are kept 24 hours) is not_found (404); the answer never says which. Columns: property id (pm_), Claro page, title, type, operation, size m², rent and sale price, price per m², city, district, agency and its listing link, the fit verdict and its reasons, an excerpt, and the Location Intelligence figures only when the account has location access. A header above the table gives the export date and the source.

Σώμα αιτήματος

Τύπος περιεχομένου application/json. Υποχρεωτικό. Τύπος: object.

search_idstring
The search_id of a premises or plots search this account ran in the last 24 hours.
formatstringαπαιτείται
csv xlsx
idsstring[]
pm_ ids: with search_id, only those matches of that search; alone, a Compare set this account ran in the last 24 hours.
2–5 items
stated_onlyboolean
With a premises search_id: only the matches that state every criterion.
langstring
The language of the file's headings.
en de es

Παράδειγμα αιτήματος

Μόνο placeholders: αντικαταστήστε το token και τις τιμές με τα δικά σας.

curl
curl -X POST "https://platform.casafari.com/v1/claro/exports" \
  -H "Authorization: Bearer $CASAFARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "format": "csv"
}'

Αποκρίσεις

200 The file

Type: string.

400 Μη έγκυρο αίτημα

Τύπος: object.

Εμφάνιση της δομής της απόκρισης (3 πεδία)
errorobject
2 ιδιότητες
codestringαπαιτείται
messagestringαπαιτείται

401 Κλειδί που λείπει ή δεν είναι έγκυρο

Τύπος: object.

Εμφάνιση της δομής της απόκρισης (3 πεδία)
errorobject
2 ιδιότητες
codestringαπαιτείται
messagestringαπαιτείται

403 Χωρίς πρόσβαση

Τύπος: object.

Εμφάνιση της δομής της απόκρισης (3 πεδία)
errorobject
2 ιδιότητες
codestringαπαιτείται
messagestringαπαιτείται

404 Unknown, expired or not this account's (`not_found`)

Τύπος: object.

Εμφάνιση της δομής της απόκρισης (3 πεδία)
errorobject
2 ιδιότητες
codestringαπαιτείται
messagestringαπαιτείται

429 Υπέρβαση ορίου ρυθμού κλήσεων

Τύπος: object.

Εμφάνιση της δομής της απόκρισης (3 πεδία)
errorobject
2 ιδιότητες
codestringαπαιτείται
messagestringαπαιτείται

Συμβουλή: προσθέστε .md σε οποιοδήποτε URL για να το διαβάσετε ως Markdown.