Package 'imfweo'

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 [email protected]

Authors:

• Christoph Scheuch [email protected] (ORCID)

Other contributors:

• Teal Insights [copyright holder]

See Also

Useful links:

• https://teal-insights.github.io/r-imfweo/

• https://github.com/teal-insights/r-imfweo/

• Report bugs at https://github.com/teal-insights/r-imfweo/issues

---

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:

• Spring (April)

• Fall (October)

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()

---