Parlameter for developers

Parlameter is a tool that aids political researchers and journalists in doing their job. It consists of several building blocks providing APIs for datasets gathered from the website of the Slovenian parliament as well as visualisations of those datasets in an embeddable card format (like a Youtube video). The APIs are documented below, as well as links to Github with all the source code.

Parladata API

The Parladata API serves data as scraped from www.dz-rs.si. It creates a faithful copy, so mistakes in the original dataset will be present in Parladata. There might be mistakes in the parsed data. If you find any mistakes, please submit an issue. The most common mistake is wrongly assigning a speech to a person with a similar/same name. The API is divided into three main endpoints, p, pg, and s for MPs, parties (parliamentary groups), and sessions respectively.

Start using it

Parlalize API

The Parlalize API serves calculated and organized data and metrics. The calculations are performed on data accessible at the Parladata API endpoint. Most of the metrics are calculated every 24 hours or less with a few notable exceptions. If you want to access the data as it was calculated on a given day, append the date (localized to slovenian) behind the last slash in your query. The API is organized like Parladata but enforces grouping for endpoint URLs. /p for MPs, /pg for parliamentary groups, and /s for sessions.

Start using it

Parlasearch API

The Parlasearch API serves as a de facto middleware between our SOLR instance and the outside world. It simplifies queries to make them more human friendly and serves as a "security" layer preventing strange queries that might impact the performance of our search engine. It also contains functions that calculate certain analyses that perform better when utilising SOLR. These results are then POSTed to Parlalize and served from there.

Start using it

The code that runs Parlameter is released to the public domain. It belongs to you. Use it, fix it, reuse it, take it apart, or simply show your love. The links below will lead you to individual repositories. We encourage you to submit an issue, or, if you find the time, fix one. ;)

parladata

Parladata serves as the primary Popolo-compliant database and API for parliamentary data. In an ideal world, this is what our government would provide.

github

parlalize

Where the magic happens. Parlalize requests data from Parladata every 24 hours and runs all the calculations. It provides the data through a JSON API.

github

parlasearch

Parlasearch serves as the interface to our SOLR search engine. It provides several API endpoints to perform filtered or filterless searches.

github

parlanode

Provides the infrastructure to deploy embeddable, shareable cards. Provide a template and a JSON data URL and you're all set to embed and share your cards.

github

parlacards

[ DEPRECATED ] Our old cards, still written in EJS. This will remain here until all cards are ported to Vue and the EJS engine is disabled.

github

parlasite

Parlasite is what runs parlameter.si. It's a simplish Node app that requests cards and injects their HTML where necessary (without iframes).

github

We had a couple of presentations to the local developer community, you can find the slides below. Leave a comment if you want to know more. :)