Package 'worldbank'

Title: Client for World Banks's 'Indicators' and 'Poverty and Inequality Platform (PIP)' APIs
Description: Download and search data from the 'World Bank Indicators API', which provides access to nearly 16,000 time series indicators. See <https://datahelpdesk.worldbank.org/knowledgebase/articles/889392-about-the-indicators-api-documentation> for further details about the API.
Authors: Maximilian Mücke [aut, cre]
Maintainer: Maximilian Mücke <[email protected]>
License: MIT + file LICENSE
Version: 0.3.0.9000
Built: 2024-11-11 21:15:33 UTC
Source: https://github.com/m-muecke/worldbank

Help Index

Return Finances One API Data

Description

Return Finances One API Data

Usage

fone_dataset(dataset_id, resource_id, ..., limit = NULL)

fone_view(view_id, ..., limit = NULL)

Arguments

dataset_id

character(1) id of the associated dataset.
resource_id

character(1) id of the associated resource.
...

additional arguments passed to the request.
limit

integer(1) the maximum number of rows to return. Default is NULL. If NULL, all rows are returned.
view_id

character(1) id of the view.

Value

A data.frame() with the requested dataset.

Source

https://financesone.worldbank.org/data

Examples

## Not run: 
fone_dataset(dataset_id = "DS00047", resource_id = "RS00005")
fone_view(view_id = "DS01538")

## End(Not run)

Return auxiliary data tables

Description

Return auxiliary data tables

Usage

pip_aux(
  table = NULL,
  release_version = NULL,
  ppp_version = NULL,
  version = NULL
)

Arguments

table

character(1) table to be returned. Default NULL.
release_version

character(1) version of the data release in YYYYMMDD format. Default NULL.
ppp_version

character(1) | numeric(1) version of the data. Default NULL.
version

character(1) version of the data. Default NULL.

Value

A character() with the available tables or a data.frame() containing the table data.

Source

https://pip.worldbank.org/api

See Also

Other poverty and inequality statistics: pip_citation(), pip_data(), pip_group(), pip_health_check(), pip_info(), pip_valid_params(), pip_versions()

Examples

# get a list of available tables
pip_aux()

# get countries
pip_aux("countries")

# get GDP
pip_aux("gdp")

# get CPI
pip_aux("cpi")

Return citation for a given version

Description

Return citation for a given version

Usage

pip_citation(release_version = NULL, ppp_version = NULL, version = NULL)

Arguments

release_version

character(1) version of the data release in YYYYMMDD format. Default NULL.
ppp_version

character(1) | numeric(1) version of the data. Default NULL.
version

character(1) version of the data. Default NULL.

Value

A data.frame() with the citation.

Source

https://pip.worldbank.org/api

See Also

Other poverty and inequality statistics: pip_aux(), pip_data(), pip_group(), pip_health_check(), pip_info(), pip_valid_params(), pip_versions()

Examples

pip_citation()

Return main poverty and inequality statistics

Description

Return main poverty and inequality statistics

Usage

pip_data(
  country = NULL,
  year = NULL,
  povline = 2.15,
  popshare = NULL,
  fill_gaps = FALSE,
  welfare_type = c("all", "consumption", "income"),
  reporting_level = c("all", "national", "rural", "urban"),
  additional_ind = FALSE,
  release_version = NULL,
  ppp_version = NULL,
  version = NULL
)

Arguments

country

character() countries for which statistics are to be computed, specified as ISO3 codes. Default NULL.
year

character() | numeric() year(s) for which statistics are to be computed, specified as YYYY. Default NULL.
povline

numeric(1) poverty line to be used to compute poverty mesures. Poverty lines are only accepted up to 3 decimals. Default 2.15.
popshare

numeric(1) proportion of the population living below the poverty line. Will be ignored if povline is specified. Default NULL.
fill_gaps

logical(1) whether to fill gaps in the data. Default FALSE.
welfare_type

character(1) type of welfare measure to be used. Default "all".
reporting_level

character(1) level of reporting for the statistics. Default "all".
additional_ind

logical(1) whether to include additional indicators. Default FALSE.
release_version

character(1) version of the data release in YYYYMMDD format. Default NULL.
ppp_version

character(1) | numeric(1) version of the data. Default NULL.
version

character(1) version of the data. Default NULL.

Value

A data.frame() with the requested statistics.

Source

https://pip.worldbank.org/api

See Also

Other poverty and inequality statistics: pip_aux(), pip_citation(), pip_group(), pip_health_check(), pip_info(), pip_valid_params(), pip_versions()

Examples

pip_data(c("ZAF", "ZMB"))

Return aggregation of PIP statistics

Description

Return aggregation of PIP statistics

Usage

pip_group(
  country = NULL,
  year = NULL,
  povline = 2.15,
  popshare = NULL,
  group_by = c("wb", "none"),
  fill_gaps = FALSE,
  welfare_type = c("all", "consumption", "income"),
  reporting_level = c("all", "national", "rural", "urban"),
  additional_ind = FALSE,
  release_version = NULL,
  ppp_version = NULL,
  version = NULL
)

Arguments

country

