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

GET /api/v1/steu

Stations d'épuration (DERU) : conformité, capacité, boues, REUT, rejet, traitements, exploitant, communes raccordées.

• Filtres : ?dep=XX · ?insee=XXXXX · ?sandre=XXXXXXXXXXXX · ?bassin=XXX (Seine-Normandie, etc.)
• Exemples : ?dep=83 · ?insee=83053 · ?sandre=060983126001 (CAP SICIÉ)

GET /api/v1/deversoirs

Déversoirs d'orage : volumes rejetés temps de pluie, jours de déversement, charge DBO5, A1/R1.

• Filtres : ?dep=XX · ?sandre_steu=XXXXXXXXXXXX · ?annee=YYYY · ?top=N
• Exemples : ?dep=59 · ?top=20 (Top 20 nationaux)

GET /api/v1/poisson

Opérations IPR (Indice Poisson Rivière) : note, classe, espèces capturées, station, cours d'eau.

• Filtres : ?dep=XX · ?insee=XXXXX · ?station=XXX
• Exemples : ?dep=83 · ?insee=83142

GET /api/v1/onde

Observations d'écoulement (réseau ONDE de l'OFB) : assec, écoulement faible, normal.

• Filtres : ?dep=XX · ?insee=XXXXX · ?station=XXX
• Exemple : ?dep=30 (Gard, fortement touché par les assecs)

GET /api/v1/temperature

Stations de mesure de la température des cours d'eau en continu (Hub'Eau).

• Filtres : ?dep=XX · ?insee=XXXXX · ?cours=Loire
• Exemple : ?dep=83

GET /api/v1/littoral

Lieux de surveillance des eaux littorales (Ifremer). API en cours de décommissionnement (09/2026).

• Filtres : ?bbox=lng_min,lat_min,lng_max,lat_max · ?code=XXX
• Exemple : ?bbox=5.5,43,7.5,44 (côte PACA)

GET /api/v1/tendances NEW

10 séries pluriannuelles agrégées au niveau France : déversoirs (M m³, DBO5), boues, conformité ERU, IPR, ONDE, ARIA pollution eau, BNPE prélèvements, BNV-D pesticides, baignade.

• Filtres : ?serie=key1,key2 (par défaut : toutes)
• Clés disponibles : do_vol, do_dbo, boues, conformite_eru, ipr, onde, aria_eau, bnpe, pesticides, baignade_ok, climat_temp, climat_precip
• Exemples : /api/v1/tendances (toutes) · ?serie=ipr,onde

GET /api/v1/climat NEW

Évolution climatique 2010-aujourd'hui (température + précipitations) par commune, département ou France entière. Source Météo-France climathèque (4 500 stations quotidiennes). Pour chaque commune, la station la plus proche avec au moins 12 ans d'historique est sélectionnée (distance moyenne 11 km).

• Filtres : ?insee=XXXXX (commune) · ?dpt=XX (département) · ?france=1 (national) · ?top=N (top N par delta T°)
• Exemples : ?insee=87085 (Limoges) · ?dpt=75 · ?france=1 · ?top=25
• Source : Météo-France · climathèque quotidienne (Etalab 2.0)

GET /api/v1/norman NEW

Substances émergentes NORMAN SusDat × paramètres SISE-Eaux : toxicité aquatique (daphnie/algue/poisson), PNEC, logKow, propriétés physico-chimiques. Détection des dépassements de seuil sans effet écotoxique dans l'eau potable française.

• Filtres : ?cas=XXXX-XX-X (fiche par CAS) · ?cd=XXXX (par paramètre SISE) · ?alerte=1 (dépassements PNEC France) · ?toxic=25 (top N par toxicité)
• Exemples : ?cas=1912-24-9 (Atrazine) · ?cd=1107 · ?alerte=1 · ?toxic=25
• Source : NORMAN Network · SusDat

GET /api/v1/baignade NEW

Eaux de baignade : liste des sites ARS avec classement annuel (Excellente/Bonne/Suffisante/Insuffisante) + évolution pluriannuelle.

• Filtres : ?dep=XX · ?insee=XXXXX · ?bwid=XXX · ?bwid=XXX&resultats=1 · ?evol=fr · ?evol=dep&dep=XX
• Prélèvements détaillés : ?bwid=XXX&resultats=1 renvoie l'historique des analyses (date, E. coli, entérocoques en UFC/100mL, statut) saison par saison.
• Exemples : ?dep=44 · ?evol=fr · ?evol=dep&dep=83 · ?bwid=001743&resultats=1

🚦 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