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

Property Sourcing · Preguntas frecuentes

Property Sourcing: preguntas frecuentes

Respuestas a lo que los agentes, inversores, promotores y agentes de IA preguntan sobre Property Sourcing. Cada respuesta enlaza con la página que la documenta.

¿Cómo encuentro todas las propiedades en venta en una localidad que se ajusten a los criterios de mi cliente, sin duplicados?

Llame a POST /v1/property-sourcing/searches con los location_ids del municipio y sus filtros: cada resultado es un registro de propiedad del grafo inmobiliario de Casafari, deduplicado y depurado, de modo que una vivienda anunciada por varias agencias y portales aparece una sola vez.

Obtenga los ids desde GET /v1/locations/search (una búsqueda admite de 1 a 100 location_ids), luego añada operation (venta o alquiler), types, rangos para price, price_per_sqm, bedrooms, bathrooms, living_area_sqm y plot_area_sqm, además de features. El valor listings_count en cada resultado le indica cuántos lugares anuncian la propiedad. Las páginas contienen hasta 100 resultados (25 en la versión Free) y una búsqueda alcanza un máximo de 1.000 resultados (100 en la versión Free). Consulte Search properties y cómo se construye el grafo inmobiliario.

Sí: POST /v1/property-sourcing/searches/describe acepta hasta 20 tags o una description en texto libre, que se divide en frases mediante comas, puntos y coma y la conjunción «y», devolviendo los registros de propiedad coincidentes, cada uno con sus matched_tags.

Añada los location_ids del área y, opcionalmente, un rango de price o price_per_sqm. La descripción «vistas al mar, necesita reforma y cerca de la playa» se convierte en tres frases, y el campo matched_tags en cada resultado indica con cuál de ellas coincidió la propiedad, permitiéndole ordenar los resultados o explicar una coincidencia a un cliente. Cada página contiene hasta 100 resultados y cuesta 100 tokens. Consulte Search properties by description.

¿Qué propiedades en esta zona tienen el precio por metro cuadrado más bajo?

Busque en el área con POST /v1/property-sourcing/searches y sort: price_per_sqm_asc; los resultados se obtienen de menor a mayor precio por metro cuadrado, cada uno con price.per_sqm en un registro deduplicado por propiedad, de modo que la misma vivienda anunciada por varias agencias no aparece varias veces en la clasificación.

Acote la banda con un rango de price_per_sqm y living_area_sqm para que las propiedades muy pequeñas no saturen los primeros puestos de la lista. Un precio de 0 se devuelve como null, lo que significa que es bajo consulta, por lo que debe gestionar esas propiedades por separado. Para establecer un valor estimado frente al precio de venta, consulte Comparables and valuation; para ver cómo han evolucionado los precios en la zona, consulte Area insights. Referencia: Search properties.

¿Cuánto tiempo lleva esta propiedad en el mercado y cuál fue su precio inicial?

Utilice first_seen en cualquier resultado de búsqueda para saber cuándo apareció la propiedad por primera vez en el mercado, y GET /v1/property-sourcing/properties/{property_id}?expand=history para conocer sus cambios de precio y estado con fecha, que muestran los precios de venta anteriores, cada cambio y el estado actual.

El historial pertenece a un registro de propiedad que consolida todos los lugares donde se anuncia la vivienda, no al anuncio de una única agencia. El tiempo en el mercado es una variable real de negociación: en Francia, el tiempo medio para vender una propiedad fue de 83 días en febrero de 2025, 11 días más que un año antes, según The Connexion. La lectura de una propiedad cuesta 10 tokens. Véase Get a property.

Envíe el enlace a POST /v1/property-sourcing/properties/resolve: devuelve la propiedad a la que pertenece el enlace, y dado que cada propiedad es un registro único con un id (prop_…), dos enlaces que resuelven al mismo id son la misma vivienda.

