Open Data & API

Alle Ratsinformationen auf dieser Plattform sind als offene Daten nutzbar: über eine kostenlose JSON-API und als wöchentliche Bulk-Downloads. Für Journalismus, Forschung, Apps oder eigene Analysen.

Die Daten stammen aus öffentlichen Quellen und werden täglich aktualisiert. Ein API-Key ist kostenlos und schnell beantragt.

Kostenlosen API-Key beantragen

Formular ausfüllen — der Key kommt direkt per E-Mail.

Fair Use: 60 Requests pro Minute, 5.000 pro Tag. Mehr nötig (z. B. strukturelle oder kommerzielle Abnahme)? Schreib uns eine E-Mail.

Endpoints

Alle Endpoints sind read-only JSON. Key als X-API-Key-Header oder ?api_key=-Parameter mitsenden.

GET /api/v1/gemeenten	Alle Kommunen (Name, Einwohner, Datenniveau)
GET /api/v1/moties	Anträge und Beschlüsse — Filter nach Kommune, Suchbegriff, Typ, Ergebnis, Datum
GET /api/v1/moties/{id}	Ein Antrag vollständig: Text, Einreicher und Abstimmungsverhalten
GET /api/v1/raadsleden	Ratsmitglieder — Filter nach Kommune, Fraktion oder Name
GET /api/v1/stemmen	Einzelne Stimmen — Filter nach Antrag, Ratsmitglied oder Kommune

Beispiel

curl "https://ratsblick.de/api/v1/moties?q=radweg&limit=5" \
  -H "X-API-Key: rk_DEIN_KEY"

Interaktive API-Dokumentation (Swagger) — Endpoints direkt im Browser ausprobieren →

Bulk-Downloads

Wöchentlich aktualisierte CSV-Dateien (gzip) mit dem vollständigen Datensatz dieser Seite — ohne Key:

Bedingungen

Die Daten stammen aus öffentlichen Quellen. Nutzung frei mit Quellenangabe („Ratsblick“ mit Link). Zurückhaltung bei personenbezogenen Daten von Ratsmitgliedern außerhalb ihrer öffentlichen Funktion. Keine Gewähr auf Vollständigkeit; die offizielle Quelle ist maßgeblich.