ottobre 2026

CSV vs API: come far viaggiare i dati della tua agenzia

Un CSV è una fotografia: un file con righe e colonne che esporti, invii e importi quando serve. Un’API è una linea diretta: due software che si parlano da soli, annuncio per annuncio, nel momento in cui qualcosa cambia. Per un’agenzia immobiliare la scelta non è tecnica, è operativa. Decide quanto velocemente un ribasso di prezzo arriva sui portali, chi si accorge di un errore e quante ore passi a copiare dati da una schermata all’altra. Qui trovi le differenze concrete, quando conviene l’uno o l’altra e cosa controllare sulla privacy prima di spostare un solo contatto.

Wolk

Riduci il lavoro manuale sugli annunci

Wolk trasforma un tour e alcune foto in un annuncio pronto per l’MLS, un copione social e un messaggio di testo.

Scopri Wolk

In breve

Il CSV va bene per le operazioni occasionali: migrazioni da un vecchio gestionale, import di un elenco, report mensili, analisi su grandi volumi.
L’API serve quando i dati devono restare allineati ogni giorno: annunci sui portali, stato delle trattative, prezzi che cambiano.
I portali italiani spingono verso l’API: Immobiliare.it indica il servizio REST come soluzione consigliata e il flusso a file come modalità storica.
Il file costa poco all’inizio ma molto nel tempo, perché ogni passaggio manuale è un’occasione di errore. L’API costa di più da avviare e meno da mantenere.
Il GDPR non cambia con il formato: che i contatti viaggino in un CSV o via API, l’agenzia resta titolare del trattamento.

Indice

CSV e API spiegati senza gergo
Come funziona sui portali italiani
Il confronto punto per punto
Quando il CSV è la scelta giusta
Quando serve un’API
Quanto costa l’uno e quanto l’altra
Privacy e GDPR: il formato non ti protegge
Come scegliere in cinque domande
Il nostro punto di vista
Prova Wolk sul tuo prossimo sopralluogo
Domande frequenti
Fonti

CSV e API spiegati senza gergo

Il file CSV

CSV sta per “comma-separated values”, cioè valori separati da virgole. È un semplice file di testo in cui ogni riga è un record (un immobile, un contatto) e ogni colonna un campo (indirizzo, metri quadri, prezzo). Il formato è descritto nella specifica RFC 4180, che fissa le regole di base: una riga d’intestazione facoltativa, i campi separati da virgole, le virgolette doppie attorno ai valori che contengono a loro volta virgole o a capo.

Il suo pregio è l’universalità: lo apri con Excel, Google Sheets o qualunque gestionale. Il suo limite è che non sa nulla di ciò che contiene. Se in una colonna “prezzo” scrivi “trattabile”, il file non protesta: se ne accorgerà, forse, il sistema che lo importa. Nella pratica italiana c’è un problema in più: Excel con le impostazioni locali italiane tende a salvare i CSV con il punto e virgola al posto della virgola, e i decimali con la virgola. Un file preparato in agenzia può quindi arrivare “rotto” a un software che si aspetta lo standard internazionale.

L’API

Un’API (application programming interface) è un canale attraverso cui un programma chiede o invia dati a un altro, in modo automatico e con regole precise. Invece di esportare un file e caricarlo, il tuo CRM dice al portale: “questo annuncio ora costa 249.000 €”, e il portale risponde subito se ha accettato la modifica o perché l’ha rifiutata.

La differenza chiave è il dialogo. Con un file mandi tutto e speri. Con un’API ogni singola operazione riceve un esito.

Come funziona sui portali italiani

Il caso più istruttivo è quello dei portali, perché è lì che un’agenzia sente davvero la differenza. La guida all’integrazione di Immobiliare.it presenta il servizio REST come la scelta consigliata per sincronizzare gli annunci quasi in tempo reale: puoi inviare aggiornamenti in qualsiasi momento, anche più volte al giorno per lo stesso immobile. Ogni richiesta torna indietro con uno status e un messaggio che dice cosa non va: campo obbligatorio mancante, dati incompatibili tra loro, identificativo errato, annuncio bloccato, validazione dello schema fallita.