Resolve acepta un enlace de portal o agencia, una referencia de agencia o un id de anuncio y cuesta 25 tokens. Con el id, GET /v1/property-sourcing/properties/{property_id}?expand=listings muestra cada lugar en el que se anuncia la propiedad con su agencia, URL, precio y estado, lo que explica por qué su cliente vio dos precios diferentes. Consulte Resolve a link or reference y el caso de uso Resolve client-forwarded links to one property record.

¿Cuántas agencias están anunciando esta propiedad y a qué precios?

El valor listings_count en cada resultado de búsqueda indica cuántos lugares anuncian la propiedad, y GET /v1/property-sourcing/properties/{property_id}?expand=listings devuelve cada uno de ellos con su fuente, agencia, URL, precio, estado y referencias.

Un registro de propiedad fusiona todos los lugares donde se anuncia la vivienda, por lo que comparar los precios entre agencias revela mandatos compartidos y diferencias de precio antes de llamar a nadie. La consulta cuesta 10 tokens, y expand=listings,history añade los cambios de precio y estado con fecha en la misma llamada. Consulte Get a property y el caso de uso Shared-mandate and competitor mapping for an office.

¿Puedo filtrar por características como licencia vacacional, o excluir propiedades alquiladas, con nuda propiedad o traspasos de negocio?

Sí: features conserva solo las propiedades con las características que especifique y exclude_features elimina las propiedades con características que no desee; ambos aceptan rental_license, rented_out, life_annuity y business_transfer.

El conjunto completo incluye balcony, elevator, garage, garden, parking, storage, swimming_pool, terrace, rental_license, furniture, no_elevator, rented_out, life_annuity, business_transfer y smoke_outlet. Un inversor en alquiler vacacional podría enviar features: ["rental_license", "terrace"] con exclude_features: ["rented_out", "life_annuity", "business_transfer"]. Esta documentación no especifica cómo se establece una licencia, por lo que debe verificarla con la autoridad competente antes de realizar la compra. Consulte Buscar anuncios y el caso de uso Filtro para inversores en alquiler vacacional con licencia turística.

¿Cuáles son las propiedades que han salido al mercado en mi zona durante esta semana?

Ejecute POST /v1/property-sourcing/searches con los location_ids de su área y sort: newest, y conserve los resultados cuya fecha first_seen sea posterior a su última comprobación; cada resultado es un registro de propiedad deduplicado, por lo que una vivienda anunciada por tres agencias distintas aparece una sola vez.

Almacene los ids prop_… que ya ha visto y compárelos en la siguiente ejecución. Si prefiere recibir alertas de nuevos anuncios, subidas y bajadas de precio, reservas, retiradas y ventas en lugar de consultar mediante polling, consulte Alertas. Referencia: Buscar anuncios; caso de uso: Resumen de nueva oferta para una zona agrícola.

¿La API devuelve el número de teléfono o el correo electrónico del vendedor?

No: Property Sourcing nunca devuelve los datos de contacto de un vendedor.

Un registro de propiedad contiene los atributos, la dirección, la descripción y el estado del inmueble, cada lugar donde se anuncia (fuente, agencia, URL, precio, estado, referencias) y su historial de precios y estados con fecha. Lo mismo se aplica a High Potential Seller Leads, que identifica propiedades y su comportamiento de precio, no a sus propietarios. Contactar con los propietarios es su responsabilidad bajo la legislación local, incluyendo el RGPD en la UE. Consulte Obtener una propiedad.

¿Funciona la misma solicitud para España, Francia, Italia, Alemania, Portugal y Grecia?

Sí: un cuerpo de petición funciona para cada país que cubre Property Sourcing, y el país se determina mediante el campo country, mediante el id de ubicación propio del país en location_ids o a través del único país configurado en su cuenta.

