• Stars
    star
    110
  • Rank 316,770 (Top 7 %)
  • Language
    Python
  • License
    MIT License
  • Created over 5 years ago
  • Updated over 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

The World Bank Data in Python

The World Bank Data in Python

Build Status codecov.io Language grade: Python Pypi pyversions Jupyter Notebook JupyterLab

This is an implementation of the World Bank API v2 in Python. Use this package to explore the World Development Indicators published by the World Bank.

Quick tutorial

Installation

Install or update the World Bank Data python package with

pip install world_bank_data --upgrade

Get the list of sources, topics, countries, regions

import pandas as pd
import world_bank_data as wb
pd.set_option('display.max_rows', 6)

The list of topics is available with

wb.get_topics()

Sources are returned by

wb.get_sources()

And finally, the list of countries is accessible with

wb.get_countries()

In addition, give a try to

  • get_regions
  • get_incomelevels
  • get_lendingtypes

to retrieve more information about country classifiers.

Get the list of indicators

This is done with the get_indicators function. You may query only the indicators for a specific source or topic as below. If you input no arguments, the get_indicator function will return the description of all the 16,000+ indicators.

wb.get_indicators(topic=3, source=2)  # topic and source id are from get_topics/get_sources

Requesting all indicators may take a few seconds, but no worries, the result is cached, so next time this will be instantaneous.

Searching for one country or indicator

Use the functions search_countries, search_source, search_indicators. Or, if you want to search in a existing dataframe, simply use search.

wb.search_indicators('mathematics')

Get the values of an indicator

The function get_series returns the value of a single indicator. The World Bank API accepts quite a few arguments, including:

  • mrv, integer: one or more most recent values
  • date, string: either one year, or two years separated with a colon, like '2010:2018'
  • gapfill, string: 'Y' or 'N' (the default): forward fills missing values.

For instance, the call below returns the most recent estimate for the World Population:

wb.get_series('SP.POP.TOTL', mrv=1)

The result above has a 3-dimensional index. Use the argument simplify_index to ignore the dimensions that take a single value (here: year and series). Also, use the argument id_or_value='id' if you prefer your data to be indexed by the codes rather than labels:

wb.get_series('SP.POP.TOTL', date='2016', id_or_value='id', simplify_index=True)

Ready for an interative tutorial?

Go to our Binder and run either this README, or our other tutorial with the code required to produce this plot of the World Population:

World Population 2017

References

The World Bank

The World Bank has a Data Catalog, and an interactive data explorer.

Third party applications that allow to access the data from various languages are listed here.

Google's Public Data Explorer

The World Bank data is also available in Google's Data Explorer.

Python

Alternatively to world_bank_data, Python users may find useful the following packages:

The reason for which I wrote world_bank_data is mostly speed, e.g. I wanted to use the lastest version of the World Bank API (v2) and benefit from significant speed improvements. Reimplementing the API also gave me a finer control on the mapping of options.

R

R users can use two packages to access the World Bank data:

See also the Introduction to the wbstats R-package, or this quick review of the two packages.

FAQ

Country and indicator description in non-English languages

The World Bank describes their sources and indicators in other languages than English. Use either the language argument in each of get_countries, get_indicators, etc, or change the default globally:

wb.options.language = 'vi'
wb.get_indicators('SP.POP.TOTL')
wb.options.language = 'en'

Caching

All requests, except get_series, are cached using a least recently used cache from the cachetools package.

Using behind a proxy

Using the package behind an http proxy is possible. Use either the proxies argument in the get_* functions, or set the proxy globally with e.g.:

wb.options.proxies = {'http': 'http://example.com:3128'}

License

This python package is licenced under the MIT License.

Please also read the World Bank Terms of Use relative to the conditions that apply to the data downloaded with this package.

More Repositories

1

jupytext

Jupyter Notebooks as Markdown Documents, Julia, Python or R scripts
Python
6,064
star
2

itables

Pandas DataFrames as Interactive DataTables
Jupyter Notebook
757
star
3

jupyterlab-jupytext

A JupyterLab extension for Jupytext
TypeScript
25
star
4

notebooks_in_vscode_and_pycharm_jan_2020

Working with Jupyter Notebooks in Visual Studio Code and PyCharm (January 2020)
22
star
5

papermill_jupytext

Parametrize and run scripts as notebooks with jupytext and papermill
Python
15
star
6

world_trade_data

World Integrated Trade Solution (WITS) API in Python
HTML
15
star
7

jupytext_pyparis_2018

Jupytext talk at PyParis 2018
Jupyter Notebook
11
star
8

easyplotly

Hopefully makes it easier to produce complex plots with Plotly
Python
6
star
9

ipython_from_R

Communicate with jupyter kernels from R
Python
6
star
10

resize_encrypted_partitions

How to Resize Bitlocker and LUKS Encrypted Partitions
4
star
11

plotly_offline_export

Offline export of plotly plots
Python
4
star
12

flocon

Le Flocon de Koch, de la programmation 2D avec Scratch Γ  l'impression 3D avec OpenSCAD
OpenSCAD
4
star
13

github_actions_python

Testing your Python Project with GitHub Actions
4
star
14

jupyterlab-itables-toggle-wip

A JupyterLab extension for ITables
Python
3
star
15

jupytext_nbextension

A Jupyter notebook extension for Jupytext
JavaScript
3
star
16

sortpics

Pictures from Google Photos, ICloud, or your Camera... all sorted!
Python
3
star
17

notebooks

Jupyter Notebook
3
star
18

nbsrc

Python and R scripts as Jupyter notebooks
Jupyter Notebook
3
star
19

nbpercent

Jupyter Notebooks as Scripts with Outputs
Python
2
star
20

elegant-scipy-as-a-jp-book

Elegant Scipy as a Jupyter Book (EXPERIMENTAL)
HTML
2
star
21

test_miniconda_action

1
star
22

jupyter-book-experiments

Deploy pre-existing Markdown and R Markdown books with Jupyter Book
Shell
1
star