API Documentation

Accedi programmaticamente a tutti i dati sui 7.896 comuni italiani. API REST gratuita, nessuna autenticazione richiesta.

Base URL: https://datitalia.eu/api

⚡

Nessuna Auth

API pubblica e gratuita, inizia subito senza API key

📊

7.896 Comuni

Dati completi su tutti i comuni italiani aggiornati 2025

🚀

Cache CDN

Risposte cacheate 1h, stale-while-revalidate per performance

Overview

L'API DatiItalia fornisce accesso a dati aperti sui comuni italiani provenienti da ISTAT, MEF e ISPRA. Tutti i dati sono aggiornati alle ultime rilevazioni ufficiali: ISTAT 2025 (demografia), MEF 2023 (redditi), ISPRA 2024 (suolo), EEA 2022 (aria).

Tip

Tutti gli endpoint ritornano JSON. Le risposte vengono cacheate per 1 ora per ottimizzare le performance.

📍 Comuni

Endpoint per accedere ai dati anagrafici dei comuni italiani.

GET/api/comuni

Restituisce la lista di tutti i 7.896 comuni italiani con codice ISTAT, nome, provincia e regione.

Parametri

Parametro	Tipo	Descrizione
`regione`	`string`	Filtra per nome regione (es: "Lombardia")
`provincia`	`string`	Filtra per sigla provincia (es: "MI")
`limit`	`integer`	Numero massimo risultati (default: 100, max: 1000)
`offset`	`integer`	Offset per paginazione (default: 0)

Prova in browser

GET/api/comuni/{codice_istat}

Restituisce i dettagli completi di un singolo comune identificato dal codice ISTAT.

Parametri

Parametro	Tipo	Descrizione
`codice_istat`required	`string`	Codice ISTAT del comune (6 cifre, es: "015146")

GET/api/comuni/cerca

Cerca comuni per nome. Restituisce fino a 10 risultati ordinati per rilevanza. Ideale per autocomplete.

Parametri

Parametro	Tipo	Descrizione
`q`required	`string`	Query di ricerca (minimo 2 caratteri)

Prova in browser

👥 Demografia

Dati demografici: popolazione, densità, trend storici.

GET/api/demografia/{codice_istat}

Dati demografici completi di un comune: popolazione totale, maschile, femminile, nascite, morti.

Parametri

Parametro	Tipo	Descrizione
`codice_istat`required	`string`	Codice ISTAT del comune
`anno`	`integer`	Anno specifico (opzionale)

GET/api/demografia/classifica/{indicatore}

Classifica comuni per indicatore demografico.

Parametri

Parametro	Tipo	Descrizione
`indicatore`required	`string`	popolazione \| densita
`ordine`	`string`	desc (default) \| asc
`limit`	`integer`	Default: 50, max: 500
`offset`	`integer`	Offset per paginazione

💶 Redditi

Dati reddituali del MEF: reddito medio, mediano, numero contribuenti per comune.

GET/api/redditi/{codice_istat}

Dati reddituali di un comune: reddito medio, mediano, numero contribuenti, classi di reddito.

Parametri

Parametro	Tipo	Descrizione
`codice_istat`required	`string`	Codice ISTAT del comune
`anno`	`integer`	Anno specifico (opzionale)

GET/api/redditi/classifica/{indicatore}

Classifica comuni per reddito.

Parametri

Parametro	Tipo	Descrizione
`indicatore`required	`string`	reddito \| contribuenti
`ordine`	`string`	desc (default) \| asc
`limit`	`integer`	Default: 50, max: 500

🌱 Ambiente

Dati ISPRA: qualità dell'aria e consumo del suolo.

GET/api/ambiente/{codice_istat}

Dati ambientali di un comune: qualità dell'aria (PM10, PM2.5, NO2, ozono) e consumo del suolo.

Parametri

Parametro	Tipo	Descrizione
`codice_istat`required	`string`	Codice ISTAT del comune

GET/api/ambiente/aria/classifica

Classifica comuni per qualità dell'aria (PM2.5, PM10, NO2).

Parametri

Parametro	Tipo	Descrizione
`indicatore`	`string`	pm10 \| pm25 \| no2
`order`	`string`	asc (default) \| desc
`limit`	`integer`	Numero risultati

Prova in browser

GET/api/ambiente/suolo/classifica

Classifica comuni per consumo del suolo.

Parametri

Parametro	Tipo	Descrizione
`order`	`string`	asc \| desc (default)
`limit`	`integer`	Numero risultati

Prova in browser

⭐ Qualità della Vita

Indice composito di qualità della vita e wizard di ricerca.

GET/api/qualita-vita/classifica

Classifica comuni per indice di qualità della vita (composito: reddito 30%, ambiente 25%, servizi 20%, demografia 15%, sicurezza 10%).

Parametri

Parametro	Tipo	Descrizione
`limit`	`integer`	Numero risultati
`offset`	`integer`	Offset per paginazione
`regione`	`string`	Filtra per regione
`min_pop`	`integer`	Popolazione minima
`max_pop`	`integer`	Popolazione massima

Prova in browser

GET/api/qualita-vita/wizard

Wizard per trovare i comuni più adatti in base a preferenze personali.

Parametri

Parametro	Tipo	Descrizione
`budget`required	`string`	basso \| medio \| alto
`dimensione`required	`string`	piccolo (<5k) \| medio (5-50k) \| grande (>50k)
`priorita`required	`string`	reddito \| ambiente \| servizi \| bilanciato
`regione`	`string`	Filtra per regione (opzionale)

Prova in browser

⚖️ Confronta

Confronta dati tra più comuni contemporaneamente.

GET/api/confronta

Confronta dati demografici e reddituali di più comuni.

Parametri

Parametro	Tipo	Descrizione
`comuni`required	`string`	Codici ISTAT separati da virgola (max 4)
`anno`	`integer`	Anno di riferimento

Prova in browser

GET/api/confronta/nazionale-medie

Restituisce le medie nazionali per confronto.

Parametri

Parametro	Tipo	Descrizione
`anno`	`integer`	Anno di riferimento (opzionale)

Prova in browser

Esempi di Codice

# Cerca comune
curl "https://datitalia.eu/api/comuni/cerca?q=Roma"

# Dettaglio comune
curl "https://datitalia.eu/api/comuni/058091"

# Dati demografici
curl "https://datitalia.eu/api/demografia/058091"

# Classifica per densita
curl "https://datitalia.eu/api/demografia/classifica/densita?limit=20"

# Confronta comuni
curl "https://datitalia.eu/api/confronta?comuni=058091,015146,006056"

Limiti & Cache

Fair Use

L'API è gratuita per uso personale e commerciale. Non abusare: se prevedi >10k request/giorno, contattaci.

Header Cache

Tutte le risposte includono header Cache-Control per ottimizzare le performance:

Cache-Control: public, max-age=3600, stale-while-revalidate=86400

Rate Limiting

Attualmente nessun rate limit rigido, ma richieste abusive saranno bloccate. Usa header If-None-Match per conditional requests se supportato dal tuo client.