Open Source · AGPL-3.0

visura-api: l'API open source per le visure catastali

Estrai immobili e intestatari dal portale SISTER dell'Agenzia delle Entrate tramite una semplice API REST. FastAPI + Playwright, login SPID automatizzato, output JSON. Gratis, self-hosted, ispezionabile.

Leggi l'approfondimento

Cos'è visura-api?

visura-api è un servizio API REST open source che trasforma il portale SISTER dell'Agenzia delle Entrate in un'interfaccia programmabile. Pilota un browser Chromium headless con Playwright, si autentica via SPID ed espone con FastAPI gli endpoint per recuperare i dati catastali: immobili, rendite, categorie, indirizzi e intestatari.

È la prima API open source per interrogare SISTER. L'Agenzia delle Entrate non offre un'API pubblica ufficiale per le visure catastali: chi deve automatizzare le consultazioni si trova davanti un portale pensato per l'uso manuale. visura-api colma questa lacuna usando la tua convenzione SISTER e le tue credenziali, senza intermediari e senza costi per chiamata.

0 €: per visura estratta
2 fasi: immobili + intestatari
REST / JSON: integrabile ovunque
AGPL-3.0: codice ispezionabile

Per ogni particella interrogata indichi provincia, comune, foglio, particella e subalterno: se non conosci questi identificativi, leggi la guida foglio, particella e subalterno.

Avvio rapido con Docker

Dalla clonazione al primo /health in pochi minuti. Serve solo Docker e le tue credenziali SPID.

Prerequisito: adesione ai servizi SISTER

Prima di avviare il servizio devi sottoscrivere manualmente i servizi SISTER: registrati nell'Area Personale dell'Agenzia delle Entrate e cerca «sister» tra i servizi disponibili, poi richiedi l'accesso. È un passaggio veloce e si fa una sola volta. .

git clone https://github.com/zornade/visura-api.git
cd visura-api

cp .env.example .env        # inserisci le tue credenziali SPID
docker-compose up -d

curl http://localhost:8000/health

Al primo avvio approva la notifica push SPID entro 120 secondi: il servizio fa il login, naviga fino alle visure catastali e avvia coda e keep-alive.

Endpoint principali

GET/health

Stato del servizio: autenticazione, dimensione della coda. Nessun parametro.

POST/visura

Fase 1 — cerca gli immobili su foglio + particella. Se ometti tipo_catasto accoda sia Terreni sia Fabbricati.

POST/visura/intestati

Fase 2 — recupera i titolari (intestatari) di un singolo subalterno.

GET/visura/{request_id}

Polling del risultato: processing, completed o error. I dati arrivano nel campo data.

POST/sezioni/extract

Estrae le sezioni censuarie per province e comuni. Operazione batch molto lenta.

POST/shutdown

Shutdown controllato: logout dal portale SISTER e chiusura del browser.

Cosa offre

Flusso a due fasi

Prima gli immobili su una particella, poi gli intestatari di ogni subalterno. Coda sequenziale su un singolo browser autenticato per non sovraccaricare il portale.

Login SPID automatizzato

Provider Sielte ID, PosteID o login diretto SISTER, selezionabili via variabile d'ambiente SPID_PROVIDER. Approvi il secondo fattore una volta sola all'avvio.

Sessione sempre viva

Keep-alive ogni 30 secondi, refresh profondo ogni 5 minuti e ri-autenticazione automatica alla scadenza: il servizio resta pronto senza intervento manuale.

Stateless e Docker-ready

Nessun database: il servizio è completamente stateless. Immagine Docker pronta con Chromium headless e tutte le dipendenze di sistema.

Output JSON strutturato

Immobili, rendite, categorie, indirizzi e intestatari restituiti in JSON pronto da integrare. Logging HTML completo di ogni pagina per debug e audit.

Licenza AGPL-3.0

Codice libero e ispezionabile. La AGPL garantisce che ogni versione modificata ed esposta come servizio resti aperta alla community.

visura-api o un servizio di visure a pagamento?

I servizi commerciali rivendono le visure tramite la loro convenzione e fatturano ogni documento. visura-api usa la tua convenzione SISTER: nessun intermediario, nessun costo per chiamata, codice aperto.

Aspetto	visura-api	Servizi a pagamento
Costo per visura	Nessuno (usi la tua convenzione)	Tariffa per ogni documento
Codice sorgente	Aperto, ispezionabile (AGPL-3.0)	Chiuso
Dati	Diretti da SISTER, nessun intermediario	Passano dal fornitore
Hosting	Self-hosted, controlli tu	SaaS di terzi
Personalizzazione	Totale (puoi forkare)	Limitata all'API offerta
Requisito	Convenzione SISTER + SPID propri	Account presso il fornitore

Uso responsabile e conformità

