Accueil › API

📦 API publique JSON sur la qualité de l'eau en France

API REST gratuite pour accéder programmatiquement aux données agrégées sur l'eau en France. Format JSON, pas de clé requise pour l'usage standard, CORS activé.

🚀 Démarrage rapide

# Récupérer les données complètes d'une commune
curl https://www.mon-eau.com/api/v1/commune/33063

# Récupérer juste le score eau composite
curl https://www.mon-eau.com/api/v1/score/33063

🗂️ Endpoints disponibles

GET /api/v1/commune/{code_insee}

Données complètes d'une commune (qualité, service eau, environnement, socio-éco, score).

• Paramètre : code_insee (5 chars, ex : 33063)
• Cache : 5 minutes
• Exemple : /api/v1/commune/33063

GET /api/v1/score/{code_insee}

Score eau composite (0-100) avec détails des 5 sous-indicateurs.

• Exemple : /api/v1/score/33063

🚦 Quotas

Plan	Tarif	Quota	Usage
Public (sans clé)	Gratuit	60 req/min · 1000 req/jour	Particuliers, démos, projets perso
Premium (clé API)	Sur devis	10 000 req/min · illimité/jour	Bureaux d'études, presse, dashboards pro

Demander un accès premium →

📋 Format de réponse

Toutes les réponses sont en JSON UTF-8. Headers CORS permissifs (Access-Control-Allow-Origin: *).

📜 Licence

Les données sont fournies sous licence CC BY 4.0. Vous devez créditer « Mon Eau » et respecter les licences des sources amont (ETALAB, ODbL, CC-BY-SA selon le dataset).

Voir /sources.php pour le détail.

🛠️ Exemple JavaScript (fetch)

fetch('https://www.mon-eau.com/api/v1/commune/33063')
  .then(r => r.json())
  .then(data => {
    console.log('Score :', data.score.value, '/', 100);
    console.log('Conformité :', data.qualite_eau.pct_conforme + '%');
    console.log('Prix m³ :', data.service_eau?.prix_eau_m3 + ' €');
  });

🧰 Exemple Python

import requests
r = requests.get('https://www.mon-eau.com/api/v1/commune/33063')
data = r.json()
print(f"{data['commune']['nom']} : score {data['score']['value']}/100")

🆘 Support

Question, bug, suggestion d'endpoint : eric@atypicom.fr