Il flusso a file, che il portale chiama batch, funziona in modo opposto. Secondo le specifiche della modalità batch devi rigenerare ogni 24 ore un feed completo, con un tetto di 10.000 annunci, e gli immobili che non compaiono nel file vengono eliminati dal portale. La stessa documentazione mette in fila i limiti: più latenza, nessun riscontro immediato, il rischio che un solo errore blocchi l’intero flusso e tempi di pubblicazione che vanno da un’ora a 48 ore.

Confronto tra tempi e limiti di API e batch

Un dettaglio onesto: sui portali il file è spesso XML, non CSV. La logica però è identica. Un file è un’istantanea completa che il destinatario legge a intervalli, un’API è una conversazione continua. Se vuoi entrare nel dettaglio di questo caso, abbiamo scritto una guida sulla sincronizzazione degli annunci con Immobiliare.it.

Non tutte le API servono a pubblicare. La Search API di idealista, per esempio, permette di integrare nel proprio sito o nella propria app le informazioni sugli immobili già pubblicati sul portale, e la chiave si ottiene su richiesta descrivendo il progetto. Prima di parlare di “integrazione via API”, chiediti quindi in quale direzione viaggiano i dati.

Anche i dati pubblici seguono la logica del file. L’Agenzia delle Entrate consente agli utenti dei servizi telematici di scaricare gratuitamente le quotazioni OMI, i perimetri delle zone in formato KML e i volumi di compravendita per comune, con licenza CC-BY 4.0. Sono dati che cambiano a ogni semestre, non ogni ora: un download periodico è perfettamente adeguato.

Il confronto punto per punto

Criterio	CSV (o file)	API
Aggiornamento	A intervalli: quando qualcuno esporta e importa, o a cadenza fissa	Continuo: ogni modifica parte quando avviene
Riscontro sugli errori	Spesso a posteriori, a volte assente	Immediato, per singola operazione e singolo campo
Effetto di un errore	Può bloccare o falsare l’intero file	Resta confinato al record sbagliato
Grandi volumi	Ottimo per estrazioni massive e analisi	Ottimo per ricerche puntuali, meno per scaricare tutto in un colpo
Costo di avvio	Quasi nullo	Più alto: serve sviluppo o un software già integrato
Costo nel tempo	Alto in ore di lavoro manuale	Più prevedibile, legato a canone o chiamate
Chi lo gestisce	Chiunque in agenzia sappia usare un foglio di calcolo	Il fornitore del software o un tecnico
Uso tipico in agenzia	Migrazioni, report, import di elenchi, backup	Portali, CRM, sito, matching tra richieste e immobili

Quando il CSV è la scelta giusta

Il file non è un ripiego. In molte situazioni è lo strumento più semplice e più sensato.

Cambi gestionale. Una migrazione si fa una volta: esporti immobili e contatti dal vecchio sistema e li importi nel nuovo. Costruire un’integrazione per un’operazione singola non ha senso.
Lavori su dati che cambiano lentamente. Quotazioni di zona, statistiche di compravendita, l’archivio storico degli immobili venduti.
Fai analisi. Se vuoi capire in quali microzone hai chiuso più trattative negli ultimi due anni, un’estrazione completa in un foglio di calcolo è più comoda di mille chiamate. Anche fornitori di dati immobiliari come PropTrack descrivono le estrazioni come lo strumento adatto ad analizzare grandi quantità di dati, e riservano l’API all’accesso in tempo reale.
Il software dall’altra parte è datato e non offre altro.

Prima di importare un CSV, però, controlla tre cose: che le colonne corrispondano ai campi del sistema di destinazione, che separatore e decimali siano quelli attesi, che non ci siano duplicati. Per i contatti il discorso si allarga alla provenienza dei dati, e lo trovi sviluppato nella nostra guida su come importare contatti immobiliari.

