# DatiItalia — Open Data for All Italian Municipalities
> https://datitalia.eu

## About
DatiItalia is an open data visualization platform covering all 7,904 Italian municipalities (comuni).
It provides demographics, income/tax, environment, air quality, quality of life, cost of living,
foreign residents data with interactive maps, charts, and rankings.
Data comes from official Italian government sources (ISTAT, MEF, ISPRA, EEA).

## Available Data Categories
- **Demografia** (Demographics): population, births, deaths, migration, age structure, dependency/aging indices, population projections
- **Redditi** (Income): average/median income per capita, number of taxpayers, income brackets, Gini index
- **Ambiente** (Environment): land consumption % (ISPRA), air quality — PM10, PM2.5, NO2, ozone (EEA)
- **Qualita della Vita** (Quality of Life): composite scores across income, environment, demographics, services, safety
- **Stranieri** (Foreign Residents): foreign population by nationality, continent of origin, % of total
- **Costo della Vita** (Cost of Living): housing prices per sqm, purchasing power index
- **Variazioni Amministrative** (Administrative Changes): municipal mergers, name changes, boundary changes since 1861

## Multilingual Support
Available in: Italian (default, no URL prefix), English (/en/), German (/de/), French (/fr/)

## URL Structure
- Homepage: /
- Municipality detail: /comune/{nome-slug}-{codice_istat} (e.g., /comune/roma-058091)
- Municipality sub-pages: /comune/{slug}/popolazione, /comune/{slug}/redditi, /comune/{slug}/ambiente
- Rankings: /classifica (filterable by indicator, region, population range)
- Comparisons: /confronta/{slug1}-vs-{slug2} (e.g., /confronta/roma-058091-vs-milano-015146)
- Regions: /regione/{nome-slug}-{codice} (e.g., /regione/lombardia-03)
- Provinces: /provincia/{nome-slug}-{codice} (e.g., /provincia/milano-015)
- Section pages: /demografia, /redditi, /ambiente, /qualita-vita, /stranieri, /costo-vita
- Explore map: /esplora (interactive choropleth map of all municipalities)
- Articles: /articoli/{slug}
- CAP lookup: /cap (postal code search)

## API Endpoints (public, read-only, rate-limited 60 req/min)
Base URL: https://datitalia.eu/api

### Municipality Search & Detail
- GET /api/comuni?limit=50&offset=0&regione=&provincia= — List municipalities (paginated)
- GET /api/comuni/{codice_istat} — Full municipality detail (e.g., /api/comuni/058091)
- GET /api/comuni/cerca?q={query} — Search municipalities by name (e.g., /api/comuni/cerca?q=roma)
- GET /api/comuni/cap/{cap} — Municipalities by postal code (e.g., /api/comuni/cap/00100)
- GET /api/comuni/regioni — List all 20 regions with municipality counts
- GET /api/comuni/province — List all provinces with municipality counts

### Demographics
- GET /api/demografia/{codice_istat} — Demographics with calculated indices
- GET /api/demografia/classifica/{indicatore} — Rankings. Indicators: popolazione, densita, nascite, morti, tasso-natalita, tasso-mortalita, saldo-naturale, indice-vecchiaia, indice-dipendenza, indice-ricambio, indice-struttura, carico-figli, eta-media, crescita-storica, proiezione-2050
  Filters: ?regione=Lombardia&min_pop=10000&max_pop=100000

### Income
- GET /api/redditi/{codice_istat} — Income data for a municipality
- GET /api/redditi/classifica/{indicatore} — Rankings: reddito, contribuenti. Supports region/pop filters

### Environment
- GET /api/ambiente/{codice_istat} — Environment data (land consumption + air quality)
- GET /api/ambiente/suolo/classifica — Land consumption rankings (?regione= filter)
- GET /api/ambiente/aria/classifica — Air quality rankings (?regione= filter)

### Quality of Life
- GET /api/qualita-vita/classifica — Quality of life composite rankings
- GET /api/qualita-vita/wizard?budget={basso|medio|alto}&dimensione={piccolo|medio|grande}&priorita={reddito|ambiente|servizi|bilanciato} — Personalized municipality recommendations

### Comparisons
- GET /api/confronta?comuni={codice1},{codice2} — Compare two municipalities side-by-side
- GET /api/confronta/nazionale-medie — National averages for all indicators

### Other
- GET /api/data-status — Data freshness and pipeline update status
- GET /api/stranieri/{codice_istat} — Foreign residents data
- GET /api/variazioni?anno=&tipo=&regione=&q= — Administrative changes

## Data Sources
- ISTAT (Italian National Institute of Statistics) — population, demographics, census
- MEF (Ministry of Economy and Finance) — income/tax declarations
- ISPRA (Institute for Environmental Protection and Research) — land consumption
- EEA (European Environment Agency) — air quality measurements

## What is a codice_istat?
A 6-digit code uniquely identifying each Italian municipality. Examples:
058091 = Roma, 015146 = Milano, 063049 = Napoli, 001272 = Torino, 048017 = Firenze

## Full Dataset
For a complete list of all 7,904 municipalities with key metrics, see: https://datitalia.eu/llms-full.txt