CRAN_Status_Badge Travis-CI Build Status AppVeyor Build Status CRAN_Download_Badge CRAN_Download_Badge

🇧🇷 congressbr

congressbr is a package for extracting data from the APIs of the Brazilian Federal Senate and Chamber of Deputies, respectively.


congressbr is on CRAN, and so can be installed with the following:


Development versions can be installed with the devtools package:


Function naming

We follow googlesheets in using a naming convention for functions that facilitates tab completion. All Senate-related functions start with sen_ and all Chamber-related ones start with cham_.

Principal functions


You can learn more about the package with the vignettes. Run vignette("Exploring the Brazilian Federal Senate") to download and explore data from the Federal Senate, and vignette("Exploring the Brazilian Chamber of Deputies") to do the same for the Chamber of Deputies.


congressbr comes with some pre-prepared datasets.


If you would like to get involved, feel free to fork the repo. We’ve been using the Udacity Git Commit Message Style Guide (well, not always). There are a list of open issues, which is a good place to start. The API of the Federal Senate is also under development, and so elements of this package may change. If you find any problems with the package, please open an issue and leave us a reproducible example and we’ll get it fixed asap.


If you use this package in academic work, it can be cited with:


which will give you:

To cite package ‘congressbr’ in publications use:

  Robert Myles McDonnell, Guilherme Jardim Duarte and Danilo Freire (2017). congressbr:
  Downloads, Unpacks and Tidies Legislative Data from the Brazilian Federal Senate and
  Chamber of Deputies. R package version 0.1.0.

A BibTeX entry for LaTeX users is

    title = {congressbr: Downloads, Unpacks and Tidies Legislative Data from the
Brazilian Federal Senate and Chamber of Deputies},
    author = {Robert Myles McDonnell and Guilherme Jardim Duarte and Danilo Freire},
    year = {2017},
    note = {R package version 0.1.0},
    url = {},

List of functions

For convenience, we list here the functions of the package. More details are available here. Note: The information returned by some of the functions below is no longer available from the API. Hopefully in a future release, we’ll be able to re-include these functions. (Functions are marked by strikethrough text.)