Quando serve un’API

L’API diventa necessaria appena i dati devono restare vivi, cioè allineati ogni giorno tra più sistemi.

Pubblichi su più portali. Un ribasso, un “venduto”, una foto nuova devono arrivare ovunque senza che qualcuno debba ricordarsene.
Hai volumi alti. Con 200 immobili attivi, un aggiornamento manuale settimanale significa annunci vecchi online per giorni.
Lavori in squadra. Se tre agenti toccano lo stesso immobile, serve un’unica fonte affidabile che propaghi le modifiche.
Ti serve sapere subito cosa non va. Un annuncio rifiutato per un campo mancante va corretto oggi, non scoperto fra due giorni.

Se il tuo problema è collegare il gestionale ai portali, la nostra guida pratica su come integrare il CRM con i portali immobiliari parte proprio da qui.

Esiste anche una via di mezzo, che molte aziende adottano: CSV per import ed export occasionali, API per le connessioni esterne e in tempo reale. Non è indecisione, è usare ogni strumento per ciò che fa meglio.

Quanto costa l’uno e quanto l’altra

Il CSV sembra gratuito, ed è vero solo all’inizio. Il costo vero sta nelle ore: chi esporta, chi ripulisce il file, chi lo ricarica, chi controlla che sia andato tutto bene. Moltiplica quei minuti per ogni immobile e per ogni settimana e scopri che il file “gratis” è la voce più cara del tuo flusso.

L’API ha un costo d’ingresso più visibile. Se la sviluppi in proprio, paghi un programmatore e poi la manutenzione, perché le specifiche dei portali cambiano. Se usi API di dati a consumo, paghi per chiamata: per l’API Real Estate di Openapi, per esempio, la singola richiesta parte da 2,00 € e con l’abbonamento annuale il costo per chiamata può scendere fino a partire da 0,10 €. Un’analisi sui dati catastali pubblicata da Zornade riassume bene il compromesso: i file statici costano quasi nulla all’avvio e poco da mantenere, ma vanno gestiti a mano, mentre l’API a richiesta ha un avvio contenuto e un costo di mantenimento prevedibile.

Per un’agenzia la strada più breve, quasi sempre, è non costruire nulla: scegliere un software che le integrazioni le ha già e le mantiene al posto tuo.

Quanto costa l'uno e quanto l'altra — overview diagram

Su questo punto il confronto finisce in pareggio, e non in senso positivo. Un CSV con nomi e telefoni allegato a un’email è un rischio evidente: può essere inoltrato, dimenticato in una cartella condivisa, aperto da chi non dovrebbe. Un’API è più controllabile, perché richiede l’autenticazione e lascia traccia delle operazioni, ma non rende lecito ciò che non lo è.

Lo ha ricordato il Garante con il provvedimento n. 10134847 del 29 aprile 2025: un’agenzia aveva usato liste di contatti fornite da terzi senza verificare né documentare informativa e consenso. L’agenzia resta titolare del trattamento e non può scaricare la responsabilità sul fornitore. E il consenso, come stabilisce il Regolamento (UE) 2016/679, deve essere libero, specifico, informato e inequivocabile: il silenzio o l’inattività non valgono come un sì.

In pratica, prima di importare un elenco di contatti, qualunque sia il formato:

Chiedi al fornitore come e quando è stato raccolto il consenso, e fattelo documentare.
Verifica che l’informativa citi la tua agenzia e l’uso che farai dei dati.
Limita l’accesso al file e cancellalo dopo l’import.
Registra l’operazione nel tuo registro dei trattamenti.

Se hai dubbi su un elenco specifico, il passo giusto è sentire il tuo DPO o un avvocato esperto di protezione dei dati prima di contattare chiunque. Per un quadro completo degli adempimenti, leggi la nostra guida al GDPR per agenzie immobiliari. Conta anche chi, in agenzia, vede quali dati: i permessi utenti nel CRM sono la prima difesa.

Come scegliere in cinque domande

