Dati immobiliari, API e MCP per portali, PropTech, CRM e agenti IA
I team di prodotto e ingegneria di portali immobiliari, gestionali e PropTech integrano ricerca di immobili deduplicati, risoluzione di link e assistenti IA senza costruire pipeline di scraping. Con un unico grafo che unifica gli annunci pubblicati da circa 50.000 agenzie in un unico record per immobile, l'accesso avviene tramite REST API e Casafari MCP, coprendo anche gli immobili commerciali negli Stati Uniti con Claro AI.
Come integrare la ricerca immobiliare deduplicata nella propria applicazione senza costruire pipeline di scraping?
I software gestionali e le applicazioni PropTech consentono ai professionisti di individuare subito le migliori opportunità senza disperdersi tra annunci duplicati. Nel mercato italiano, monitorato anche dalle 416 aziende censite dall'Italian PropTech Monitor del Politecnico di Milano, la prassi degli incarichi non in esclusiva fa sì che uno stesso appartamento a Milano o a Roma compaia contemporaneamente su Immobiliare.it, Idealista.it, Casa.it e Subito.it con superfici, foto e prezzi differenti. Nonostante nel 2025 si siano registrate 766.757 compravendite residenziali secondo il Rapporto Immobiliare 2026 dell'Osservatorio del Mercato Immobiliare (OMI), raccogliere manualmente queste informazioni genera duplicati nei CRM ed errori nelle valutazioni.
Anziché sviluppare e mantenere costose infrastrutture di scraping, le squadre di sviluppo interrogano Property Sourcing mediante la CASAFARI Property Data API. Effettuando una richiesta POST /api/v2/properties/search oppure inviando query in linguaggio naturale tramite POST /v1/property-sourcing/searches/describe, l'applicazione riceve un unico record deduplicato per ciascun immobile (prop_...). A livello europeo, CASAFARI traccia 7 volte più annunci pubblicitari rispetto ai singoli oggetti immobiliari e individua almeno il 40% in più di immobili deduplicati. Ogni scheda restituisce tutti gli annunci attivi e storici, le variazioni del prezzo richiesto (senza mai confonderlo con il prezzo effettivo di transazione) e i giorni di permanenza sul mercato. Per approfondire l'implementazione, è disponibile la documentazione tecnica sulla ricerca immobiliare via API per la tua app (in inglese).
Come ricondurre l'ID di un annuncio o il link inoltrato da un cliente a un'unica scheda immobile?
Agenti e clienti scambiano quotidianamente link da portali o codici riferimento tramite WhatsApp ed e-mail. Quando un cliente invia una scheda per sapere se l'immobile sia presente altrove a un prezzo inferiore, o quando un agente importa annunci nel gestionale, la presenza di schede duplicate compromette l'efficienza operativa.
Attraverso l'endpoint POST /api/v1/properties/match-by-listings, i sistemi integrati convertono elenchi massivi di ID annuncio dei portali nell'unico identificatore di proprietà di CASAFARI. Quando l'utente incolla un URL o un riferimento testuale, l'endpoint POST /v1/property-sourcing/properties/resolve individua la proprietà corrispondente. Consultate la guida all'abbinamento degli annunci a un unico immobile con match-by-listings (in inglese) e il caso d'uso sulla risoluzione dei link inoltrati dai clienti (in inglese) per comprendere il flusso di chiamata.
L'applicazione visualizza così la cronologia dei ribassi di prezzo richiesto, la data della prima pubblicazione e tutti i portali su cui l'oggetto è presente. Inoltre, le agenzie che collaborano sulla rete di condivisione delle notizie immobiliari possono sfruttare le API di CASAFARI Connect, approfondite nella documentazione API di CASAFARI Connect (in inglese).
Come collegare assistenti IA e server MCP a dati immobiliari verificati?
Gli assistenti conversazionali e i co-pilot per il settore immobiliare necessitano di dati certi per evitare allucinazioni su prezzi, disponibilità e metrature. Per ancorare le risposte dei modelli linguistici a dati reali, l'API mette a disposizione quattro strumenti REST descritti nella specifica OpenAPI (platform.casafari.com/v1/<product>/openapi.json), nel file tools.json e indicizzati nel file llms.txt:
- Individuazione del luogo:
GET /v1/locations/search(0 tokens). - Ricerca in linguaggio naturale:
POST /v1/property-sourcing/searches/describe. - Dettaglio e cronologia:
GET /v1/property-sourcing/properties/{property_id}?expand=listings,history. - Risoluzione di link incollati:
POST /v1/property-sourcing/properties/resolve.
Non è necessario installare alcun SDK npm o PyPI. Gli sviluppatori possono consultare le specifiche per creare uno strumento immobiliare ancorato ai dati per un assistente IA (in inglese) o collegare client come Claude Code, Cursor, ChatGPT o Gemini CLI direttamente al server Casafari MCP per gli agenti IA. Per un confronto architetturale, consultate la nostra guida su cosa costruire con l'API REST di CASAFARI e quando preferire MCP.
I cicli di chiamata degli agenti autonomi gestiscono le eccezioni secondo lo standard RFC 9457 application/problem+json. Se i tokens terminano, l'API restituisce un errore HTTP 402 payment_required contenente upgrade_url e l'header Link: rel="payment", permettendo all'agente di interrogare GET /v1/account/payment-links/{id} fino al completamento della ricarica. In presenza di limiti di frequenza, l'errore HTTP 429 fornisce l'header Retry-After e l'URL di aggiornamento del piano.
Come incorporare la ricerca Claro AI e risolvere CAP e località con Location Lookup?
Piattaforme e portali commerciali che desiderano offrire la ricerca di uffici, negozi o locali logistici in linguaggio naturale possono integrare il widget di Claro AI senza sviluppare logiche di backend. Caricando lo script /embed.js e chiamando POST /v1/embed/search con una chiave pubblica pub_ (limitata ai domini autorizzati), la pagina mostra fino a 50 risultati per pagina mantenendo la chiave segreta sul server. Per i dettagli integrativi, fare riferimento alla documentazione per incorporare la barra di ricerca di Claro AI con chiave pubblica (in inglese).
La gestione della geografia immobiliare italiana richiede la risoluzione esatta dei comuni, dei quartieri e dei codici di avviamento postale (CAP). Lo strumento Location Lookup (/v1/locations via REST o /mcp/locations via MCP) converte toponimi, coordinate GPS o prefissi CAP in location_ids senza alcun consumo di tokens (0 tokens). Per la visualizzazione delle mappe, l'endpoint POST /api/v1/references/zipcode-boundary restituisce i poligoni di confine del CAP. Consulta la guida su come risolvere un luogo in location ID con Location Lookup via MCP e REST.
Come iniziare in self-serve con il piano Free o Agent?
L'integrazione non richiede iter commerciali o trattative riservate. È sufficiente accedere a platform.casafari.com/signin per generare una chiave API segreta (cf_sk_...), una chiave pubblica (pub_...) o configurare l'autenticazione OAuth 2.1 con access token per l'accesso MCP.
Il piano Free include 1.000 tokens per 30 giorni senza inserire carte di credito, consentendo di testare le specifiche OpenAPI e i flussi di risposta. Al momento del passaggio in produzione, è possibile attivare il piano Agent a 70 € al mese (o 49 € al mese con fatturazione annuale) ed effettuare ricariche di tokens direttamente dalla console man mano che le chiamate crescono.
Domande frequenti
Come funziona la deduplicazione degli annunci immobiliari nell'API di CASAFARI?
CASAFARI raccoglie gli annunci da portali e siti di agenzie immobiliari, unificando le inserzioni duplicate dello stesso bene in una singola scheda immobile identificata da prop_.... In tutta Europa, CASAFARI traccia 7 volte più annunci pubblicitari rispetto alle singole proprietà e individua almeno il 40% in più di immobili deduplicati. Ogni risposta restituisce la cronologia completa dei prezzi richiesti, i giorni sul mercato e tutti i link sorgente attivi.
Quali specifiche tecniche sono disponibili per collegare un agente IA o un LLM?
Ogni prodotto espone una specifica OpenAPI all'indirizzo platform.casafari.com/v1/<product>/openapi.json, la definizione tools.json e l'indice per LLM all'indirizzo platform.casafari.com/llms.txt. Gli sviluppatori possono connettere client come Claude, ChatGPT, Cursor, Claude Code o Gemini CLI direttamente ai server Casafari MCP, senza la necessità di installare package SDK aggiuntivi.
Come vengono gestiti i limiti di utilizzo e gli errori HTTP 402 e 429 dagli assistenti IA?
Gli errori seguono lo standard RFC 9457 application/problem+json. Quando i tokens si esauriscono, l'errore HTTP 402 payment_required restituisce un parametro upgrade_url e l'header Link con rel="payment", consentendo all'agente di mostrare il link di pagamento ed effettuare il polling su GET /v1/account/payment-links/{id}. L'errore HTTP 429 fornisce l'header Retry-After per il rispetto dei limiti di frequenza.
Quanto costa risolvere un indirizzo o un CAP con Location Lookup?
Location Lookup è un servizio gratuito a 0 tokens, disponibile sia tramite REST (GET /v1/locations/search) sia tramite MCP (https://platform.casafari.com/mcp/locations). Permette di convertire indirizzi italiani, coordinate o codici di avviamento postale (CAP esatti o prefissi) in location_ids standardizzati prima di eseguire ricerche di proprietà.
Quali Paesi copre il grafo immobiliare di CASAFARI?
Il grafo immobiliare di CASAFARI copre 16 Paesi (Andorra, Austria, Belgio, Svizzera, Germania, Spagna, Francia, Grecia, Italia, Lussemburgo, Monaco, Polonia, Portogallo, San Marino e Emirati Arabi Uniti) con ingresso ora negli Stati Uniti: in Stati selezionati, esclusivamente per il settore immobiliare commerciale, tramite Claro AI. I valori economici riportati nel grafo includono sia i prezzi richiesti degli annunci indicizzati, sia i prezzi di chiusura e compravendita provenienti da open data (come l'Agenzia delle Entrate), notai e dati forniti dai clienti a livello societario.
Provatelo sul vostro mercato
1.000 token gratuiti per 30 giorni, senza carta. Poi il piano Agent o token prepagati.