CRETHA Public API

Stranding-Daten sind als JSON über öffentliche REST-Endpoints abrufbar — für Forschung, Behörden, Datenjournalismus, NGO-Integrationen.

Keine API-Keys nötig für Read-Endpoints. Bitte respektiert das Rate-Limit von 60 Requests/Minute pro IP.

GET/api/strandings?limit=50

Liefert die letzten Stranding-Meldungen als JSON-Array.

Parameter

limitMax. Anzahl Datensätze (Default 50, Max 200)
statusFilter: new | active | resolved | all (optional)

Beispiel-Antwort (klicken)

{
  "strandings": [
    {
      "id": "uuid-1234",
      "species": "Buckelwal",
      "status": "active",
      "condition": 3,
      "latitude": 54.9,
      "longitude": 8.3,
      "location_name": "Sylt-Nord",
      "created_at": "2026-04-28T07:23:11Z",
      "x_posted_tweet_id": "1782891234"
    }
  ]
}

GET/api/rescue-ideas?top_public=1&this_month=1&limit=10

Top-bewertete Public-Ideen aus dem Tribunal-Briefkasten (sortiert nach Score).

Parameter

top_public1 = öffentliche Top-Liste
this_month1 = nur aktueller Monat (für Highscore-Board)
limitMax. Anzahl (Default 10)

Beispiel-Antwort (klicken)

{
  "ideas": [
    {
      "id": "uuid-5678",
      "idea_text": "Thermaldrohne zur Frueherkennung von Strandungen via KI-Bilderkennung.",
      "score": 85,
      "verdict_type": "go",
      "author_name": "Dennis",
      "created_at": "2026-04-28T06:10:04Z"
    }
  ]
}

GET/api/news?limit=20

News-Ticker mit RSS-Headlines zu Wal-Strandungen weltweit.

Parameter

limitMax. Anzahl (Default 20)

Beispiel-Antwort (klicken)

{
  "items": [
    {
      "id": "uuid-9012",
      "headline": "Buckelwal in der Kirchsee — Bergung soll heute starten",
      "source_name": "Ostsee Zeitung",
      "source_url": "https://...",
      "published_at": "2026-04-28T07:37:00Z"
    }
  ]
}

GET/api/regions Auth

12 vordefinierte Marine-Regionen (Nord-/Ostsee, Atlantik, Mittelmeer, ...) mit Bounding-Boxes.

Beispiel-Antwort (klicken)

{
  "regions": [
    { "id": "nordsee-de", "name": "Nordsee Deutschland", "bbox": [...] }
  ]
}

GET/api/water-weather-board?lat=54.9&lng=8.3

Marine Wetter- und Gezeiten-Daten für eine GPS-Position (Pegelonline + Open-Meteo).

Parameter

latBreitengrad (-90 bis 90)
lngLängengrad (-180 bis 180)

Beispiel-Antwort (klicken)

{
  "tide_now": "ablaufend",
  "next_high_tide_iso": "2026-04-28T14:33Z",
  "wave_height_m": 1.2,
  "water_temp_c": 8.4,
  "wind_speed_kn": 18
}

POST/api/strandings

Neue Stranding-Meldung einreichen. Triggert automatische KI-Plan-Generierung + Team-Alarmierung.

Parameter

BodyJSON mit species, latitude, longitude, condition (1-5), photo_url, reporter_name, reporter_email

Beispiel-Antwort (klicken)

POST /api/strandings
Content-Type: application/json

{
  "species": "Schweinswal",
  "latitude": 54.9,
  "longitude": 8.3,
  "condition": 3,
  "location_name": "Sylt-Nord",
  "reporter_name": "Erika Mustermann",
  "reporter_email": "erika@example.com"
}

→ 201 { "id": "uuid", "x_post_status": "queued" }

Wichtige Hinweise

• Rate-Limit: 60 Requests/Minute pro IP. Bei Überschreitung: HTTP 429.
• Datenqualität: Bürger-Meldungen sind unverifiziert bis Koordinator-Freigabe. Externes Source-Tag (source: 'claude_research' | 'strandednomore' | 'public') gibt Auskunft über Quellen-Verlässlichkeit.
• Wissenschaftliche Nutzung: Daten ohne unabhängige Verifikation NICHT für peer-reviewed Forschung verwenden.
• Schreib-Endpoints (POST/PATCH/DELETE) erfordern Koordinator-Login. Kontakt für Zugang: hilfe@cretha.live
• Lizenz: Daten unter CC BY-NC 4.0 — nichtkommerzielle Nutzung mit Quellenangabe „CRETHA — cretha.live".

Kooperation / Daten-Partnerschaft

Forschungsinstitute, Behörden oder NGOs, die strukturierten Datenaustausch wünschen (z. B. Webhook-basierte Push-Notifications neuer Strandungen, oder reverse Daten-Import in CRETHA), erreichen uns unter:

hilfe@cretha.live