Imports Datasets from BCB (Central Bank of Brazil) using Its Official API

Downloads and organizes datasets using BCB's API <>. Offers options for caching with the 'memoise' package and , multicore/multisession with 'furrr' and format of output data (long/wide).

The Central Bank of Brazil (BCB) offers access to its SGS system (sistema gerenciador de series temporais) with a official API available here.

Package GetBCB offers a R interface to the API and many other advantages:

  • Use of a caching system with package memoise to speed up repeated requests of data;
  • User can utilize all cores of the machine (parallel computing) when fetching a large batch of time series;
  • Error handling internally. Even if requested series does not exist, the function will still return all results.


# CRAN (official release) - SOON

# Github (dev version)

A simple example


my.countries <- c('Germany', 'Canada', 'USA', 
                  'France', 'Italy', 'Japan')

my.ids <- c(3785:3790)

names(my.ids) <- paste0('Unemp. rate - ', my.countries)

df.bcb <- gbcbd_get_series(id = my.ids ,
              = '2000-01-01',
              = Sys.Date(),
              = 'long',
              = 'ABC',
                       use.memoise = TRUE, 
                       cache.path = tempdir(), # use tempdir for cache folder
                       do.parallel = FALSE)


p <- ggplot(df.bcb, aes(x =, y = value) ) +
  geom_line() + 
  labs(title = 'Unemploymnent Rates Around the World', 
       subtitle = paste0(min(df.bcb$, ' to ', max(df.bcb$,
       x = '', y = 'Percentage*100') + facet_wrap(



Version 0.5 (2019-04-15)

  • First release

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.5 by Marcelo Perlin, a month ago

Report a bug at

Browse source code at

Authors: Marcelo Perlin [aut, cre]

Documentation:   PDF Manual  

GPL-2 license

Imports stringr, stats, RCurl, lubridate, readr, utils, curl, dplyr, future, furrr, jsonlite, memoise, purrr

Suggests knitr, rmarkdown, testthat, ggplot2, tidyverse

See at CRAN