API

/api/tops

Anfrage der Tagesordnungspunkte

Die Suche Kann zusätzlich über einee Liste von Parametern gefiltert werden. Die Filterung ist additiv, es müssen also alle eingestellten Filter erfüllt sein. Einträge für den gleichen Filter kommen einfach doppelt vor Mögliche Suchfilter sind:

Parameter	Bedeutung
search	Suchfilter für den Volltext aller Reden und Äußerungen der verschschiedenen Tagesordnungspunkte
people	MdB die zu den TOPs gesprochen haben müssen
years	Eingrenzung des Zeitraums anhand des Jahres
categories	Eingrenzung auf spezielle Kategorien

Ein Request könnte sein:

/api/tops/?people=alexander-dobrindt&people=oliver-krischer&search=Abgasskandal

Um Nur Tops...

• ... in denen das Wort Abgasskandal vorkommt
• ... zu denen sowohl Alexander Dobrindt als auch Oliver Krischer gesprochen

zu erhalten

Return: Kategorie, Name, TOP Bezeichner, Title

Beispiel:

  "data": [
    {
      "session": {
        "date": "Tue, 22 Oct 2013 00:00:00 GMT",
        "sitzung": 1,
        "wahlperiode": 18
      },
      "tops": [
        {
          "categories": [],
          "name": "Sitzungser\u00f6ffnung",
          "session_identifier": "TOP ZP",
          "title": "TOP ZP  Sitzungser\u00f6ffnung"
        },
        {
          "categories": [],
          "name": "Sitzungser\u00f6ffnung durch den Alterspr\u00e4sidenten",
          "session_identifier": "TOP 1",
          "title": "TOP 1 Sitzungser\u00f6ffnung durch den Alterspr\u00e4sidenten"
        },
        {
          "categories": [
            "Staat und Verwaltung"
          ],
          "name": "Wahl des Bundestagspr\u00e4sidenten",
          "session_identifier": "TOP 2",
          "title": "TOP 2 Wahl des Bundestagspr\u00e4sidenten"
        }
      ]
   }
 ]

/api/speakers

Anfrage alle MdBs die in den Protokollen auftauchen

Return: Alter, Beruf, Bild (URL von bundestag.de), Name, Fraktion Beispiel:

