imf_weo: Download World Economic Outlook data

View source: R/imf_weo.R

imf_weoR Documentation

Download World Economic Outlook data

Description

Fetch series from the IMF World Economic Outlook (WEO), the Fund's flagship forecast database. The WEO is openly available, so no API key is required.

Usage

imf_weo(
  indicator = NULL,
  country = NULL,
  start = NULL,
  end = NULL,
  vintage = "latest"
)

Arguments

indicator

Character vector of WEO indicator codes, for example "NGDP_RPCH" (real GDP growth), "NGDPD" (GDP in US dollars) or "PCPIPCH" (inflation). NULL (the default) returns every indicator.

country

Character vector of ISO 3-letter country codes, for example c("GBR", "USA"). NULL (the default) returns every economy.

start, end

Optional first and last year to keep, for example 2000 and 2024.

vintage

Either "latest" (the current WEO release, the default) or a tag of the form "YYYY-MM" such as "2025-10" to request a specific historical release for forecast evaluation.

Value

An object of class imf_tbl (a data frame) with columns country, indicator, freq, period and value, carrying provenance attributes.

Examples


imf_weo("NGDP_RPCH", country = c("GBR", "USA"), start = 2015, end = 2024)


readimf documentation built on June 15, 2026, 5:07 p.m.