API-Dokumentation

Die zweitstimme.org API ermöglicht den Zugriff auf unsere Wahlprognosen und zugehörige Visualisierungen. Alle Endpunkte sind über HTTP GET-Anfragen erreichbar.

Basis-URL

http://polsci.uni-wh.de:8073

Endpunkte

Aktuelle Prognose

Endpunkt: /forecast
Methode: GET
Beschreibung: Liefert die aktuellen Wahlprognosen inklusive der 83% Konfidenzintervalle.

Beispielantwort:

json
[
  {
    "value": 30.2,
    "low": 24.6,
    "high": 35.8,
    "low95": 21.4,
    "high95": 39.9,
    "name": "CDU/CSU",
    "name_eng": "CDU/CSU",
    "color": "#000000",
    "y": 30.2,
    "x": 0,
    "_row": "cdu"
  },
...
]

Wahlkreisprognosen

Endpunkt: /forecast_districts
Methode: GET
Beschreibung: Liefert Prognosen für alle 299 Bundestagswahlkreise inklusive der 83% Konfidenzintervalle.

Beispielantwort:

[
  {
    "wkr": 1,
    "wkr_name": "Flensburg – Schleswig",
    "party": "afd",
    "partei": "AFD",
    "winner": 0,
    "probability": 0,
    "value": 8.7,
    "low": 7.1,
    "high": 10.2
  },
  ...
]

Letztes Update

Endpunkt: /last_updated
Methode: GET
Beschreibung: Gibt den Zeitstempel der letzten Aktualisierung zurück.

Beispielantwort:

{
"last_updated": "2024-01-20T12:00:00Z"
}

Prognose-Verteilung

Endpunkt: /draws
Methode: GET
Beschreibung: Liefert 10.000 Ziehungen aus der Prognoseverteilung für detaillierte statistische Analysen, je Partei ein Wert.

Beispielantwort:

[
  {
    "cdu": 0.3209,
    "afd": 0.1443,
    "spd": 0.161,
    "gru": 0.1475,
    "oth": 0.0629,
    "bsw": 0.0892,
    "fdp": 0.05,
    "lin": 0.0243
  },
  ...
]

Visualisierungen

Interaktive Grafik

Endpunkt: /interactive
Methode: GET
Beschreibung: Liefert eine interaktive HTML-Visualisierung der aktuellen Prognose.

Mobile Visualisierung

Endpunkt: /interactive_mobile
Methode: GET
Beschreibung: Optimierte Version der interaktiven Visualisierung für mobile Geräte.

Statische Grafiken

Hauptprognose

Endpunkt: /figure
Methode: GET
Format: PNG
Beschreibung: Statische Visualisierung der aktuellen Prognose.

PDF-Version

Endpunkt: /pdf
Methode: GET
Format: PDF
Beschreibung: PDF-Version der Prognose-Visualisierung.

Spezielle Visualisierungen

• /hurdle - Visualisierung der 5%-Hürde
• /majorities - Analyse möglicher Mehrheiten
• /winner - Prognose des Wahlsiegers

CORS

Die API unterstützt Cross-Origin Resource Sharing (CORS) und erlaubt Anfragen von allen Domains (*).

Fehlermeldungen

Bei nicht verfügbaren Ressourcen wird ein 404-Status zurückgegeben mit einer entsprechenden Fehlermeldung im JSON-Format.

Nutzungsbedingungen

Die API ist für nicht-kommerzielle Nutzung verfügbar. Bei Verwendung der Daten ist zweitstimme.org als Quelle anzugeben. Wir übernehmen keine Gewähr für die Verfügbarkeit und Richtigkeit der Daten.