Skip to contents

Retrieve data from the IMF World Economic Outlook (WEO) database for specific series, countries, and years.

Usage

weo_get(
  entities = NULL,
  series = NULL,
  start_year = 1980L,
  end_year = NULL,
  year = NULL,
  release = NULL,
  quiet = TRUE
)

Arguments

entities

An optional character vector of ISO3 country codes or country group identifiers. See weo_get_entities.

series

A optional character vector of series codes. See weo_get_series.

start_year

Minimum year to include. Defaults to 1980.

end_year

Maximum year to include. Defaults to current year + 5 years.

year

The year of a WEO publication (e.g., 2024). Defaults to latest publication year.

release

The release of a WEO publication ("Spring" or "Fall"). Defaults to latest publication release.

quiet

A logical indicating whether to print download information. Defaults to TRUE.

Value

A data frame with columns:

entity_id

ISO3 country code or country group ID

entity_name

Entity name

series_code

WEO series code

series_name

Series name

units

Units of measurement

year

Year

value

Value

Examples

# \donttest{
# Get GDP growth for selected countries
weo_get(
  entities = c("USA", "GBR", "DEU"),
  series = "NGDP_RPCH",
  start_year = 2015,
  end_year = 2020
)
#> # A tibble: 18 × 7
#>    entity_name    entity_id series_name            units series_id  year   value
#>    <chr>          <chr>     <chr>                  <chr> <chr>     <int>   <dbl>
#>  1 Germany        DEU       Gross domestic produc… Perc… NGDP_RPCH  2015   1.66 
#>  2 Germany        DEU       Gross domestic produc… Perc… NGDP_RPCH  2016   2.22 
#>  3 Germany        DEU       Gross domestic produc… Perc… NGDP_RPCH  2017   2.81 
#>  4 Germany        DEU       Gross domestic produc… Perc… NGDP_RPCH  2018   1.13 
#>  5 Germany        DEU       Gross domestic produc… Perc… NGDP_RPCH  2019   0.973
#>  6 Germany        DEU       Gross domestic produc… Perc… NGDP_RPCH  2020  -4.13 
#>  7 United Kingdom GBR       Gross domestic produc… Perc… NGDP_RPCH  2015   2.14 
#>  8 United Kingdom GBR       Gross domestic produc… Perc… NGDP_RPCH  2016   2.21 
#>  9 United Kingdom GBR       Gross domestic produc… Perc… NGDP_RPCH  2017   3.02 
#> 10 United Kingdom GBR       Gross domestic produc… Perc… NGDP_RPCH  2018   1.55 
#> 11 United Kingdom GBR       Gross domestic produc… Perc… NGDP_RPCH  2019   1.26 
#> 12 United Kingdom GBR       Gross domestic produc… Perc… NGDP_RPCH  2020 -10.0  
#> 13 United States  USA       Gross domestic produc… Perc… NGDP_RPCH  2015   2.95 
#> 14 United States  USA       Gross domestic produc… Perc… NGDP_RPCH  2016   1.82 
#> 15 United States  USA       Gross domestic produc… Perc… NGDP_RPCH  2017   2.46 
#> 16 United States  USA       Gross domestic produc… Perc… NGDP_RPCH  2018   2.97 
#> 17 United States  USA       Gross domestic produc… Perc… NGDP_RPCH  2019   2.58 
#> 18 United States  USA       Gross domestic produc… Perc… NGDP_RPCH  2020  -2.08 
# }