AI Agents & API
Strukturierte Daten für Recherche, Vergleiche und eigene Anwendungen.
Alle Zugänge sind öffentlich, kostenfrei und lesend. Es ist kein API-Key erforderlich. Verfügbar sind aktuelle Umfragezahlen für Deutschland und die Länder, vollständige Wahltermine, Gesamtwahlergebnisse, Abgeordnete und Mandatswechsel. Wahlkreisergebnisse und gebündelte Wahlkreis-Wahldaten sind über diese Schnittstelle nicht verfügbar.
Discovery
- AI Catalog 1.0 — auch unter /ai-catalog.json. Der HTML-Head verlinkt ihn mit
rel="ai-catalog". - Tool-Manifest mit JSON Schemas und HTTP Discovery.
- llms.txt beschreibt die Seitenstruktur.
WebMCP im Browser
Auf jeder Seite registriert wahl.de die unten aufgeführten Tools über document.modelContext.registerTool. Frühe Implementierungen mit navigator.modelContext werden ebenfalls erkannt. WebMCP ist ein experimenteller Browserstandard und benötigt HTTPS (lokal localhost) sowie einen kompatiblen Browser und Agent. Ohne WebMCP bleibt der HTTP-Zugang verfügbar.
const tools = await document.modelContext.getTools();
const tool = tools.find(t => t.name === "wahl_get_poll_trend");
const result = await document.modelContext.executeTool(tool, {
region: "Deutschland"
});Die Tools liefern JSON-Objekte direkt zurück. Abbruchsignale werden an den HTTP-Abruf weitergegeben. Dies ist eine WebMCP-Integration und eine HTTP JSON API; die HTTP-URL ist kein MCP-JSON-RPC-Server.
HTTP JSON
GET /api/ai liefert sämtliche Toolnamen und Eingabeschemas. Aufruf: GET /api/ai/{tool}?input={JSON} (URL-kodiert) oder POST /api/ai/{tool} mit Content-Type: application/json und den Parametern direkt als Body. CORS erlaubt lesende Abrufe von anderen Origins.
curl -G 'https://www.wahl.de/api/ai/wahl_get_poll_trend' --data-urlencode 'input={"region":"Deutschland"}'
curl 'https://www.wahl.de/api/ai/wahl_get_election_result' -H 'Content-Type: application/json' -d '{"electionId":"btw-25"}'Erfolgreiche Antworten enthalten tool, data, retrievedAt, documentationUrl und sourcesUrl. Der Abrufzeitpunkt ist kein Aktualisierungsdatum: Angaben wie updated, date, status und source im Datensatz bestimmen den Datenstand.
Listen mit offset/limit beginnen bei 0; Standard: 50, Maximum: 100. data.pagination enthält total, nextOffset und bei verschachtelten Listen collection. Bei einer einfachen Liste liegen die Einträge unter data.items, sonst unter dem angegebenen Feld. Der Wahlkalender und das Gesamtergebnis einer Wahl werden vollständig geliefert und verwenden keine Pagination.
Fehler liefern ein JSON-Objekt mit error: 400 für ungültige Parameter, 404 für unbekannte Tools oder fehlende Daten, 405 für nicht unterstützte Methoden, 413 für zu große Anfragen, 415 für falschen Content-Type und 502 für einen Datenladefehler. Unbekannte Parameter werden abgewiesen.
Live-Beispiel
Tools und Parameter
15 Tools erschließen sieben Datenbereiche: aktuelle Umfragezahlen (mit Regionsliste), vollständige Termine, Gesamtwahlergebnisse (mit Wahlindex und Historie), Abgeordnete (Liste und Einzelprofil), Mandatswechsel (Wahlperioden, einzelne Periode und Gesamtliste), Suche und Orte (Volltextsuche, Ortsprofil mit Wahlkreisen, Orte je Wahlkreis) sowie das Glossar. HTTP und WebMCP verwenden dieselbe Freigabeliste. Andere Toolnamen werden mit 404 abgewiesen. Wahlkreis-Wahldaten sind ausgeschlossen. Abgeordnete und Mandatswechsel verlinken mit profileUrl auf die kanonischen Seiten unter /politiker/{partei}/{name}.
Beginne mit wahl_list_regions, wahl_list_elections und wahl_get_parliament, um gültige Regionnamen, Wahl- und Personen-IDs zu erhalten. Bei level="mdl" ist zusätzlich landSlug erforderlich. Für Mandatswechsel liefert wahl_list_mandate_periods die gültigen Parlamente und Wahlperioden. Orts-Slugs liefert wahl_search (URL /ort/{slug}); Glossar-Slugs liefert wahl_get_glossary ohne Parameter.
wahl_list_regions
Verfügbare Regionen und ihre Slugs.
{}Vollständiges Eingabeschema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}wahl_get_poll_trend
So würde die Region aktuell wählen: ausschließlich aktuelle gewichtete Parteianteile, letzter Umfragestand und Quellen. Keine Einzelumfragen, Zeitreihen oder historischen Vergleichswerte.
region(string, erforderlich): Name der Region. Europa kann je nach Datenbestand keine Umfragen besitzen. Werte: Deutschland, Europa, Baden-Württemberg, Bayern, Berlin, Brandenburg, Bremen, Hamburg, Hessen, Mecklenburg-Vorpommern, Niedersachsen, Nordrhein-Westfalen, Rheinland-Pfalz, Saarland, Sachsen, Sachsen-Anhalt, Schleswig-Holstein, Thüringen.
{
"region": "Deutschland"
}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"region": {
"type": "string",
"description": "Name der Region. Europa kann je nach Datenbestand keine Umfragen besitzen.",
"enum": [
"Deutschland",
"Europa",
"Baden-Württemberg",
"Bayern",
"Berlin",
"Brandenburg",
"Bremen",
"Hamburg",
"Hessen",
"Mecklenburg-Vorpommern",
"Niedersachsen",
"Nordrhein-Westfalen",
"Rheinland-Pfalz",
"Saarland",
"Sachsen",
"Sachsen-Anhalt",
"Schleswig-Holstein",
"Thüringen"
]
}
},
"required": [
"region"
],
"additionalProperties": false
}wahl_get_calendar
Vollständiger Wahlkalender mit allen vergangenen und kommenden Terminen, Datum, Fristen und Quellenhinweisen; optional für ein Land. Keine Pagination.
landSlug(string, optional): Land-Slug; für Landesabfragen erforderlich. Werte: baden-wuerttemberg, bayern, berlin, brandenburg, bremen, hamburg, hessen, mecklenburg-vorpommern, niedersachsen, nordrhein-westfalen, rheinland-pfalz, saarland, sachsen, sachsen-anhalt, schleswig-holstein, thueringen.
{}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"landSlug": {
"type": "string",
"description": "Land-Slug; für Landesabfragen erforderlich.",
"enum": [
"baden-wuerttemberg",
"bayern",
"berlin",
"brandenburg",
"bremen",
"hamburg",
"hessen",
"mecklenburg-vorpommern",
"niedersachsen",
"nordrhein-westfalen",
"rheinland-pfalz",
"saarland",
"sachsen",
"sachsen-anhalt",
"schleswig-holstein",
"thueringen"
]
}
},
"required": [],
"additionalProperties": false
}wahl_get_parliament
Abgeordnete eines Parlaments mit Personen-ID und Profilangaben, paginiert. Keine Wahlkreis-Wahldaten oder Stimmenanteile.
level(string, erforderlich): Parlamentsebene. Werte: mdb, mdl.landSlug(string, optional): Land-Slug; für Landesabfragen erforderlich. Werte: baden-wuerttemberg, bayern, berlin, brandenburg, bremen, hamburg, hessen, mecklenburg-vorpommern, niedersachsen, nordrhein-westfalen, rheinland-pfalz, saarland, sachsen, sachsen-anhalt, schleswig-holstein, thueringen.offset(integer, optional): Startposition, Standard 0.limit(integer, optional): Seitengröße, Standard 50, maximal 100.
{
"level": "mdb"
}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"level": {
"type": "string",
"description": "Parlamentsebene.",
"enum": [
"mdb",
"mdl"
]
},
"landSlug": {
"type": "string",
"description": "Land-Slug; für Landesabfragen erforderlich.",
"enum": [
"baden-wuerttemberg",
"bayern",
"berlin",
"brandenburg",
"bremen",
"hamburg",
"hessen",
"mecklenburg-vorpommern",
"niedersachsen",
"nordrhein-westfalen",
"rheinland-pfalz",
"saarland",
"sachsen",
"sachsen-anhalt",
"schleswig-holstein",
"thueringen"
]
},
"offset": {
"type": "integer",
"description": "Startposition, Standard 0.",
"minimum": 0
},
"limit": {
"type": "integer",
"description": "Seitengröße, Standard 50, maximal 100.",
"minimum": 1,
"maximum": 100
}
},
"required": [
"level"
],
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"level": {
"const": "mdl"
}
},
"required": [
"level"
]
},
"then": {
"required": [
"landSlug"
]
}
}
]
}wahl_get_member
Profil eines Abgeordneten anhand der Personen-ID aus wahl_get_parliament. Keine Wahlkreis-Wahldaten oder Stimmenanteile.
id(string, erforderlich): Stabile Personen-ID.level(string, erforderlich): Parlamentsebene. Werte: mdb, mdl.landSlug(string, optional): Land-Slug; für Landesabfragen erforderlich. Werte: baden-wuerttemberg, bayern, berlin, brandenburg, bremen, hamburg, hessen, mecklenburg-vorpommern, niedersachsen, nordrhein-westfalen, rheinland-pfalz, saarland, sachsen, sachsen-anhalt, schleswig-holstein, thueringen.
{
"id": "p_abc",
"level": "mdb"
}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stabile Personen-ID.",
"pattern": "^p_[a-z2-7]+$",
"maxLength": 100
},
"level": {
"type": "string",
"description": "Parlamentsebene.",
"enum": [
"mdb",
"mdl"
]
},
"landSlug": {
"type": "string",
"description": "Land-Slug; für Landesabfragen erforderlich.",
"enum": [
"baden-wuerttemberg",
"bayern",
"berlin",
"brandenburg",
"bremen",
"hamburg",
"hessen",
"mecklenburg-vorpommern",
"niedersachsen",
"nordrhein-westfalen",
"rheinland-pfalz",
"saarland",
"sachsen",
"sachsen-anhalt",
"schleswig-holstein",
"thueringen"
]
}
},
"required": [
"id",
"level"
],
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"level": {
"const": "mdl"
}
},
"required": [
"level"
]
},
"then": {
"required": [
"landSlug"
]
}
}
]
}wahl_list_elections
Index der verfügbaren Wahlergebnisse mit Wahl-IDs, Daten und Seitenpfaden.
offset(integer, optional): Startposition, Standard 0.limit(integer, optional): Seitengröße, Standard 50, maximal 100.
{}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"offset": {
"type": "integer",
"description": "Startposition, Standard 0.",
"minimum": 0
},
"limit": {
"type": "integer",
"description": "Seitengröße, Standard 50, maximal 100.",
"minimum": 1,
"maximum": 100
}
},
"required": [],
"additionalProperties": false
}wahl_get_election_result
Gesamtergebnis einer Wahl mit Quelle, Status, Beteiligung und Mandaten. Ausschließlich Bundes-/Landesaggregate; keine Wahlkreise, Bezirke, Geometrien oder Direktgewinnerlisten.
electionId(string, erforderlich): Wahl-ID aus wahl_list_elections, z. B. btw-25.
{
"electionId": "btw-25"
}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"electionId": {
"type": "string",
"description": "Wahl-ID aus wahl_list_elections, z. B. btw-25.",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 80
}
},
"required": [
"electionId"
],
"additionalProperties": false
}wahl_get_election_history
Landesweite historische Ergebniszeitreihe einschließlich Quellen.
landSlug(string, erforderlich): deutschland oder Land-Slug. Werte: deutschland, baden-wuerttemberg, bayern, berlin, brandenburg, bremen, hamburg, hessen, mecklenburg-vorpommern, niedersachsen, nordrhein-westfalen, rheinland-pfalz, saarland, sachsen, sachsen-anhalt, schleswig-holstein, thueringen.
{
"landSlug": "deutschland"
}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"landSlug": {
"type": "string",
"description": "deutschland oder Land-Slug.",
"enum": [
"deutschland",
"baden-wuerttemberg",
"bayern",
"berlin",
"brandenburg",
"bremen",
"hamburg",
"hessen",
"mecklenburg-vorpommern",
"niedersachsen",
"nordrhein-westfalen",
"rheinland-pfalz",
"saarland",
"sachsen",
"sachsen-anhalt",
"schleswig-holstein",
"thueringen"
]
}
},
"required": [
"landSlug"
],
"additionalProperties": false
}wahl_list_mandate_periods
Verfügbare Parlamente und Wahlperioden für Mandatswechsel, einschließlich Anzahl und letztem Wechsel.
{}Vollständiges Eingabeschema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}wahl_get_mandate_changes
Mandatswechsel einer Wahlperiode: ausgeschiedene Personen, Nachfolger, Gründe, Datum und Quellen. Keine Wahlkreis-Wahldaten.
parlament(string, erforderlich): Parlament aus wahl_list_mandate_periods. Werte: bundestag, baden-wuerttemberg, bayern, berlin, brandenburg, bremen, hamburg, hessen, mecklenburg-vorpommern, niedersachsen, nordrhein-westfalen, rheinland-pfalz, saarland, sachsen, sachsen-anhalt, schleswig-holstein, thueringen.periode(integer, erforderlich): Wahlperiode aus wahl_list_mandate_periods.
{
"parlament": "bundestag",
"periode": 21
}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"parlament": {
"type": "string",
"description": "Parlament aus wahl_list_mandate_periods.",
"enum": [
"bundestag",
"baden-wuerttemberg",
"bayern",
"berlin",
"brandenburg",
"bremen",
"hamburg",
"hessen",
"mecklenburg-vorpommern",
"niedersachsen",
"nordrhein-westfalen",
"rheinland-pfalz",
"saarland",
"sachsen",
"sachsen-anhalt",
"schleswig-holstein",
"thueringen"
]
},
"periode": {
"type": "integer",
"description": "Wahlperiode aus wahl_list_mandate_periods.",
"minimum": 1,
"maximum": 100
}
},
"required": [
"parlament",
"periode"
],
"additionalProperties": false
}wahl_list_mandate_changes
Mandatswechsel aller verfügbaren Parlamente, neueste zuerst, paginiert. Keine Wahlkreis-Wahldaten.
offset(integer, optional): Startposition, Standard 0.limit(integer, optional): Seitengröße, Standard 50, maximal 100.
{
"limit": 50
}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"offset": {
"type": "integer",
"description": "Startposition, Standard 0.",
"minimum": 0
},
"limit": {
"type": "integer",
"description": "Seitengröße, Standard 50, maximal 100.",
"minimum": 1,
"maximum": 100
}
},
"required": [],
"additionalProperties": false
}wahl_search
Volltextsuche über Orte (inkl. PLZ), Wahlkreise, Personen, Parteien, Glossarbegriffe und Institute. Liefert Treffer mit Typ, Label, kanonischer URL und Kurzinfo, sortiert nach Relevanz.
q(string, erforderlich): Suchbegriff, mindestens 2 Zeichen (Ort, PLZ, Name, Begriff).type(string, optional): Optional: nur diesen Treffertyp. Werte: ort, wahlkreis, person, partei, begriff, institut.limit(integer, optional): Maximale Trefferzahl (Standard 10).
{
"q": "Altena",
"type": "ort"
}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Suchbegriff, mindestens 2 Zeichen (Ort, PLZ, Name, Begriff).",
"minLength": 2,
"maxLength": 80
},
"type": {
"type": "string",
"description": "Optional: nur diesen Treffertyp.",
"enum": [
"ort",
"wahlkreis",
"person",
"partei",
"begriff",
"institut"
]
},
"limit": {
"type": "integer",
"description": "Maximale Trefferzahl (Standard 10).",
"minimum": 1,
"maximum": 25
}
},
"required": [
"q"
],
"additionalProperties": false
}wahl_get_place
Ortsprofil: Name, Bundesland, Landkreis bzw. kreisfreie Stadt, PLZ sowie die zugehörigen Bundestags- und Landtagswahlkreise (Nummer, Name, URL). Enthält keine Wahlergebnisse; den Slug liefert wahl_search (URL /ort/{slug}).
slug(string, erforderlich): Orts-Slug aus der Ortsseite /ort/{slug}.
{
"slug": "altena"
}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Orts-Slug aus der Ortsseite /ort/{slug}.",
"pattern": "^[a-z0-9-]+$",
"maxLength": 100
}
},
"required": [
"slug"
],
"additionalProperties": false
}wahl_get_wahlkreis_places
Alphabetische Liste der Orte, die ganz oder teilweise in einem Bundestags- oder Landtagswahlkreis liegen (mit Link auf die Ortsseite).
layer(string, erforderlich): bt = Bundestagswahlkreis, lt = Landtagswahlkreis (dann landSlug erforderlich). Werte: bt, lt.wkr(integer, erforderlich): Wahlkreisnummer.landSlug(string, optional): Bundesland-Slug, nur für layer=lt (z. B. nordrhein-westfalen).
{
"layer": "bt",
"wkr": 1
}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"layer": {
"type": "string",
"description": "bt = Bundestagswahlkreis, lt = Landtagswahlkreis (dann landSlug erforderlich).",
"enum": [
"bt",
"lt"
]
},
"wkr": {
"type": "integer",
"description": "Wahlkreisnummer.",
"minimum": 1,
"maximum": 400
},
"landSlug": {
"type": "string",
"description": "Bundesland-Slug, nur für layer=lt (z. B. nordrhein-westfalen).",
"pattern": "^[a-z-]+$",
"maxLength": 40
}
},
"required": [
"layer",
"wkr"
],
"additionalProperties": false
}wahl_get_glossary
Glossar zu Umfragen, Wahlen, Mandaten und Personen: mit slug ein Begriff (Kurzdefinition, Erklärtext, verwandte Begriffe, Links), ohne slug die Liste aller Begriffe (optional nach Thema gefiltert).
slug(string, optional): Begriffs-Slug, z. B. zweitstimmendeckung. Ohne Angabe: Liste.thema(string, optional): Nur für die Liste: Themenfilter. Werte: umfragen, wahlen, mandate, personen.
{
"thema": "wahlen"
}Vollständiges Eingabeschema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Begriffs-Slug, z. B. zweitstimmendeckung. Ohne Angabe: Liste.",
"pattern": "^[a-z0-9-]+$",
"maxLength": 60
},
"thema": {
"type": "string",
"description": "Nur für die Liste: Themenfilter.",
"enum": [
"umfragen",
"wahlen",
"mandate",
"personen"
]
}
},
"required": [],
"additionalProperties": false
}Daten richtig verwenden
Die Umfrageantwort enthält nur aktuelle gewichtete Prozentwerte unter data.values, den Stichtag und das Datum der jüngsten zugrunde liegenden Umfrage. Einzelumfragen, historische Umfrageverläufe und Vergleichsdeltas werden nicht ausgegeben. Umfragen sind keine Wahlergebnisse oder Vorhersagen. Der Trend verwendet dieselbe Alters- und Fallzahlgewichtung wie die Website; Streuungsbänder sind keine Konfidenzintervalle. Für Live-Ergebnisse müssen Auszählungsstand, Status und Ergebnisqualität mit angegeben werden. Historische Prozentreihen können synthetische Stimmen für die Darstellung enthalten; diese sind keine amtlichen absoluten Stimmenzahlen. Fehlende Datensätze bedeuten keine Nullwerte.
Quellen- und Lizenzhinweise im Ergebnis sowie auf /quellen beachten und bei Weiterverwendung angeben. Die Schnittstelle vergibt keine zusätzlichen Nutzungsrechte an Fremddaten.
Implementiert nach dem AI Catalog 1.0 Draft und dem WebMCP Draft, geprüft am 3. Oktober 2026. Beide Spezifikationen können sich noch ändern.