Platform

Casafari es la plataforma de inteligencia de datos inmobiliarios nativa para agentes de IA. El índice inmobiliario más completo de Europa: un grafo inmobiliario limpio y deduplicado de propiedades residenciales y comerciales, en venta y alquiler, en 16 países.El índice inmobiliario más completo de Europa: un grafo inmobiliario limpio y deduplicado.

Cómo se construye el grafo

REST API: una API inmobiliaria para agentes de IA y aplicaciones

The same data as the MCP tools, over HTTP: an API for AI agents whose code makes fixed requests, and for any app. To let a model choose the calls instead, use the MCP servers, or call them from the OpenAI API or the Claude API. The REST API is the platform's: https://platform.casafari.com/v1/<product>, one base per product, signed with the platform API key from your console and billed in tokens, the same key and the same tokens as the MCP servers. This reference is generated from the platform's own OpenAPI files (version 2026-10-31.1, vendored 2026-11-02): 37 operations in 9 sections, 7 of them products. Operations are grouped by product, the same way the MCP tools are; MCP and REST compared shows where the two overlap and where they do not. This reference lists the platform's routes only: Casafari clients with a contract who still call the old routes at https://api.casafari.com find them on the Legacy API page, each with its platform equivalent.

Platform API keys

Base URLhttps://platform.casafari.com: each product under /v1/<product> (/v1/property-sourcing, /v1/seller-leads, /v1/private-sellers, /v1/comparables, /v1/comparables-transactions, /v1/area-insights, /v1/parcel-zoning); place lookup under /v1/locations, your account under /v1/account
CredentialA platform API key (cf_sk_...) from the console, sent as Authorization: Bearer <api_key> or X-API-Key: <api_key>; or an OAuth access token as the bearer (MCP authorization). The key travels in a header, never in the query string.
FormatJSON requests and responses; errors as application/problem+json (RFC 9457): detail says how to fix it, code names the problem, request_id is what to quote to support
TokensEvery operation costs a fixed number of tokens (1 token = EUR 0.04); each operation's page says what it costs, and the file says it in x-casafari-units. Some cost less as MCP tool calls in an AI assistant: see Pricing. The response headers Casafari-Units-Charged and Casafari-Units-Remaining say what a call cost and what is left. When tokens run out the API answers 402 payment_required with an upgrade_url to top up.
PlansFree: 1,000 tokens for 30 days. Pay as you go: credits. Agent: EUR 49 a month, or EUR 39 a month billed yearly, with 1,500 tokens a month. Agency: EUR 249 a month, or EUR 199 a month billed yearly, with 10,000 tokens a month. Business: EUR 990 a month, or EUR 792 a month billed yearly, with 50,000 tokens a month. Custom: talk to Casafari. See Pricing and Limits: Free and the paid self-serve plans have request limits, such as distinct places a day.
OpenAPIOne file per product, the platform's own (see Download the OpenAPI description)

A first call, with the key in an environment variable ($CASAFARI_API_KEY in every example on this site is a placeholder, never a credential): Comparables, the platform's default product.

bash
curl -X POST "https://platform.casafari.com/v1/comparables/search" \
  -H "Authorization: Bearer $CASAFARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "comparables_count": 5,
  "location_boundary": {
    "circle": {
      "target_point": {
        "coordinates": {
          "latitude": 40.4168,
          "longitude": -3.7038
        }
      },
      "distance": 1
    }
  },
  "operation": "sale",
  "comparables_types": [
    "apartment"
  ]
}'

Most products take a location_id: get it first from GET /v1/locations/search (free). GET /v1/account (free) shows your plan and the tokens left.

Download the OpenAPI description

For Postman (Import → Link, paste the URL), Insomnia, code generators or an agent's tool loader. The platform's files are its own, one per product, public and served by the platform itself; the hub keeps a copy of each (vendored 2026-11-02, version 2026-10-31.1), which these pages are generated from.

Every product's platform routes in one file, every path on its own server, with examples filled in from real calls: /openapi.json covers every product; per product, /docs/rest/property-sourcing/openapi.json, /docs/rest/seller-leads/openapi.json, /docs/rest/private-sellers/openapi.json, /docs/rest/comparables-valuation/openapi.json, /docs/rest/comparables-with-transactions/openapi.json, /docs/rest/area-insights/openapi.json, /docs/rest/parcel-zoning/openapi.json, /docs/rest/locations/openapi.json, /docs/rest/account/openapi.json. The Legacy API's description is apart: /docs/existing-api-customers/openapi.json.

Operations by product

Property Sourcing

High Potential Seller Leads

Private Seller Leads

Comparables & Valuation

Comparables with Transactions

Area Insights

Parcel Zoning

Location Lookup

Cuenta y registro

Legacy API (api.casafari.com)

Already a Casafari API customer? Your token keeps working, and the existing API's reference is now on this site. Log in to your API account to see your token.

Using the old api.casafari.com routes? See Legacy API. The old routes at https://api.casafari.com (39 operations, sign-in included) are listed there by product, each with the platform route that replaces it, with how to sign in and the old API's own OpenAPI description. A platform API key does not work there, and an old token does not work on the platform.

Status codes

Every operation documents its own responses. Across the platform's operations:

StatusMeaningOperations that can return it
200OK35
201Created1
202Accepted1
400Solicitud incorrecta36
401No autorizado34
402payment_required (https://platform.casafari.com/errors/payment-required)25
403Prohibido34
404No encontrado36
405method_not_allowed (https://platform.casafari.com/errors/method-not-allowed)37
409Conflict15
413payload_too_large (https://platform.casafari.com/errors/payload-too-large)15
415unsupported_media_type (https://platform.casafari.com/errors/unsupported-media-type)15
422Error de validación15
429Too Many Requests36
500internal_error (https://platform.casafari.com/errors/internal-error)37
502upstream_error (https://platform.casafari.com/errors/upstream-error)32
503capacity_exhausted, unavailable (https://platform.casafari.com/errors/capacity-exhausted, https://platform.casafari.com/errors/unavailable)37
504upstream_timeout (https://platform.casafari.com/errors/upstream-timeout)32

Read this reference as Markdown

Add .md to any page's URL, or send Accept: text/markdown. /llms.txt lists every operation next to every MCP tool.

Preguntas sobre esto

Consejo: añada .md a cualquier URL para leerla como Markdown.