An Interface to IBGE's SIDRA API

Allows the user to connect with IBGE's (Instituto Brasileiro de Geografia e Estatistica, see <> for more information) SIDRA API in a flexible way. SIDRA is the acronym to "Sistema IBGE de Recuperacao Automatica" and is the system where IBGE turns available aggregate data from their researches.


CRAN_Status_Badge CRAC_Downloads

The goal of sidrar is to provide direct access to the data of IBGE's (Brazilian Institute of Geography and Statistics) SIDRA API within the R environment in an easy and flexible way. SIDRA is the acronym to "Sistema IBGE de Recuperação Automática" and it is the system where IBGE makes aggregate data from their researches available.


Install the release version from CRAN:


or the development version from github



For the time being, the "sidrar" package contains only three functions:

get_sidra          It recovers data from the given table
                   according to the parameters
info_sidra         It allows you to check what parameters
                   are available for a table
search_sidra       It searches which tables have a particular 
                   word in their names


Let's assume that we want the IPCA (Índice de Preços ao Consumidor Amplo) for the city of Campo Grande/MS. However, we want to recover only the overall percentage rate in the last 12 months. To do this simply execute:

get_sidra(x = 1419,
          variable = 63,
          period = c(last = "12"),
          geo = "City",
          geo.filter = 5002704,
          classific = "c315",
          category = list(7169),
          header = FALSE,
          format = 3)

To more examples, see the vignette "Introduction to sidrar".


sidrar 0.2.4

  • Fixed bug in search_sidra (Issue #2)
  • Better error messages
  • Vignette updated

sidrar 0.2.1

  • Fixed list-column in resultant data.frame in get_sidra (Issue #1)

sidrar 0.2.0

  • New argument in get_sidra ("api")

sidrar 0.1.1

  • Better messages depending of the input arguments

sidrar 0.1.0

  • Initial version

Reference manual

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


0.2.4 by Renato Prado Siqueira, 7 months ago

Report a bug at

Browse source code at

Authors: Renato Prado Siqueira [aut, cre]

Documentation:   PDF Manual  

GPL-3 license

Imports dplyr, magrittr, RCurl, rjson, rvest, stringr, tidyr, xml2

Suggests knitr

See at CRAN