atparlpy 0.1.0

Python wrapper for the Austrian Parliament open data API

atparlpy

This project provides a Python wrapper for the Austrian Parliament's Open Data REST APIs. The API responses are available both as dataclasses and as Pandas Dataframes.

Installation

atparlpy is availalbe on PyPI and can be installed via pip:

$ pip install atparlpy

Usage

The atparlpy module exposes each dataset as a separate class. Import and instantiate the class for your desired dataset. For example for the Inquiries ("Parlamentarische Anfragen"):

>>> from atparlpy import Inquiries
>>> inquiries = Inquiries(gp=28, nrbr="NR").AsList()
>>> print(len(inquiries))
>>> print(inquiries[0].betreff)

To get the result as a dataframe instead, use the AsDataFrame() method:

>>> from atparlpy import Inquiries
>>> df = Inquiries(gp=28, nrbr="NR").AsDataFrame()
>>> print(df['status'].value_counts())
>>> df.to_csv('inquiries.csv', index=False)

All filters can also be set via the fluent API. For example:

>>> from atparlpy import Inquiries
>>> inquiries = Inquiries().gp(28).nrbr("NR").AsList()

See examples.py for more examples.

Convenience features

• Wherever the REST API only accepts the legislative period as a Roman numeral ("GP_CODE": ["XXVIII"]), the wrapper also accepts the corresponding integer value. The Roman numeral can be set via gp_code and the integer value via gp. If both are provided, gp_code takes precedence.
• The wrapper accepts either a list of strings or a single string value wherever the REST API only accepts a list of string values (e.g., "THEMEN": ["Arbeit"] can be set as .themen("Arbeit") or .themen(["Arbeit"])).

Supported datasets

Anträge (Motions)

• API Documentation

# Beispiel: Abfrage nach allen Anträgen im Nationalrat während der XXVII. GP zum Thema Arbeit
motions = Motions(gp_code="XXVII").nrbr("NR").themen(["Arbeit"]).AsList()

Ausschussberichte (CommitteeReports)

• API Documentation

# Beispiel: Abfrage nach allen parlamentarischen Anfragen im Bundesrat während der XXVIII. GP
inquiries = Inquiries(gp=28, nrbr="BR").AsList()

Beschlüsse (Resolutions)

• API Documentation

# Beispiel: Abfrage nach allen Beschlüssen im Nationalrat während der 25. GP zum Thema Kultur
resolutions = Resolutions().nrbr("NR").gp_code("XXV").themen("Kultur").AsList()

Anfragen (Inquiries)

• API Documentation Anfragen BR
• API Documentation Anfragen NR

# Beispiel: Abfrage nach allen parlamentarischen Anfragen im Nationalrat während der XXVIII. GP zum Thema Arbeit oder Bildung
inquiries = Inquiries(gp=28, nrbr="NR").themen(["Arbeit", "Bildung"]).AsList()

Aktuelle Abgeordnete zum Nationalrat und Mitglieder des Bundesrats (Parliamentarians)

• API Documentation Nationalrat
• API Documentation Bundesrat

# Beispiel: Abfrage nach allen aktuellen Abgeordneten zum Nationalrat
members_of_parliament = Parliamentarians(nrbr="NR").AsList()

# Beispiel: Fraktionen im Nationalrat plus Anzahl der Abgeordneten
df = Parliamentarians(nrbr="NR").AsDataFrame()
print(df['sort_wp'].value_counts())

# Beispiel: Abfrage nach dem aktuellen Präsidenten des Nationalrats
president = Parliamentarians(nrbr="NR").funk("1PNR").AsList()[0]

# Beispiel: Abfrage nach allen aktuellen Mitgliedern des Bundesrats
members_of_the_national_council = Parliamentarians(nrbr="BR").AsList()