character() countries for which statistics are to be computed, specified as ISO3 codes. Default NULL.
year

character() | numeric() year(s) for which statistics are to be computed, specified as YYYY. Default NULL.
povline

numeric(1) poverty line to be used to compute poverty mesures. Poverty lines are only accepted up to 3 decimals. Default 2.15.
popshare

numeric(1) proportion of the population living below the poverty line. Will be ignored if povline is specified. Default NULL.
group_by

character(1) aggregate results by pre-defined sub-groups. Default "wb".
fill_gaps

logical(1) whether to fill gaps in the data. Default FALSE.
welfare_type

character(1) type of welfare measure to be used. Default "all".
reporting_level

character(1) level of reporting for the statistics. Default "all".
additional_ind

logical(1) whether to include additional indicators. Default FALSE.
release_version

character(1) version of the data release in YYYYMMDD format. Default NULL.
ppp_version

character(1) | numeric(1) version of the data. Default NULL.
version

character(1) version of the data. Default NULL.

Value

A data.frame() with the requested statistics.

Source

https://pip.worldbank.org/api

See Also

Other poverty and inequality statistics: pip_aux(), pip_citation(), pip_data(), pip_health_check(), pip_info(), pip_valid_params(), pip_versions()

Examples

pip_group(c("AFE", "LAC"))

Determine if the API is running and listening as expected

Description

Determine if the API is running and listening as expected

Usage

pip_health_check()

Value

A character(1) with the health check message.

Source

https://pip.worldbank.org/api

See Also

Other poverty and inequality statistics: pip_aux(), pip_citation(), pip_data(), pip_group(), pip_info(), pip_valid_params(), pip_versions()

Examples

pip_health_check()

Return information about the API

Description

Return information about the API

Usage

pip_info()

Value

A data.frame() with the API information.

Source

https://pip.worldbank.org/api

See Also

Other poverty and inequality statistics: pip_aux(), pip_citation(), pip_data(), pip_group(), pip_health_check(), pip_valid_params(), pip_versions()

Examples

pip_info()

Return valid query parameters

Description

Return valid query parameters

Usage

pip_valid_params(
  endpoint = c("all", "aux", "pip", "pip-grp", "pip-info", "valid-params"),
  release_version = NULL,
  ppp_version = NULL,
  version = NULL
)

Arguments

endpoint

character(1) endpoint for which valid parameters are to be returned. Default "all".
release_version

character(1) version of the data release in YYYYMMDD format. Default NULL.
ppp_version

character(1) | numeric(1) version of the data. Default NULL.
version

character(1) version of the data. Default NULL.

Value

A data.frame() with the valid parameters.

Source

https://pip.worldbank.org/api

See Also

Other poverty and inequality statistics: pip_aux(), pip_citation(), pip_data(), pip_group(), pip_health_check(), pip_info(), pip_versions()

Examples

pip_valid_params()

Return the available data versions

Description

Return the available data versions

Usage

pip_versions()

Value

A data.frame() with the available versions.

Source

https://pip.worldbank.org/api

See Also

Other poverty and inequality statistics: pip_aux(), pip_citation(), pip_data(), pip_group(), pip_health_check(), pip_info(), pip_valid_params()

Examples

pip_versions()

World Bank country data

Description

List all countries supported by the World Bank API.

Usage

wb_country(country = NULL, lang = "en")

Arguments

country

character() country to query. Default NULL. If NULL, all countries are returned.
lang

character(1) language to query. Default "en".

Value

A data.frame() with the available countries. The columns are:

country_id

The country ID.
country_code

The country code.
country_name

The country name.
region_id

The region ID.
region_code

The region code.
region_value

The region value.
admin_region_id

The admin region ID.
admin_region_code

The admin region code.
admin_region_value

The admin region value.
income_level_id

The income level ID.
income_level_code

The income level code.
income_level_value

The income level value.
lending_type_id

The lending type ID.
lending_type_code

The lending type code.
lending_type_value

The lending type value.
capital_city

The capital city.
longitude

The longitude.
latitude

The latitude.

Source

https://api.worldbank.org/v2/country

See Also

Other indicators data: wb_income_level(), wb_indicator(), wb_language(), wb_lending_type(), wb_region(), wb_source(), wb_topic()

Examples

wb_country()

World Bank country indicator data

Description

List all country indicators supported by the World Bank API.

Usage

wb_country_indicator(
  indicator = "NY.GDP.MKTP.CD",
  country = NULL,
  lang = "en",
  start_date = NULL,
  end_date = NULL
)

Arguments

indicator

character(1) indicator to query.
country

character() country to query. Default NULL. If NULL, all countries are returned.
lang

character(1) language to query. Default "en".
start_date

character(1) or integer(1) start date to query. Default NULL. Supported formats:

  • YYYY for yearly data (e.g. 2020 or "2020")

  • YYYYQ[1-4] for quarterly data (e.g. "2020Q1")

  • YYYYM[1-12] for monthly data (e.g. "2020M02")

end_date

character(1) or integer(1) end date to query, in the same format as start_date. Default NULL.

Value

A data.frame() with the available country indicators. The columns are:

date

The date
indicator_id

The indicator ID.
indicator_name

The indicator name.
country_id

The country ID.
country_name

The country name.
country_code

The country code.
value

The indicator value.
unit

The indicator unit.
obs_status

The observation status.
decimal

The decimal.

Source

https://api.worldbank.org/v2/country/{country}/indicator/{indicator}

Examples

wb_country_indicator("NY.GDP.MKTP.CD", "US")
wb_country_indicator(
  "DPANUSSPB", c("CHN", "BRA"),
  start_date = "2012M01", end_date = "2012M08"
)

World Bank income level data

Description

List all income levels supported by the World Bank API.

Usage

wb_income_level(income = NULL, lang = "en")

Arguments

income

character() income level to query. Default NULL. If NULL, all levels are returned.
lang

character(1) language to query. Default "en".

Value

A data.frame() with the available income levels. The columns are:

id

The income level ID.
iso2code

The ISO 2 code of the income level.
value

The income level value.

Source

https://api.worldbank.org/v2/incomeLevels

See Also

Other indicators data: wb_country(), wb_indicator(), wb_language(), wb_lending_type(), wb_region(), wb_source(), wb_topic()

Examples

wb_income_level()

World Bank indicator data

Description

List all indicators supported by the World Bank API.

Usage

wb_indicator(indicator = NULL, lang = "en")

Arguments

indicator

character(1) indicator to query. Default NULL. If NULL, all indicators are returned.
lang

character(1) language to query. Default "en".

Value

A data.frame() with the available indicators. The columns are:

id

The indicator ID.
name

The indicator name.
unit

The indicator unit.
source_id

The source ID.
source_value

The source value.
source_note

The source note.
source_organization

The source organization.
topic_id

The topic ID.
topic_value

The topic value.

Source

https://api.worldbank.org/v2/indicator

See Also

Other indicators data: wb_country(), wb_income_level(), wb_language(), wb_lending_type(), wb_region(), wb_source(), wb_topic()

Examples

wb_indicator("NY.GDP.MKTP.CD")

World Bank available languages

Description

List all languages supported by the World Bank API.

Usage

wb_language()

Value

A data.frame() with the available languages. The columns are:

code

The language code.
name

The language name.
native_form

The native form of the language name.

Source

https://api.worldbank.org/v2/languages

See Also

Other indicators data: wb_country(), wb_income_level(), wb_indicator(), wb_lending_type(), wb_region(), wb_source(), wb_topic()

Examples

wb_language()

World Bank lending type data

Description

List all lending types supported by the World Bank API.

Usage

wb_lending_type(type = NULL, lang = "en")

Arguments

type

character() lending type to query. Default NULL. If NULL, all types are returned.
lang

character(1) language to query. Default "en".

Value

A data.frame() with the available lending types. The columns are:

id

The lending type ID.
iso2code

The ISO 2 code of the lending type.
value

The lending type value.

Source

https://api.worldbank.org/v2/lendingTypes

See Also

Other indicators data: wb_country(), wb_income_level(), wb_indicator(), wb_language(), wb_region(), wb_source(), wb_topic()

Examples

wb_lending_type()

World Bank region data

Description

List all regions supported by the World Bank API.

Usage

wb_region(region = NULL, lang = "en")

Arguments

region

character() region to query. Default NULL. If NULL, all regions are returned
lang

character(1) language to query. Default "en".

Value

A data.frame() with the available regions. The columns are:

id

The region ID.
code

The region code.
iso2code

The ISO 2 code of the region.
name

The region name.

Source

https://api.worldbank.org/v2/region

See Also

Other indicators data: wb_country(), wb_income_level(), wb_indicator(), wb_language(), wb_lending_type(), wb_source(), wb_topic()

Examples

wb_region()

World Bank source data

Description

List all sources supported by the World Bank API.

Usage

wb_source(source = NULL, lang = "en")

Arguments

source

character() source to query. Default NULL. If NULL, all sources are returned.
lang

character(1) language to query. Default "en".

Value

A data.frame() with the available sources. The columns are:

id

The source ID.
last_updated

The date the source was last updated.
name

The source name.
code

The source code.
description

The source description.
url

The source URL.
data_availability

Whether the source has data available.
metadata_availability

Whether the source has metadata available.
concepts

The concepts associated with the source.

Source

https://api.worldbank.org/v2/sources

See Also

Other indicators data: wb_country(), wb_income_level(), wb_indicator(), wb_language(), wb_lending_type(), wb_region(), wb_topic()

Examples

wb_source()

World Bank topic data

Description

List all topics supported by the World Bank API.

Usage

wb_topic(topic = NULL, lang = "en")

Arguments

topic

character() topic to query. Default NULL. If NULL, all topics are returned.
lang

character(1) language to query. Default "en".

Value

A data.frame() with the available topics. The columns are:

id

The topic ID.
value

The topic value.
source_note

The source note.

Source

https://api.worldbank.org/v2/topics

See Also

Other indicators data: wb_country(), wb_income_level(), wb_indicator(), wb_language(), wb_lending_type(), wb_region(), wb_source()

Examples

wb_topic()