API Documentation

Programmatischer Zugriff auf alle Daten der 7.896 italienischen Gemeinden. Kostenlose REST-API, keine Authentifizierung erforderlich.

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

⚡

Keine Auth

Kostenlose öffentliche API — sofort starten, kein API-Key nötig

📊

7.896 Gemeinden

Vollständige Daten zu allen italienischen Gemeinden, aktualisiert 2025

🚀

CDN-Cache

Antworten 1h gecacht, stale-while-revalidate für Performance

Übersicht

Die DatiItalia-API bietet Zugriff auf offene Daten zu italienischen Gemeinden von ISTAT, MEF und ISPRA. Alle Daten sind auf dem neuesten Stand der offiziellen Erhebungen: ISTAT 2025 (Demografie), MEF 2023 (Einkommen), ISPRA 2024 (Boden), EEA 2022 (Luft).

Tipp

Alle Endpunkte liefern JSON. Antworten werden 1 Stunde gecacht, um die Performance zu optimieren.

📍 Gemeinden

Endpunkte für den Zugriff auf Stammdaten italienischer Gemeinden.

GET/api/comuni

Gibt die Liste aller 7.896 italienischen Gemeinden mit ISTAT-Code, Name, Provinz und Region zurück.

Parameter

Parameter	Typ	Beschreibung
`regione`	`string`	Nach Regionsname filtern (z. B. "Lombardia")
`provincia`	`string`	Nach Provinzkürzel filtern (z. B. "MI")
`limit`	`integer`	Maximale Ergebnisanzahl (Standard: 100, Max: 1000)
`offset`	`integer`	Offset für Paginierung (Standard: 0)

Im Browser testen

GET/api/comuni/{codice_istat}

Gibt die vollständigen Details einer einzelnen Gemeinde anhand des ISTAT-Codes zurück.

Parameter

Parameter	Typ	Beschreibung
`codice_istat`required	`string`	ISTAT-Code der Gemeinde (6 Ziffern, z. B. "015146")

GET/api/comuni/cerca

Suche nach Gemeinden nach Name. Gibt bis zu 10 Ergebnisse sortiert nach Relevanz zurück. Ideal für Autovervollständigung.

Parameter

Parameter	Typ	Beschreibung
`q`required	`string`	Suchanfrage (mindestens 2 Zeichen)

Im Browser testen

👥 Demografie

Demografische Daten: Bevölkerung, Dichte, historische Trends.

GET/api/demografia/{codice_istat}

Vollständige demografische Daten einer Gemeinde: Gesamtbevölkerung, männlich, weiblich, Geburten, Todesfälle.

Parameter

Parameter	Typ	Beschreibung
`codice_istat`required	`string`	ISTAT-Code der Gemeinde
`anno`	`integer`	Bestimmtes Jahr (optional)

GET/api/demografia/classifica/{indicatore}

Gemeinden nach demografischem Indikator einordnen.

Parameter

Parameter	Typ	Beschreibung
`indicatore`required	`string`	popolazione \| densita
`ordine`	`string`	desc (Standard) \| asc
`limit`	`integer`	Standard: 50, Max: 500
`offset`	`integer`	Offset für Paginierung

💶 Einkommen

MEF-Einkommensdaten: Durchschnittseinkommen, Median, Anzahl Steuerzahler pro Gemeinde.

GET/api/redditi/{codice_istat}

Einkommensdaten einer Gemeinde: Durchschnittseinkommen, Median, Steuerzahler, Einkommensklassen.

Parameter

Parameter	Typ	Beschreibung
`codice_istat`required	`string`	ISTAT-Code der Gemeinde
`anno`	`integer`	Bestimmtes Jahr (optional)

GET/api/redditi/classifica/{indicatore}

Gemeinden nach Einkommen einordnen.

Parameter

Parameter	Typ	Beschreibung
`indicatore`required	`string`	reddito \| contribuenti
`ordine`	`string`	desc (Standard) \| asc
`limit`	`integer`	Standard: 50, Max: 500

🌱 Umwelt

ISPRA-Daten: Luftqualität und Bodenverbrauch.

GET/api/ambiente/{codice_istat}

Umweltdaten einer Gemeinde: Luftqualität (PM10, PM2.5, NO2, Ozon) und Bodenverbrauch.

Parameter

Parameter	Typ	Beschreibung
`codice_istat`required	`string`	ISTAT-Code der Gemeinde

GET/api/ambiente/aria/classifica

Gemeinden nach Luftqualität einordnen (PM2.5, PM10, NO2).

Parameter

Parameter	Typ	Beschreibung
`indicatore`	`string`	pm10 \| pm25 \| no2
`order`	`string`	asc (Standard) \| desc
`limit`	`integer`	Anzahl Ergebnisse

Im Browser testen

GET/api/ambiente/suolo/classifica

Gemeinden nach Bodenverbrauch einordnen.

Parameter

Parameter	Typ	Beschreibung
`order`	`string`	asc \| desc (Standard)
`limit`	`integer`	Anzahl Ergebnisse

Im Browser testen

⭐ Lebensqualität

Zusammengesetzter Lebensqualitätsindex und Suche-Assistent.

GET/api/qualita-vita/classifica

Gemeinden nach Lebensqualitätsindex einordnen (zusammengesetzt: Einkommen 30%, Umwelt 25%, Dienste 20%, Demografie 15%, Sicherheit 10%).

Parameter

Parameter	Typ	Beschreibung
`limit`	`integer`	Anzahl Ergebnisse
`offset`	`integer`	Offset für Paginierung
`regione`	`string`	Nach Region filtern
`min_pop`	`integer`	Mindestbevölkerung
`max_pop`	`integer`	Maximale Bevölkerung

Im Browser testen

GET/api/qualita-vita/wizard

Assistent, um die am besten geeigneten Gemeinden basierend auf persönlichen Präferenzen zu finden.

Parameter

Parameter	Typ	Beschreibung
`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`	Nach Region filtern (optional)

Im Browser testen

⚖️ Vergleichen

Daten mehrerer Gemeinden gleichzeitig vergleichen.

GET/api/confronta

Demografische und Einkommensdaten mehrerer Gemeinden vergleichen.

Parameter

Parameter	Typ	Beschreibung
`comuni`required	`string`	ISTAT-Codes durch Komma getrennt (max. 4)
`anno`	`integer`	Referenzjahr

Im Browser testen

GET/api/confronta/nazionale-medie

Gibt nationale Durchschnittswerte zum Vergleich zurück.

Parameter

Parameter	Typ	Beschreibung
`anno`	`integer`	Referenzjahr (optional)

Im Browser testen

Codebeispiele

# 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"

Limits & Cache

Fair Use

Die API ist kostenlos für persönliche und kommerzielle Nutzung. Bitte nicht missbrauchen: Bei >10k Anfragen/Tag kontaktieren Sie uns.

Cache-Header

Alle Antworten enthalten Cache-Control-Header zur Performance-Optimierung:

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

Rate Limiting

Derzeit kein striktes Rate-Limit, aber missbräuchliche Anfragen werden blockiert. Verwenden Sie den If-None-Match-Header für bedingte Anfragen, wenn Ihr Client dies unterstützt.