visura-api è uno strumento indipendente e non è affiliato, approvato o supportato dall'Agenzia delle Entrate. Le credenziali SISTER sono personali e non cedibili: le consultazioni devono essere riconducibili all'intestatario della convenzione.

Lo strumento è pensato per automatizzare le proprie consultazioni, non per rivendere o esporre a terzi l'accesso al portale. La responsabilità del rispetto dei termini di servizio e della normativa vigente resta dell'utente.

Domande frequenti

Esiste un'API per le visure catastali dell'Agenzia delle Entrate?

Sì. visura-api è un servizio REST open source che automatizza il portale SISTER dell'Agenzia delle Entrate. Espone endpoint HTTP per estrarre immobili e intestatari a partire da provincia, comune, foglio e particella, restituendo i dati in JSON. L'Agenzia delle Entrate non offre un'API pubblica ufficiale per le visure: visura-api colma questa lacuna pilotando il portale con un browser headless e le tue credenziali SPID.

Quanto costa visura-api?

Il software è gratuito e open source (licenza AGPL-3.0): puoi scaricarlo, eseguirlo e modificarlo senza costi di licenza. La consultazione della banca dati catastale tramite SISTER è anch'essa gratuita per i soggetti convenzionati con l'Agenzia delle Entrate. A differenza dei servizi commerciali che vendono ogni visura a pagamento, qui paghi solo l'infrastruttura su cui esegui il servizio.

In cosa è diverso dai servizi di visure a pagamento?

I servizi commerciali rivendono le visure tramite la loro convenzione e fatturano per ogni documento. visura-api è una libreria di automazione che usa la tua convenzione SISTER e le tue credenziali: i dati non passano da intermediari, il codice è ispezionabile e non ci sono costi per chiamata. È pensato per chi ha già accesso a SISTER e vuole automatizzare le proprie consultazioni.

Quali credenziali servono per usarlo?

Serve l'adesione ai servizi SISTER e un'identità SPID compatibile (Sielte ID di default, oppure PosteID o login diretto SISTER). La sottoscrizione ai servizi SISTER va fatta manualmente una sola volta: dall'Area Personale dell'Agenzia delle Entrate si cerca "sister" tra i servizi disponibili e si richiede l'accesso. È un passaggio veloce; la guida ufficiale è su agenziaentrate.gov.it/portale/adesione-ai-servizi-sister.

È legale automatizzare il portale SISTER?

visura-api è uno strumento indipendente, non affiliato né approvato dall'Agenzia delle Entrate. La responsabilità del rispetto dei termini di servizio del portale e della convenzione SISTER resta dell'utente: le credenziali sono personali e non cedibili, e le consultazioni devono essere riconducibili all'intestatario della convenzione. Lo strumento va usato per automatizzare le proprie consultazioni, non per rivendere l'accesso a terzi.

Su cosa è costruito tecnicamente?

Su Python 3.11+, FastAPI per gli endpoint REST e Playwright per pilotare un browser Chromium headless. Il servizio è stateless, distribuito con Docker e docker-compose, e gestisce coda sequenziale, keep-alive della sessione e shutdown controllato con logout dal portale.

Esiste un'API REST ufficiale dell'Agenzia delle Entrate per le visure?

No. Al momento l'Agenzia delle Entrate non espone un'API REST pubblica per le visure catastali: il portale SISTER è progettato per la consultazione manuale via browser, con login SPID e una sequenza di click e form. Per questo molti sviluppatori cercano un'alternativa programmabile. visura-api fornisce questo strato di automazione restando open source.

visura-api estrae anche le visure ipotecarie?

No, il progetto è focalizzato sulle visure catastali: estrae gli immobili associati a una particella (foglio, particella, subalterno, categoria, rendita, indirizzo) e gli intestatari di ciascun subalterno. Le ispezioni ipotecarie non rientrano nell'attuale ambito del progetto.

Posso integrare visura-api nel mio gestionale o sito web?

Sì. Essendo un servizio REST con risposte in JSON, si integra in qualsiasi linguaggio o gestionale: invii una richiesta POST con provincia, comune, foglio e particella e recuperi i dati in polling. È adatto a CRM immobiliari, software gestionali di studi tecnici e pipeline di data enrichment.

Che differenza c'è rispetto alla consultazione manuale su SISTER?

Su SISTER ogni visura richiede login, navigazione e una serie di click e form ripetuti per ciascun immobile. visura-api trasforma questo flusso manuale in una singola chiamata REST: il browser headless esegue automaticamente login, ricerca e lettura dei risultati, restituendo dati strutturati in JSON. Il risparmio di tempo cresce in modo lineare con il volume di consultazioni.

Codice libero, dati nelle tue mani

Clona il repository, leggi la documentazione completa nel README e apri una issue o una pull request: visura-api è costruito in pubblico ed è aperto ai contributi.

Altri progetti open source