Microproduct Data GuideBeginner

IMF World Economic Outlook

Comparable national growth, inflation, labor, fiscal, trade, and forecast indicators for building international outlook and revision tools.

Start the Guide Open Official Source Open in Colab
Report a Problem

At a Glance

Difficulty
Beginner — comfortable for a first prototype
Size
Small · ≤0.1 GB
Formats
JSON, XLSX
Access
API or Download
API Key
Not Required
Provider
International Monetary Fund
Updates
Occasional
Last Verified
Sep 27, 2026
Source Type
Intergovernmental Source
Data Terms
IMF website and data terms and conditions
  • Python Syntax Checked
  • Runnable Notebook

From Source to Product Signal

Test a Product Idea in Four Steps

The World Economic Outlook provides comparable historical estimates and projections for countries and groups. Start with real GDP growth, three countries, and a short period. Projected years are not observations, and releases revise both forecasts and historical estimates.

1

Check the Setup

  • Python 3.10 or newer
  • A notebook environment such as Jupyter or Google Colab
  • An internet connection
2

Access the Data

  1. 1.Check the current WEO release date and indicator definition.
  2. 2.Request one indicator for three countries and a bounded year range.
  3. 3.Label historical and projected periods and retain the release name with the data.
Open Official Source
3

Run the Python Example

Install the packages, then run the notebook cell.

python -m pip install pandas requests

import pandas as pd
import requests

response = requests.get(
    "https://www.imf.org/external/datamapper/api/v1/NGDP_RPCH/USA/DEU/JPN",
    timeout=30,
)
response.raise_for_status()
values = response.json()["values"]["NGDP_RPCH"]
growth = pd.DataFrame(values).sort_index()
print(growth.tail(10))
4

Test a Useful Signal

Compare Three Country Growth Outlooks

Compare recent and projected real GDP growth for the United States, Germany, and Japan.

  1. 01Record the WEO release and retrieve only the real GDP growth indicator for three countries.
  2. 02Mark which years are estimates or projections before comparing paths.
  3. 03Explain how forecast uncertainty, revisions, missing values, and country definitions limit conclusions.

Related Datasets

Dataset Details

International Monetary Fund is an intergovernmental source. Last verified 2026-09-27. Temporal coverage: 1980-present with projections for approximately five years.

Geography

Global

Formats

JSONXLSX

Provider

International Monetary Fund

Data Terms

IMF website and data terms and conditions

Send Feedback