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, Ergebnis und Stimmenverhältnis (namentliche Stimmen nur, wo der Rat sie veröffentlicht) |
| GET /api/v1/raadsleden | Ratsmitglieder — Filter nach Kommune, Fraktion oder Name |
| GET /api/v1/stemmen | Einzelne Stimmen — nur für Räte, die namentlich abstimmen; Filter nach Antrag, Ratsmitglied oder Kommune |
Filter
Unbekannte oder falsch geschriebene Parameter liefern eine Fehlermeldung (HTTP 422) mit den erlaubten Namen — nie stillschweigend eine ungefilterte Liste.
| gemeente | moties, raadsleden, stemmen | Gemeindeschlüssel (de:05315000), Name (Köln) oder Slug (koeln). Bei Namensgleichheit bekommst du die Kandidaten mit Schlüssel zurück. |
| q | gemeenten, moties, raadsleden | Suchbegriff (mindestens 2 Zeichen) in Titel oder Name. |
| type | moties | motie (Antrag) oder amendement (Änderungsantrag). |
| uitslag | moties | aangenomen (angenommen), verworpen (abgelehnt), ingetrokken (zurückgezogen) … |
| partij | moties, raadsleden | Fraktion des Einreichers bzw. Ratsmitglieds, z. B. SPD (Abdeckung nicht flächendeckend). |
| datum_van, datum_tot | moties | YYYY-MM-DD, einschließlich. Für „was ist neu seit gestern“ reicht datum_van. |
| actief | raadsleden | true oder false — nur amtierende Ratsmitglieder. |
| motie_id, raadslid_id | stemmen | Bei stemmen ist mindestens eines von motie_id, raadslid_id oder gemeente Pflicht. |
| limit, offset | alle | Paginierung; limit maximal 100 (moties), 200 (raadsleden), 500 (gemeenten, stemmen). |
Beispiel
curl "https://ratsblick.de/api/v1/moties?q=radweg&limit=5" \
-H "X-API-Key: rk_DEIN_KEY"Beispiel: neue Vorlagen einer Kommune seit einem Datum
curl "https://ratsblick.de/api/v1/moties?gemeente=K%C3%B6ln&datum_van=2026-09-01&limit=100" \
-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.