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

Claro AI · REST API

Get one premises

GEThttps://platform.casafari.com/v1/claro/premises/{id}
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 GET https://platform.casafari.com/v1/claro/premises/{id}; GET /v1/premises/{id} 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: get_premises (equivalent). MCP and REST compared.

Description

One premises in full by the id a search returned: its data, facts read from its text with the sentence each came from (fact_sources), its coordinates (exact, or approximate: snapped to a ~500 m cell), location figures (with location access), an excerpt, up to 8 photos (photos: Casafari thumbnail URLs; search results carry the first 4, and photo_source names the advertiser and page they come from), and the agency (agency.name) with its own listing page as agency.listing_url, null when the agency has no page of its own (agency_links lists every agency's own page for the premises, earliest first; none is a property portal's). energy is the energy certificate as the ad advertises it, unverified: not checked against the official register (rating and emissions rating A to G, kWh/m² and kg CO2/m² a year, each null when not stated; null until read); energy.official is the regional register's certificate, only when it is matched on this unit and declares commercial use, with the register and the attribution its licence asks for (else null). status says whether it is still on the market. timeline gives when it was first listed (listed_since, days_listed) and, per live operation, the first and current asking price, the number of price cuts, the change in percent and the asking-price periods (history); null fields are not stated.

Parámetros de ruta

idstringobligatorio

Parámetros de consulta

insightsstring
1 adds insights: the page's charts as data.
1
segmentsstring
Comma-separated business kinds to list first in the distances chart, e.g. burger,coffee.
assessmentstring
With insights=1: 1 adds site_assessment first in insights (see the get_premises tool's assessment).
1
langstring
Idioma del texto que genera la respuesta (títulos, notas, etiquetas, motivos, mensajes de error): en (predeterminado) o de (alemán). Los nombres de lugares, nombres de agencias, títulos de propiedades y citas del texto propio de un anuncio permanecen tal como están escritos.
en de
por defecto "en"

Ejemplo de solicitud

Solo marcadores de posición: reemplace el token y los valores por los suyos.

curl
curl "https://platform.casafari.com/v1/claro/premises/<id>" \
  -H "Authorization: Bearer $CASAFARI_API_KEY"

Respuestas

200 Get one premises

Sin cuerpo.

400 Solicitud no válida

Tipo: object.

Mostrar la estructura de la respuesta (3 campos)
errorobject
2 propiedades
codestringobligatorio
messagestringobligatorio

401 Clave faltante o no válida

Tipo: object.

Mostrar la estructura de la respuesta (3 campos)
errorobject
2 propiedades
codestringobligatorio
messagestringobligatorio

403 Sin acceso

Tipo: object.

Mostrar la estructura de la respuesta (3 campos)
errorobject
2 propiedades
codestringobligatorio
messagestringobligatorio

429 Límite de peticiones alcanzado

Tipo: object.

Mostrar la estructura de la respuesta (3 campos)
errorobject
2 propiedades
codestringobligatorio
messagestringobligatorio

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