Los filtros, las claves de ordenación y la paginación son los mismos en todos los mercados. Property Sourcing cubre Andorra, Emiratos Árabes Unidos, Austria, Bélgica, Suiza, Alemania, España, Francia, Grecia, Italia, Luxemburgo, Mónaco, Polonia, Portugal, San Marino y Estados Unidos; a cuáles de estos puede acceder su cuenta depende de su plan. Consulte Buscar anuncios y el caso de uso Análisis de valor por m² en mercados europeos.

¿Cuántos resultados puede devolver una búsqueda y cómo se pagina?

Una búsqueda alcanza un máximo de 1.000 resultados (100 en el plan Free), en páginas de hasta 100 elementos (page_size, máximo 25 en Free), y puede obtener la siguiente página pasando el cursor de la búsqueda a GET /v1/property-sourcing/searches/{cursor}.

Un cursor (cur_…) es válido durante una hora y está vinculado a su cuenta, y no se almacena nada, por lo que debe volver a ejecutar la búsqueda si el cursor caduca. Cada página, ya sea la primera o las siguientes, cuesta 50 tokens. Para superar el límite de profundidad, divida un área extensa en varias búsquedas por id de ubicación o rango de precio. Consulte Siguiente página de una búsqueda.

¿Qué significa un precio de 0 en los resultados?

Un precio de 0 se devuelve como null e indica que el precio es bajo consulta.

Trátelo como un dato desconocido, no como gratuito: excluya dichas propiedades de los rankings de precio por m², etiquételas como "precio bajo consulta" en su selección, y consulte la propiedad con expand=listings para ver el precio registrado en cada lugar donde se anuncia. De lo contrario, el objeto price contiene amount, currency y per_sqm. Consulte Buscar anuncios.

¿Cuánto cuesta una búsqueda?

Una página de búsqueda cuesta 50 tokens, lo que equivale a 2 EUR a razón de 0,04 EUR por token; consultar una propiedad cuesta 10 tokens (0,40 EUR) y resolver un enlace o referencia cuesta 25 tokens (1 EUR).

Las páginas siguientes también cuestan 50 tokens por página; las búsquedas de descripción cuestan 100 tokens por página. Estos son precios de REST. En un asistente de IA mediante MCP, una página de hasta 10 viviendas cuesta 5 tokens, y la lectura de una propiedad o la resolución de un enlace, 2 tokens. Free incluye 1.000 tokens durante 30 días; el pago por uso utiliza créditos prepagados que se pueden adquirir a partir de 20 €; el plan Agent cuesta 49 € al mes (39 € al mes con facturación anual), Agency 249 € al mes y Business 990 € al mes; el consumo adicional se cubre mediante recargas de crédito. Cuando los créditos se agotan, se recibe un error 402 payment_required que contiene una upgrade_url. Consulte el resumen de REST.

¿Puede un agente de IA llamar a esta API directamente con la solicitud de un usuario?

Sí: Property Sourcing está diseñado para agentes de IA, y un agente puede enviar las palabras del usuario como tags o una description a POST /v1/property-sourcing/searches/describe, leer los detalles con GET /v1/property-sourcing/properties/{property_id} y resolver enlaces copiados con POST /v1/property-sourcing/properties/resolve.

Mediante MCP, añada https://platform.casafari.com/mcp/property-sourcing como conector personalizado en Claude o ChatGPT (o claude mcp add --transport http casafari-property-sourcing https://platform.casafari.com/mcp/property-sourcing en Claude Code): cuatro herramientas, property-sourcing_search, property-sourcing_next_page, property-sourcing_get_property y property-sourcing_resolve_listing, con los mismos precios en tokens que REST. Mediante REST, el agente aprende las operaciones de /openapi.json, /llms.txt y la versión Markdown (.md) de cada página del hub. Los errores siguen el estándar RFC 9457 problem+json, lo que permite al agente actuar ante un 402 payment_required (con una upgrade_url) o un 429 request_limit_reached (indicando la ventana). Consulte Buscar propiedades por descripción y el caso de uso Herramienta de propiedad fundamentada para un asistente de IA.

Casos de uso de Property Sourcing · Referencia REST

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