Entwickler-API
Öffentliche, kostenlose Schnittstelle zu den aufbereiteten Bundestags-Daten
Überblick
Alle hier dargestellten Inhalte stehen über eine öffentliche, versionierte REST-API zur Verfügung. Die API richtet sich an Civic-Tech-, Journalismus- und Bildungsprojekte, die die Parlamentsdaten des Deutschen Bundestages maschinenlesbar weiterverwenden möchten. Die Nutzung ist kostenlos.
Basis-URL
Alle Endpunkte sind unter dem versionierten Pfad /api/v1 erreichbar:
https://politik-einfach-erklaert.de/api/v1Authentifizierung
Die Lese-Endpunkte sind öffentlich und benötigen keine Authentifizierung und keinen API-Schlüssel. Nur die Verwaltungs-, Konto- und Ingestion-Endpunkte sind geschützt und nicht für Drittanbieter gedacht.
Antwortformat
Listen- und Detail-Antworten verwenden eine einheitliche Hülle aus data (Inhalt) und meta (Paginierungsinformationen):
{ "data": ..., "meta": { "total": 123, "page": 1, "per_page": 20 } }Paginierung
Listen-Endpunkte akzeptieren die Query-Parameter page (Standard 1) und per_page (Standard 20). Die Gesamtzahl der Treffer steht in meta.total.
Rate Limiting
Zum Schutz vor Missbrauch gilt ein IP-basiertes Rate Limiting. Die öffentlichen Lese-Endpunkte sind derzeit nicht gedrosselt; bitte gehen Sie dennoch sparsam mit Anfragen um. Wird ein Limit überschritten, antwortet die API mit dem Statuscode 429.
Beispiel
Anfrage:
GET https://politik-einfach-erklaert.de/api/v1/debates?page=1&per_page=2Antwort (gekürzt):
{
"data": [
{
"id": 123,
"title": "Entwurf eines Gesetzes zur Steuersenkung",
"session_date": "2026-01-15",
"has_vote": true,
"vote_result": "passed"
}
],
"meta": { "total": 842, "page": 1, "per_page": 2 }
}Interaktive Dokumentation
Die vollständige, stets aktuelle Referenz aller Endpunkte (inklusive Parameter und Antwortschemata) finden Sie als OpenAPI- Dokumentation:
Nutzungsbedingungen
Die Parlamentsdaten stammen aus offenen Quellen des Deutschen Bundestages und dürfen frei verwendet werden. Bitte beachten Sie die rechtlichen Hinweise und Kontaktangaben im Impressum.