Quanto spesso cambiano questi dati? Ogni giorno: API. Ogni mese o meno: file.
Quanti record sono? Poche decine una tantum: basta un CSV. Centinaia di annunci attivi: serve l’automazione.
Quanto costa un errore? Se un annuncio sbagliato online ti fa perdere un cliente, ti serve il riscontro immediato di un’API.
Chi lo manterrà? Se in agenzia non c’è un tecnico, l’integrazione deve mantenerla il fornitore del software.
Cosa accetta il sistema di destinazione? A volte la risposta è già scritta nella documentazione del portale o del gestionale.

Se oggi gestisci tutto con i fogli di calcolo e ti chiedi se basta, il confronto tra Google Sheets e Airtable ti aiuta a capire fin dove può arrivare un foglio prima di diventare un collo di bottiglia.

Il nostro punto di vista

Vediamo ogni giorno agenti che passano più tempo a spostare dati che a vendere case. Il sopralluogo finisce e comincia il secondo lavoro: ricopiare gli appunti, riscrivere la descrizione per ogni portale, aggiornare il foglio, mandare il messaggio al cliente. Ogni passaggio è un piccolo CSV fatto a mano.

Per questo crediamo che la domanda giusta non sia “CSV o API”, ma “quante volte devo riscrivere la stessa informazione”. La risposta dovrebbe essere: una. Con Wolk descrivi le stanze a voce mentre scatti le foto, e in circa 15 secondi hai un annuncio pronto per la pubblicazione, lo script per un video social, un SMS per il cliente e le varianti di testo per ogni portale. Puoi rivedere e modificare tutto prima di pubblicare, e la sincronizzazione con i portali ti evita di ricaricare a mano ciò che hai già scritto.

Sulla privacy siamo netti: la trascrizione vocale avviene interamente sul dispositivo e nessun dato vocale viene caricato. Niente pubblicità, niente tracciamento, niente SDK invasivi. Il file più facile da proteggere è quello che non lasci in giro.

— Marco

Prova Wolk sul tuo prossimo sopralluogo

Se vuoi smettere di passare dati da un sistema all’altro, puoi partire dal piano Free, che comprende 3 tour. Il piano Pro per agenti singoli costa 14,99 USD al mese per postazione, oppure 143,99 USD all’anno per postazione. Per le agenzie con più agenti ci sono il piano Growth e il CRM Brokerage, con matching automatico tra richieste e immobili e una pipeline delle trattative personalizzabile. Scopri Wolk e crea il tuo primo kit annuncio.

Domande frequenti

A cosa serve il formato CSV?

Serve a trasferire dati in tabella tra programmi diversi, in un formato di testo che quasi tutti sanno leggere. In agenzia si usa per migrare immobili e contatti da un gestionale all’altro, per importare elenchi e per fare analisi in un foglio di calcolo. Non è adatto a tenere allineati dati che cambiano ogni giorno.

Qual è la differenza tra un file Excel e un file CSV?

Un file Excel (.xlsx) conserva formule, formattazione, più fogli e grafici. Un CSV contiene solo i valori, riga per riga, separati da un delimitatore. Quando salvi un foglio Excel come CSV perdi tutto tranne i dati, ed è proprio questo che lo rende leggibile da qualunque software.

Come si apre e si legge un file CSV?

Puoi aprirlo con Excel, Google Sheets o qualsiasi editor di testo. Se tutti i dati finiscono in un’unica colonna, il programma sta usando il separatore sbagliato: in Excel usa la funzione di importazione da testo e scegli virgola o punto e virgola a seconda del file. Controlla anche che le lettere accentate siano corrette, altrimenti reimporta il file con la codifica UTF-8.

Un’API è sempre più sicura di un CSV?

Tecnicamente è più controllabile, perché richiede l’autenticazione e registra le operazioni. Ma la liceità del trattamento dipende dal consenso e dall’informativa, non dal canale. Un’API che trasferisce contatti raccolti senza consenso resta un problema.