An API wrapper for Ipeadata

api, api-wrapper, brazil, dados-abertos, dados-historicos, data, data-analysis, datasets, econometrics, economic-data, economics, geographic-data, geography, ipea, ipeadata, wrapper
pip install ipeadatapy==0.1.7



ipeadatapy: an API wrapper for Ipeadata


What is it?

The main purpose of Ipeadatapy package is to provide a way of extracting data from Ipeadata through Python using Ipeadata’s API. Thus, in this sense, Ipeadatapy is what is called an API wrapper. Nevertheless, the goal of the package is far from being only extract data. Ipeadatapy also is concerned with treating, cleaning and making more understandable the data provided by the API as well as providing data filtering and search mechanisms. Briefly, Ipeadatapy’s objective can be described as being to facilitate users to search and analyze time series data and metadata from Ipeadata database using Python.

Main Features

Ipeadatapy allows you to extract processed data and metadata from Ipeadata's API in a more efficient and practical way, directly from your Python script, notebook and/or interactive shell. Here are some of the package's features:

  • Lists in data frames all Ipeadata available...
    • Time series names and codes;
    • Sources;
    • Countries;
    • Territories;
    • Themes.
  • Basic time series searching mechanism;
  • Data filtering through defined functions parameters;
  • Show time series data and metadata;
  • Filter time series data set by day, month and/or year;
  • Track latest updated time series.

Using pandas, one of the package dependecies, you can also plot and extract data and metadata. For more details check the documentation.

Where to get it

The source code is currently hosted on Ipeadatapy's GitHub.

Binary installers for the latest released version are available at Python package index page.

pip install ipeadatapy


The official documentation is hosted on author's website:


The only dependecies are pandas and requests.