Package {imfweo}

Title: Seamless Access to IMF World Economic Outlook (WEO) Data
Version: 0.2.0
Description: Provides tools to download, process, and analyze data from the International Monetary Fund's World Economic Outlook (WEO) https://www.imf.org/en/publications/weo. Functions support downloading complete WEO releases, accessing specific economic indicators for selected countries, and listing available data.
License: MIT + file LICENSE
Encoding: UTF-8
RoxygenNote: 7.3.3
Depends: R (≥ 4.1.0)
Imports: cli, dplyr, httr2, readr, readxl, rlang, tibble, tidyr
Suggests: curl, testthat, withr
Config/testthat/edition: 3
URL: https://teal-insights.github.io/r-imfweo/, https://github.com/teal-insights/r-imfweo/
BugReports: https://github.com/teal-insights/r-imfweo/issues
NeedsCompilation: no
Packaged: 2026-08-24 07:01:24 UTC; krise
Author: Teal Emery [aut, cre], Teal Insights [cph], Christoph Scheuch ORCID iD [aut]
Maintainer: Teal Emery <lte@tealinsights.com>
Repository: CRAN
Date/Publication: 2026-08-24 16:20:27 UTC

imfweo: Seamless Access to IMF World Economic Outlook (WEO) Data

Description

Provides tools to download, process, and analyze data from the International Monetary Fund's World Economic Outlook (WEO) https://www.imf.org/en/publications/weo. Functions support downloading complete WEO releases, accessing specific economic indicators for selected countries, and listing available data.

Author(s)

Maintainer: Teal Emery lte@tealinsights.com

Authors:

Other contributors:

See Also

Useful links:

Reset the Cache

Description

Reset the Cache

Usage

weo_cache_reset()

Value

No return value, called for side effects.

Get WEO Data

Description

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



# Get GDP growth for selected countries
weo_get(
  entities = c("USA", "GBR", "DEU"),
  series = "NGDP_RPCH",
  start_year = 2015,
  end_year = 2020
)

Get Available WEO Entities

Description

Returns a data frame with available entities (countries and country groups) in the WEO database.

Usage

weo_get_entities(year = NULL, release = NULL, quiet = TRUE)

Arguments

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

Full name of the country or country group

Examples



# List all countries and regions
weo_get_entities()

Get Available WEO Series

Description

Returns a data frame with available series in the WEO database.

Usage

weo_get_series(year = NULL, release = NULL, quiet = TRUE)

Arguments

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:

series_id

The WEO series ID (e.g., "NGDP_RPCH")

series_name

Full name of the series (e.g., "Gross domestic product, constant prices")

units

Units of measurement

Examples



# List all series
weo_get_series()

List Available IMF WEO Publications

Description

Returns a data frame of the WEO publications this package knows how to download. The IMF releases the WEO database twice per year:

The list is maintained as a lookup table inside the package rather than detected online, because releases published on the IMF Data portal (October 2025 onwards) sit behind opaque per-vintage identifiers. A new release therefore only becomes available after a package update.

Usage

weo_list_publications(start_year = 2007, end_year = NULL)

Arguments

start_year

Minimum year to include. Defaults to 2007.

end_year

Maximum year to include. Defaults to the year of the most recent known publication.

Value

A data frame with columns:

year

The year of the release

release

The release name ("Spring" or "Fall")

month

The month of release ("April" or "October")

Examples

weo_list_publications()