API v1 — Beta

API CrueWatch

Intégrez les données hydrologiques françaises dans vos applications, tableaux de bord ou modèles de risque. Données issues de Hub'Eau / SCHAPI.

REST + JSONAuth par clé API2000+ stationsHistorique 7 jours

Limites par plan

Free
20 req/h
Pro
100 req/h
Max
1000 req/h

Besoin de plus ? Contactez-nous pour un plan entreprise avec SLA.

Endpoints

GET/api/v1/stations

Liste les stations hydrologiques. Filtrable par département.

curl "https://cruewatch.com/api/v1/stations?dept=69&limit=50" \
  -H "X-API-Key: crw_votre_clé"
Params : dept (code dép.), limit (max 500), offset
GET/api/v1/stations/:id/levels

Niveaux d'eau récents d'une station (jusqu'à 7 jours).

curl https://cruewatch.com/api/v1/stations/K437311001/levels?hours=24 \
  -H "X-API-Key: crw_votre_clé"

Réponse :

{
  "station": {
    "id": "K437311001",
    "name": "L'Isère à Grenoble",
    "commune": "Grenoble",
    "latitude": 45.188,
    "longitude": 5.724
  },
  "levels": [
    { "level_m": 1.234, "level_mm": 1234, "measured_at": "2026-04-28T10:00:00Z" },
    { "level_m": 1.251, "level_mm": 1251, "measured_at": "2026-04-28T10:15:00Z" }
  ],
  "meta": { "hours": 24, "count": 96 }
}
Params : hours (1–168, défaut 24)
GET/api/v1/stations/:id/alert

Niveau de vigilance Vigicrues le plus proche (1=Vert → 4=Rouge).

curl https://cruewatch.com/api/v1/stations/K437311001/alert \
  -H "X-API-Key: crw_votre_clé"

Widget & Badge

Widget iframe

Intégrez un widget interactif avec niveau en direct.

<iframe
  src="https://cruewatch.com/widget/K437311001"
  width="260" height="120"
  frameborder="0"
  style="border-radius:12px"
></iframe>

Badge HTML

Badge compact pour sites mairie ou presse.

<iframe
  src="https://cruewatch.com/badge/K437311001"
  width="220" height="50"
  frameborder="0"
  style="border:none"
></iframe>

Authentification

Passez votre clé dans le header X-API-Key. La clé est affichée une seule fois à la création — conservez-la.

X-API-Key: crw_votre_clé_ici

Vos clés API

Chargement…
Données sources :Hub'Eau (SCHAPI / BRGM), Vigicrues, Open-Meteo, GloFAS (Copernicus). CrueWatch ne produit pas de données hydrologiques — il agrège et enrichit des données publiques. Non destiné à remplacer les alertes officielles. Voir la méthode.