API Documentation

Accédez programmatiquement à toutes les données des 7 896 communes italiennes. API REST gratuite, aucune authentification requise.

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

⚡

Sans Auth

API publique et gratuite — commencez immédiatement, sans clé API

📊

7 896 Communes

Données complètes sur toutes les communes italiennes, mises à jour 2025

🚀

Cache CDN

Réponses en cache 1h, stale-while-revalidate pour la performance

Aperçu

L'API DatiItalia fournit un accès aux données ouvertes sur les communes italiennes provenant de l'ISTAT, du MEF et de l'ISPRA. Toutes les données sont mises à jour selon les dernières publications officielles : ISTAT 2025 (démographie), MEF 2023 (revenus), ISPRA 2024 (sols), EEA 2022 (air).

Conseil

Tous les points d'accès retournent du JSON. Les réponses sont mises en cache pendant 1 heure pour optimiser les performances.

📍 Communes

Points d'accès pour les données d'état civil des communes italiennes.

GET/api/comuni

Retourne la liste des 7 896 communes italiennes avec code ISTAT, nom, province et région.

Paramètres

Paramètre	Type	Description
`regione`	`string`	Filtrer par nom de région (ex : "Lombardia")
`provincia`	`string`	Filtrer par abréviation de province (ex : "MI")
`limit`	`integer`	Nombre maximum de résultats (défaut : 100, max : 1000)
`offset`	`integer`	Décalage pour la pagination (défaut : 0)

Essayer dans le navigateur

GET/api/comuni/{codice_istat}

Retourne les détails complets d'une commune identifiée par le code ISTAT.

Paramètres

Paramètre	Type	Description
`codice_istat`required	`string`	Code ISTAT de la commune (6 chiffres, ex : "015146")

GET/api/comuni/cerca

Recherche de communes par nom. Retourne jusqu'à 10 résultats triés par pertinence. Idéal pour l'autocomplétion.

Paramètres

Paramètre	Type	Description
`q`required	`string`	Requête de recherche (minimum 2 caractères)

Essayer dans le navigateur

👥 Démographie

Données démographiques : population, densité, tendances historiques.

GET/api/demografia/{codice_istat}

Données démographiques complètes d'une commune : population totale, masculine, féminine, naissances, décès.

Paramètres

Paramètre	Type	Description
`codice_istat`required	`string`	Code ISTAT de la commune
`anno`	`integer`	Année spécifique (optionnel)

GET/api/demografia/classifica/{indicatore}

Classer les communes par indicateur démographique.

Paramètres

Paramètre	Type	Description
`indicatore`required	`string`	popolazione \| densita
`ordine`	`string`	desc (défaut) \| asc
`limit`	`integer`	Défaut : 50, max : 500
`offset`	`integer`	Décalage pour la pagination

💶 Revenus

Données de revenus du MEF : revenu moyen, médian, nombre de contribuables par commune.

GET/api/redditi/{codice_istat}

Données de revenus d'une commune : revenu moyen, médian, contribuables, tranches de revenus.

Paramètres

Paramètre	Type	Description
`codice_istat`required	`string`	Code ISTAT de la commune
`anno`	`integer`	Année spécifique (optionnel)

GET/api/redditi/classifica/{indicatore}

Classer les communes par revenu.

Paramètres

Paramètre	Type	Description
`indicatore`required	`string`	reddito \| contribuenti
`ordine`	`string`	desc (défaut) \| asc
`limit`	`integer`	Défaut : 50, max : 500

🌱 Environnement

Données ISPRA : qualité de l'air et consommation des sols.

GET/api/ambiente/{codice_istat}

Données environnementales d'une commune : qualité de l'air (PM10, PM2.5, NO2, ozone) et consommation des sols.

Paramètres

Paramètre	Type	Description
`codice_istat`required	`string`	Code ISTAT de la commune

GET/api/ambiente/aria/classifica

Classer les communes par qualité de l'air (PM2.5, PM10, NO2).

Paramètres

Paramètre	Type	Description
`indicatore`	`string`	pm10 \| pm25 \| no2
`order`	`string`	asc (défaut) \| desc
`limit`	`integer`	Nombre de résultats

Essayer dans le navigateur

GET/api/ambiente/suolo/classifica

Classer les communes par consommation des sols.

Paramètres

Paramètre	Type	Description
`order`	`string`	asc \| desc (défaut)
`limit`	`integer`	Nombre de résultats

Essayer dans le navigateur

⭐ Qualité de vie

Indice composite de qualité de vie et assistant de recherche.

GET/api/qualita-vita/classifica

Classer les communes par indice de qualité de vie (composite : revenus 30%, environnement 25%, services 20%, démographie 15%, sécurité 10%).

Paramètres

Paramètre	Type	Description
`limit`	`integer`	Nombre de résultats
`offset`	`integer`	Décalage pour la pagination
`regione`	`string`	Filtrer par région
`min_pop`	`integer`	Population minimale
`max_pop`	`integer`	Population maximale

Essayer dans le navigateur

GET/api/qualita-vita/wizard

Assistant pour trouver les communes les plus adaptées selon les préférences personnelles.

Paramètres

Paramètre	Type	Description
`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`	Filtrer par région (optionnel)

Essayer dans le navigateur

⚖️ Comparer

Comparer les données de plusieurs communes simultanément.

GET/api/confronta

Comparer les données démographiques et de revenus de plusieurs communes.

Paramètres

Paramètre	Type	Description
`comuni`required	`string`	Codes ISTAT séparés par virgule (max 4)
`anno`	`integer`	Année de référence

Essayer dans le navigateur

GET/api/confronta/nazionale-medie

Retourne les moyennes nationales pour comparaison.

Paramètres

Paramètre	Type	Description
`anno`	`integer`	Année de référence (optionnel)

Essayer dans le navigateur

Exemples de Code

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

Limites & Cache

Utilisation équitable

L'API est gratuite pour un usage personnel et commercial. N'en abusez pas : si vous prévoyez >10k requêtes/jour, contactez-nous.

En-têtes Cache

Toutes les réponses incluent des en-têtes Cache-Control pour optimiser les performances :

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

Limitation du débit

Actuellement aucune limite stricte, mais les requêtes abusives seront bloquées. Utilisez l'en-tête If-None-Match pour les requêtes conditionnelles si votre client le supporte.