{
  "data": [
    {
      "age": 58,
      "education": "Diplom-Soziologe",
      "picture": "https://www.bundestag.de/blueprint/servlet/image/241440/Hochformat__2x3/177/265/ee8a7dc2b26a3d8a47e48999a8402f03/VW/post_achim_gross.jpg",
      "speaker_cleaned": "Achim Post",
      "speaker_fp": "achim-post",
      "speaker_name": "Achim Post (Minden) (SPD)",
      "speaker_party": "spd"
    },
    {
      "age": 32,
      "education": "Studium der Politikwissenschaft, des \u00d6ffentlichen Rechts und der Philosophie (M.A.)",
      "picture": "https://www.bundestag.de/blueprint/servlet/image/240812/Hochformat__2x3/177/265/6a2506c3f22c50ecd983b78c3a9d64a9/In/brugger_agnieszka_gross.jpg",
      "speaker_cleaned": "Agnieszka Brugger",
      "speaker_fp": "agnieszka-brugger",
      "speaker_name": "Agnieszka Brugger (B\u00dcNDNIS 90/DIE GR\u00dcNEN)",
      "speaker_party": "gruene"
    },
    ...

/api/session/int:session_id

Alle Redebeiträge einer Sitzung. Für jeden Zwischenruf gibt es einen eigenen Eintrag. Reden können über mehrere Einträge verteilt sein (wenn z.B. zwischengerufen wird)

Return:

Key	Beschreibung
id	interner identifier
profile_url	bild des Sprechers von bundestag.de
sequence	Sequenznummer des Redebeitrags in der aktuellen Sitzung
sitzung	Nummer der Sitzung in der Wahlperiode
speaker	Name des Sprechers, wie er exakt im Protokoll vermerkt ist
speaker_cleaned	bereinigte Version des Sprechernamens (z.B. ohne Amtstitel)
speaker_fp	normierte Form des Sprechernamens (lowercase, vorname-nachname)
speaker_key	interne nummer des Sprechers zu Abfrage von zusätzlichen Infos
speaker_party	Fraktion, der der Sprecher angehört
text	Inhalt der Rede/des Zwischenrufs
top	Komplettbezeichnung des Tagesordnungspunktes, der besprochen wird
top_id	identifier des tagesordnungspunktes
type	Gibt an um was es sich bei diesem Redebeitrag handelt: chair (Rede des Vorsitzenden), speech (Rede eines Abgeordneten), poi (Zwischenruf oder Reaktion des Plenums wie z.B. Applaus)
wahlperiode	Wahlperiode in der die Sitzung stattfand

Beispiel:

{
  "data": [
    {
      "id": 660508,
      "profile_url": "https://www.abgeordnetenwatch.de/profile/norbert-lammert",
      "sequence": 0,
      "sitzung": 10,
      "speaker": "Pr\u00e4sident Dr. Norbert Lammert",
      "speaker_cleaned": "Dr. Norbert Lammert",
      "speaker_fp": "norbert-lammert",
      "speaker_key": 1754,
      "speaker_party": null,
      "text": "Die Sitzung ist er\u00f6ffnet. Nehmen Sie bitte Platz.\n\nLiebe Kolleginnen und Kollegen, ich begr\u00fc\u00dfe Sie alle herzlich und m\u00f6chte Ihnen vor Eintritt in unsere Tagesordnung mitteilen, dass interfraktionell vereinbart wurde, die Aussprache zum Tagesordnungspunkt 1, also Au\u00dfenpolitik, Europa und Menschenrechte, im Anschluss an die Regierungserkl\u00e4rung im Umfang von 60 Minuten nicht, wie urspr\u00fcnglich vorgesehen, mit den Tagesordnungspunkten 2 und 3 zu verbinden. Damit werden die Bundeswehreins\u00e4tze im Rahmen der Mandate OAF und OAE gesondert nach dem Tagesordnungspunkt 1 beraten. Die Dauer der Debatte soll f\u00fcr diese beiden Punkte jeweils 25 Minuten betragen.\n\nAu\u00dferdem ist interfraktionell vereinbart worden, den Tourismuspolitischen Bericht der Bundesregierung aus der 17. Legislaturperiode auf der Drucksache 17/13674 federf\u00fchrend dem Ausschuss f\u00fcr Tourismus und zur Mitberatung dem Ausschuss f\u00fcr Wirtschaft und Energie, dem Ausschuss f\u00fcr Familie, Senioren, Frauen und Jugend, dem Ausschuss f\u00fcr Verkehr und digitale Infrastruktur, dem Ausschuss f\u00fcr Umwelt, Naturschutz, Bau und Reaktorsicherheit sowie dem Ausschuss f\u00fcr Kultur und Medien zu \u00fcberweisen. Ich h\u00e4tte auch vortragen k\u00f6nnen, an wen er nicht \u00fcberwiesen werden soll. Sind Sie mit diesen Vereinbarungen einverstanden? - Das ist der Fall. Dann haben wir das so beschlossen.\n\nIch rufe den Tagesordnungspunkt 1 auf:\n\nRegierungserkl\u00e4rung durch die Bundeskanzlerin\n\nmit anschlie\u00dfender Aussprache\n\nNach einer interfraktionellen Vereinbarung sind f\u00fcr die heutige Aussprache nach der Regierungserkl\u00e4rung 5 Stunden und 30 Minuten, morgen 10 Stunden und 17 Minuten - vergessen Sie die Stoppuhr nicht - sowie am Freitag 3 Stunden und 36 Minuten vorgesehen. - Ich sehe \u00fcberall helle Begeisterung. Dann k\u00f6nnen wir so verfahren.\n\nDas Wort zur Abgabe einer Regierungserkl\u00e4rung hat die Bundeskanzlerin Frau Dr. Angela Merkel.",
      "top": "TOP 1 Regierungserkl\u00e4rung durch die Bundeskanzlerin",
      "top_id": 13771,
      "type": "chair",
      "wahlperiode": 18
    },
...

/api/categories

Alle Kategorien die mindestens in einem Tagesordnungspunkt vergeben sind

Beispiel:

{
  "data": [
    "Gesellschaftspolitik, soziale Gruppen",
    "Wissenschaft, Forschung und Technologie",
    "Soziale Sicherung",
    "Umwelt",
    "Innere Sicherheit",
    "Raumordnung, Bau- und Wohnungswesen",
...

/api/tops/category_sum

Summe der Redeminuten aller Tagesordnungspunkte pro Kategorie pro Jahr

Einzelne Tagesordnungspunkte können unterschiedlich lang sein. Siehe: http://www.bundestag.de/blob/196288/dac46e4464ebf275361cba97229096e2/kapitel_07_11_regelungen_zur_debattendauer-data.pdf

Beispiel:

{
  "2014": {
    "Arbeit und Besch\u00e4ftigung": 3005,
    "Ausl\u00e4nderpolitik, Zuwanderung": 820,
    "Au\u00dfenpolitik und internationale Beziehungen": 3440,
    "Au\u00dfenwirtschaft": 590,
    "Bildung und Erziehung": 1470,
    "Bundestag": 2635,
    "Energie": 1725,
   ...

/api/tops/category_count

Anzahl aller Tagesordnungspunkte pro Kategorie pro Jahr

Return:

{
  "2014": {
    "Arbeit und Besch\u00e4ftigung": 56,
    "Ausl\u00e4nderpolitik, Zuwanderung": 18,
    "Au\u00dfenpolitik und internationale Beziehungen": 72,
    "Au\u00dfenwirtschaft": 10,
    "Bildung und Erziehung": 24,
    "Bundestag": 34,
    "Energie": 29,
...

/api/utterances/by_gender_category

Anzahl der Redner pro Kategorie aufgeteilt nach Geschlecht (nur männlich und weiblich)

Beispiel:

{
    "Arbeit und Beschäftigung": {
        "female": 762,
        "male": 869
    },
    "Ausländerpolitik, Zuwanderung": {
        "female": 368,
        "male": 340
    },
    "Außenpolitik und internationale Beziehungen": {
        "female": 590,
        "male": 1103
    },
    "Außenwirtschaft": {
        "female": 99,
        "male": 291
    },
...

/api/utterances/by_birth_date_category

Anzahl der Redner pro Kategorie aufgeteilt nach Altersgruppen (pro Gruppe, 10 Jahre)

Beispiel:

{
    "Arbeit und Beschäftigung": {
        "30 - 39": 119,
        "40 - 49": 387,
        "50 - 59": 619,
        "60 - 69": 498,
        "70 - 79": 8
    },
    "Ausländerpolitik, Zuwanderung": {
        "30 - 39": 99,
        "40 - 49": 201,
        "50 - 59": 206,
        "60 - 69": 185,
        "70 - 79": 17
    },
    "Außenpolitik und internationale Beziehungen": {
        "30 - 39": 150,
        "40 - 49": 417,
        "50 - 59": 477,
...

/api/utterances/by_profession_category

Anzahl der Redner pro Kategorie aufgeteilt nach Berufen

Die Berufe sind auf der Bundestagsseite nicht normiert. Deshalb wurden sie vorher gecleaned

{
    "Arbeit und Beschäftigung": {
        "Betriebswirt*in / Kaufmänische Tätigkeit / Handel": 9,
        "Handwerkschaftliche Berufe": 57,
        "Management Tätigkeiten": 1,
        "Medien- und Organisationsberatung": 45,
        "Medizinische/Psychologische Tätigkeit": 1,
        "Politisches Amt / Minister*in": 4,
        "Polizei & Bundeswehr": 3,
        "Sonstige Tätigkeiten": 2,
        "Sozialpädagoge*in / Sozialarbeiter*in": 6,
        "Sprachwissenschaftlicher/Kommunikationswissenschaftlicher Hintergrund": 5,
        "null": 1498
    },
    "Ausländerpolitik, Zuwanderung": {
        "Betriebswirt*in / Kaufmänische Tätigkeit / Handel": 4,
        "Handwerkschaftliche Berufe": 18,
        "Management Tätigkeiten": 1,
        "Medien- und Organisationsberatung": 18,

/api/utterances/by_election_list_category

Anzahl der Redner pro Kategorie aufgeteilt nach Landesliste

Beispiel:

{
    "Arbeit und Beschäftigung": {
        "Landesliste Baden-Württemberg": 136,
        "Landesliste Bayern": 248,
        "Landesliste Berlin": 42,
        "Landesliste Brandenburg": 31,
        "Landesliste Bremen": 5,
        "Landesliste Hamburg": 20,
        "Landesliste Hessen": 97,
        "Landesliste Mecklenburg-Vorpommern": 8,
        "Landesliste Niedersachsen": 199,
        "Landesliste Nordrhein-Westfalen": 306,
        "Landesliste Rheinland-Pfalz": 69,
        "Landesliste Saarland": 13,
        "Landesliste Sachsen": 96,
        "Landesliste Sachsen-Anhalt": 56,
        "Landesliste Schleswig-Holstein": 65,
        "Landesliste Thüringen": 37,
        "null": 203
    },
    "Ausländerpolitik, Zuwanderung": {
        "Landesliste Baden-Württemberg": 78,
        "Landesliste Bayern": 98,
        "Landesliste Berlin": 35,
...

/api/mdb

Metainformationen zu allen Abgeordneten, diein den Reden vorkommen

Returns:

Key	Beschreibung
agw_id	identifier des MdB auf abgeordnetenwatch.de
birth_date	Geburtsdatum des MdB (YYYY-MM-DD)
education	Beruf des MdB
education_category	Berufsgruppe des MdB
election_list	Landesliste durch die der MdB bei der Bundestagswahl aufgestellt worden ist
first_name	Vorname
gender	Geschlecht (männlich oder weiblich)
id	interner identifier
last_name	Nachname
list_won	gibt an, ob der MdB über einen Listenplatz in den Bundestag gekommen ist oder direkt gewählt wurde
party	Fraktion des MdB
picture	Profilbuld von bundestag.de
profile_url	URL des Profils auf abgeordnetenwatch.de

Beispiel:

{
  "data": [
    {
      "agw_id": "c6197a70-52a4-46d4-9686-255cddb2caac",
      "birth_date": "1970-08-24",
      "education": "Diplom-Politologe",
      "education_category": null,
      "election_list": "Landesliste Hessen",
      "first_name": "Michael",
      "gender": "male",
      "id": 1687,
      "last_name": "Roth",
      "list_won": "true",
      "party": "SPD",
      "picture": "http://www.bundestag.de/blueprint/servlet/image/241492/Hochformat__2x3/177/265/32ce9a113797cad89b1bfc70eac0d01e/rE/roth_michael_gross.jpg",
      "profile_url": "https://www.abgeordnetenwatch.de/profile/michael-roth/archive/216871",
      "top_id": null
    },
...

/api/mdb/speech_by_category

Gibt die Anzahl der Reden pro MdB für jede Kategorie zurück

Beispiel:

[
  {
    "category": "Au\u00dfenpolitik und internationale Beziehungen",
    "count": 3,
    "first_name": "Achim",
    "last_name": "Post",
    "party": "SPD",
    "picture": "http://www.bundestag.de/blueprint/servlet/image/241440/Hochformat__2x3/177/265/ee8a7dc2b26a3d8a47e48999a8402f03/VW/post_achim_gross.jpg",
    "profile_url": "https://www.abgeordnetenwatch.de/profile/achim-post-0",
    "speaker_fp": "achim-post",
    "speaker_key": 1412
  },
  {
    "category": "Europapolitik und Europ\u00e4ische Union",
    "count": 1,
    "first_name": "Achim",
...

/api/mdb/speech_sum

Gesamtzahl der Redeminuten pro MdB für jede Kategorie

Beispiel

[
  {
    "count": 7,
    "first_name": "Achim",
    "last_name": "Post",
    "party": "SPD",
    "picture": "http://www.bundestag.de/blueprint/servlet/image/241440/Hochformat__2x3/177/265/ee8a7dc2b26a3d8a47e48999a8402f03/VW/post_achim_gross.jpg",
    "profile_url": "https://www.abgeordnetenwatch.de/profile/achim-post-0",
    "speaker_fp": "achim-post",
    "speaker_key": 1412
  },
  {
    "count": 71,
    "first_name": "Agnieszka",
    "last_name": "Brugger",
...

/api/mdb/aggregated

Gruppiert alle MdBs nach angegeben Attribut und liefert die Gruppen und Anzahl als Objekt zurück

Parameter:

• attribute -> mögliche Werte sind: election_list, education_category, gender

Beispiel:

Request: /api/mdb/aggregated?attribute=election_list

{
    "Landesliste Baden-Württemberg": 52,
    "Landesliste Bayern": 76,
    "Landesliste Berlin": 25,
    "Landesliste Brandenburg": 19,
    "Landesliste Bremen": 6,
    "Landesliste Hamburg": 11,
    "Landesliste Hessen": 45,
    "Landesliste Mecklenburg-Vorpommern": 13,
    "Landesliste Niedersachsen": 56,
    "Landesliste Nordrhein-Westfalen": 125,
    "Landesliste Rheinland-Pfalz": 31,
    "Landesliste Saarland": 8,
    "Landesliste Sachsen": 27,
    "Landesliste Sachsen-Anhalt": 19,
    "Landesliste Schleswig-Holstein": 24,
    "Landesliste Thüringen": 19,
    "null": 0
}

/api/mdb/aggregated/age

Gruppiert die MdBs nach Namen

Beispiel:

{
    "20 - 29": 1,
    "30 - 39": 49,
    "40 - 49": 132,
    "50 - 59": 228,
    "60 - 69": 195,
    "70 - 79": 24,
    "80 - 89": 1
}