Accesso ai dati · stato reale

Come si leggono i nostri dati.

Oggi Trasparenza.ai non espone una API REST propria con contratto pubblico. I dati sono leggibili tramite PostgREST di Supabase con la chiave anon pubblica, senza garanzia di stabilita degli endpoint. Il contratto programmatico stabile sara il server MCP.

Fino al 2 settembre 2026 questa pagina elencava otto endpoint sotto /api/ e due limiti di frequenza. Nessuno di quegli indirizzi ha mai restituito dati e nessun limite era applicato. Li abbiamo tolti invece di lasciarli in attesa di diventare veri.

Quello che segue funziona davvero, e si puo provare adesso incollando i comandi in un terminale.

Tabelle leggibili

Sola lettura, senza registrazione. I nomi delle tabelle e delle colonne possono cambiare senza preavviso: e la ragione per cui questa non e una API con contratto.

comuni
Una riga per Comune. 7.894 attivi piu 19 soppressi o fusi, conservati perche i contratti a loro intestati esistono ancora.
contratti
Contratti pubblici con CIG, fonte ANAC. Copertura dal 1 gennaio 2020 al 31 dicembre 2025.
fornitori
523.819 fornitori distinti, con partita IVA. Il codice fiscale delle persone fisiche non e esposto.
progetti_pnrr
329.447 progetti, estrazione ufficiale Italia Domani/ReGiS del 13 giugno 2026.
anomalie
206.306 segnali statistici sui contratti. Scostamenti dalla distribuzione, non irregolarita accertate.
dati_energia_verificati
Vista delle acquisizioni ENTSO-E promosse dopo i controlli: generazione, capacità, prezzi e flussi fisici, con periodi e provenienza. La disponibilità effettiva dipende dagli snapshot pubblicati. Le righe storiche di dati_energia non costituiscono una serie verificata; per aggregazioni e limiti consulta /energia.

Tre esempi che funzionano

La chiave qui sotto e la chiave anon pubblica del progetto: e la stessa che il tuo browser riceve visitando il sito, da sola non permette nessuna scrittura ed e limitata dalle regole RLS del database.

1. La scheda di un Comune

curl -s "https://diaokmfkvomjghamdpze.supabase.co/rest/v1/comuni?slug=eq.narni&select=nome,regione,popolazione,punteggio_trasparenza,num_contratti" \
  -H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImRpYW9rbWZrdm9tamdoYW1kcHplIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI2ODMxMDksImV4cCI6MjA4ODI1OTEwOX0.XWaHZPrdxDEce8jn-Av7uUYKrePRhubGydiBf0QBMa4"

2. I progetti PNRR di un Comune, vista soggetto attuatore

curl -s "https://diaokmfkvomjghamdpze.supabase.co/rest/v1/comune_pnrr_attuatore?select=num_progetti,quota_pnrr&comune_id=eq.<uuid>" \
  -H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImRpYW9rbWZrdm9tamdoYW1kcHplIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI2ODMxMDksImV4cCI6MjA4ODI1OTEwOX0.XWaHZPrdxDEce8jn-Av7uUYKrePRhubGydiBf0QBMa4"

Esiste anche comune_pnrr_territorio. Le due viste rispondono a domande diverse, progetti gestiti dal Comune come soggetto attuatore contro progetti di qualsiasi ente localizzati sul territorio, e non vanno mai sommate: sommarle conta due volte le stesse opere.

3. I primi contratti di un Comune, dal piu recente

curl -s "https://diaokmfkvomjghamdpze.supabase.co/rest/v1/contratti?select=oggetto,importo,data_contratto&limit=20&order=data_contratto.desc" \
  -H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImRpYW9rbWZrdm9tamdoYW1kcHplIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI2ODMxMDksImV4cCI6MjA4ODI1OTEwOX0.XWaHZPrdxDEce8jn-Av7uUYKrePRhubGydiBf0QBMa4" \
  -H "Range: 0-19"

Da sapere prima di sommare qualcosa. Il 13,7% dei contratti non e attribuito ad alcun Comune e il 53,5% non ha un fornitore collegato: la somma delle schede comunali non coincide con il totale nazionale, e ogni vista su chi incassa copre meno della meta dei contratti. Inoltre 516 contratti hanno alla fonte un importo fuori da ogni scala plausibile, quasi sempre errori di digitazione nel dato ANAC, e vanno esclusi dai totali.

Licenza e uso

Licenza delle elaborazioni: applichiamo la CC BY 4.0 ai contributi originali di Trasparenza.ai sui quali possiamo concedere diritti. Va citata anche la fonte primaria. I materiali di terzi mantengono le proprie condizioni: il dataset processato di OpenSanctions, per esempio, è pubblicato sotto CC BY-NC 4.0. Per ENTSO-E le condizioni dipendono dal prodotto e dal titolare: l'accesso tramite API non concede una licenza generale di riuso. Verifica la fonte e la licenza del materiale che intendi riutilizzare. Il codice del sito resta privato.
Nessun limite di frequenza dichiarato: non ne applichiamo nessuno oggi e non ne promettiamo. Chi scarica in massa e pregato di farlo con misura, perche il database e piccolo e condiviso con il sito.
Nessuna garanzia di stabilita: tabelle e colonne possono cambiare. Per un contratto stabile aspettare il server MCP.
Uso commerciale: la CC BY 4.0 lo consente, rispettandone le condizioni, senza una nostra autorizzazione aggiuntiva. Questa possibilità non estende i diritti sui materiali di terzi. Per chiarimenti sulla provenienza: contato@ferrolabs.com.br.

Citare una consultazione

Riporta titolo e URL esatta della pagina o della query, data di accesso in formato YYYY-MM-DD, fonte primaria e periodo di copertura. Se salvi un export, conserva anche la query, i filtri e il file usato. Una data di accesso identifica la consultazione, non una versione immutabile del database: queste tabelle possono cambiare e non offrono ancora snapshot pubblici versionati. Le ritirate documentate sono nel registro delle correzioni.