Kostenlose REST-API

Cyanoware API

Satellitenbasierte Wasserqualitätsdaten für über 1.892 Badeseen – kostenlos, kein API-Key erforderlich.

Kein API-KeySentinel-2 SatellitendatenWöchentlich aktualisiertDauerhaft kostenlos

Basis-URL

https://cyanoware-backend-production.up.railway.app

Badeseen

3 Endpunkte

GET/api/v1/bathing-lakes/status

Alle Seen – Status

Gibt alle deutschen EU-Badeseen mit aktuellem CHL-Wert, WHO-Warnstufe und Trophiestatus zurück. Daten werden wöchentlich per Sentinel-2 Satellit aktualisiert.

Kein API-Key erforderlich

Parameter

Name	Typ	Pflicht	Beschreibung
min_lat	float	nein	Minimale Breitengrad-Filtergrenze
max_lat	float	nein	Maximale Breitengrad-Filtergrenze
min_lon	float	nein	Minimale Längengrad-Filtergrenze
max_lon	float	nein	Maximale Längengrad-Filtergrenze
risk	string	nein	Filter: low \| medium \| high

Antwortfelder

Feld	Typ	Beschreibung
id	string	Interne See-ID (EU-Badegewässer-Code)
name	string	Offizieller Seename
lat / lon	float	Koordinaten des Seenzentrums
chl	float \| null	Chlorophyll-a in mg/m³ (Algenbiomasse)
who_level	int \| null	WHO-Warnstufe: 1 = Niedrig, 2 = Warnung, 3 = Alarm
cell_density_cells_ml	float \| null	Cyanobakterien-Zelldichte (Zellen/mL)
risk	string	Risikostufe: low \| medium \| high
color	string	Hex-Farbe für Kartenvisualisierung
measured_at	ISO 8601	Zeitstempel der letzten Satellitenmessung

Beispiel-Antwort

{
  "generated_at": "2026-08-18T06:00:00Z",
  "total_lakes": 1892,
  "lakes_with_data": 1784,
  "lakes": [
    {
      "id": "DEBB_PR_0123",
      "name": "Müggelsee",
      "lat": 52.44,
      "lon": 13.65,
      "chl": 18.5,
      "who_level": 2,
      "risk": "medium",
      "color": "#f59e0b",
      "trophic": "eutrophic",
      "cell_density_cells_ml": 24000,
      "measured_at": "2026-08-12T00:00:00Z"
    }
  ]
}

GET/api/v1/bathing-lakes/history/{lake_id}

See-Verlauf

Gibt den historischen CHL-Zeitreihenverlauf für einen einzelnen See zurück. Nützlich für Trendanalysen und Charts.

Kein API-Key erforderlich

Parameter

Name	Typ	Pflicht	Beschreibung
lake_id	string	ja	See-ID, z.B. DEBB_PR_0123
limit	integer	nein	Maximale Anzahl Einträge (Standard: 104)

Antwortfelder

Feld	Typ	Beschreibung
lake_id	string	See-ID
history[].date	ISO 8601	Datum der Messung
history[].chl	float \| null	Chlorophyll-a in mg/m³
history[].who_level	int \| null	WHO-Warnstufe
history[].data_type	string	"satellite" oder "ai_forecast"

Beispiel-Antwort

{
  "lake_id": "DEBB_PR_0123",
  "name": "Müggelsee",
  "history": [
    {
      "date": "2026-08-12",
      "chl": 18.5,
      "who_level": 2,
      "cell_density_cells_ml": 24000,
      "data_type": "satellite"
    },
    {
      "date": "2026-08-05",
      "chl": 15.2,
      "who_level": 1,
      "cell_density_cells_ml": 12000,
      "data_type": "satellite"
    },
    {
      "date": "2026-07-29",
      "chl": 21,
      "who_level": 2,
      "cell_density_cells_ml": 31000,
      "data_type": "ai_forecast"
    }
  ]
}

GET/api/v1/bathing-lakes/geojson

GeoJSON Karte

Gibt alle Seen als GeoJSON FeatureCollection zurück – direkt verwendbar in Mapbox, Leaflet, MapLibre, QGIS oder jeder anderen kartenfähigen Applikation.

Kein API-Key erforderlich

Antwortfelder

Feld	Typ	Beschreibung
type	string	Immer "FeatureCollection"
features[].geometry	GeoJSON Point	Koordinaten [lon, lat]
features[].properties	object	id, name, chl, who_level, color, risk

Beispiel-Antwort

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          13.65,
          52.44
        ]
      },
      "properties": {
        "id": "DEBB_PR_0123",
        "name": "Müggelsee",
        "chl": 18.5,
        "who_level": 2,
        "color": "#f59e0b"
      }
    }
  ]
}

Code-Beispiele

Alle Endpunkte sind ohne API-Key zugänglich. Direkt kopieren und loslegen.

JavaScript / TypeScript

const res = await fetch('https://cyanoware-backend-production.up.railway.app/api/v1/bathing-lakes/status')
const data = await res.json()
console.log(data.lakes)

Python

import requests

res = requests.get('https://cyanoware-backend-production.up.railway.app/api/v1/bathing-lakes/status')
lakes = res.json()['lakes']
print(f"{len(lakes)} lakes loaded")

MapLibre / Mapbox — Heatmap Layer

map.addSource('cyanoware-tiles', {
  type: 'raster',
  tiles: ['https://cyanoware-backend-production.up.railway.app/api/v1/tiles/{z}/{x}/{y}.png'],
  tileSize: 256
})
map.addLayer({ id: 'chl-heatmap', type: 'raster', source: 'cyanoware-tiles' })

Daten basieren auf Copernicus Sentinel-2 MSI · WHO Recreational Water Guidelines (2003) · Wöchentliche Aktualisierung