bundestag-api 1.0.0

Python wrapper for the official Bundestag-API

Bundestag-API

A wrapper for the official Bundestag (German Federal Parliament) API in Python.

The official information on the API can be found here: Bundestag.de

Installation

Pip install (recommended)

$ pip3 install bundestag_api

Install from source

$ git clone https://github.com/jschibberges/Bundestag-API.git
$ cd Bundestag-API
$ pip install -r requirements.txt

Setup

The API requires a key to authenticate requests. Personal key can be requested from the Bundestag administration. However a general API key has been published that is valid until May 31st 2023. This key is automatically used until that date when no other key is supplied by the user.

Usage

To save your API key create a connection-object, that you can then pass to the search functions. It will save you time, should you have to change API keys at a later date. If you don't supply an API key, the official API key will be used until 31st of May 2023.

import bundestag_api
bta = bundestag_api.btaConnection() #if you want to use your own API key, supply it via "apikey="XXX")
data = bta.query(resource="vorgang")
for d in data:
    print(d["drucksachetyp"]+": "+d["titel"])

The query-function serves as a general search function that can be used to query all resources of the API. However, you will also have to specify all relevant parameters for your search. Data is returned as a dictionary (which can easily be saved as json). Minimally the resource type needs to specified.

For each resource type the api offers a search function and a get function are implemented. Get functions retrieve data for specific entity ids while search function offer all parameters that are relevant to the resource type. Example for documents (Drucksachen):

bta.search_document(datestart="2022-11-01",dateend="2022-11-01",institution="BT")
bta.get_document(btid=264030)

The Bundestag API serves 8 different resources though 2 are doubled with the only difference being whether the document text is returned via the API.

Activities ("Aktivität")

Get one or more activities by their ID

bta.get_activity(btid)

Search for documents by specifying parameters for start and end date or institution. Important: The standard number of documents returned are 100. If more are desired, the "num" parameter must be set.

bta.search_activity()

Documents / Full-Text ("Drucksache")

Get one or more documents by their ID

bta.get_document(btid)

Search for documents by specifying parameters for start and end date or institution. Important: The standard number of documents returned are 100. If more are desired, the "num" parameter must be set.

bta.search_document()

The API differentiates between documents and documents incuding full-text of the document. The functions always query the full-text resource.

Persons ("Person")

Get one or more persons by their ID

bta.get_person(btid)

Search for persons by specifying parameters for start and end date or institution. Important: The standard number of documents returned are 100. If more are desired, the "num" parameter must be set.

bta.search_person()

Plenary Protocols / Full-Text ("Plenarprotokoll")

Get one or more plenary protocols by their ID

bta.get_plenaryprotocol(btid)

Search for plenary protocols by specifying parameters for start and end date or institution. Important: The standard number of documents returned are 100. If more are desired, the "num" parameter must be set.

bta.search_plenaryprotocol()

The API differentiates between plenary protocols and plenary protocols incuding full-text of the protocol. The functions always query the full-text resource.

Procedures ("Vorgang")

Get one or more procedures by their ID

bta.get_procedure(btid)

Search for procedures by specifying parameters for start and end date or institution. Important: The standard number of documents returned are 100. If more are desired, the "num" parameter must be set.

bta.search_procedure()

Procedure Positions ("Vorgangsposition")

Get one or more procedure positions by their ID

bta.get_procedure(btid)

Search for procedure positions by specifying parameters for start and end date or institution. Important: The standard number of documents returned are 100. If more are desired, the "num" parameter must be set.

bta.search_procedure()

ToDo's

• Parallelize requests for larger queries
• Extend Class methods