IMF Data

How to Use This API

1. Get GDP (Nominal) for All Countries

https://www.imf.org/external/datamapper/api/v1/NGDPD

Returns nominal GDP in current US dollars for every country with data.

2. Get GDP for Specific Countries

https://www.imf.org/external/datamapper/api/v1/NGDPD/USA,CHN,JPN,DEU,GBR

Specify comma-separated ISO 3-letter country codes. Use all for every country.

3. Get GDP Per Capita (PPP)

https://www.imf.org/external/datamapper/api/v1/NGDPDPC

NGDPDPC is GDP per capita, current prices, US dollars.

4. Get Inflation (CPI) Data

https://www.imf.org/external/datamapper/api/v1/PCPIEPCH

PCPIEPCH is inflation, average consumer prices, percent change. Use /USA,CHN for specific countries.

5. Get Government Debt as % of GDP

https://www.imf.org/external/datamapper/api/v1/GGXWDG_NGDP

General government gross debt as a percentage of GDP. Key indicator for fiscal health.

6. Response Format

{
  "values": {
    "NGDPD": {
      "USA": {
        "2023": 273609.0,
        "2024": 287810.0,
        "2025": 296420.0
      },
      "CHN": {
        "2023": 177010.0,
        "2024": 185340.0
      }
    }
  }
}

Values are organized by indicator, then country, then year. GDP values are in billions of US dollars.

7. JavaScript — Fetch Country GDP

fetch('https://www.imf.org/external/datamapper/api/v1/NGDPD/USA')
  .then(r => r.json())
  .then(d => {
    const values = d.values.NGDPD.USA;
    Object.entries(values)
      .sort(([a], [b]) => a - b)
      .forEach(([year, val]) => {
        console.log(`${year}: $${(val).toFixed(0)}B`);
      });
  });

8. Python — Compare GDP Across Countries

import requests

resp = requests.get(
    'https://www.imf.org/external/datamapper/api/v1/NGDPD/USA,CHN,JPN,DEU,IND'
)
data = resp.json()
indicator = 'NGDPD'
print("GDP Comparison (2024, billions USD):")
for country, years in data['values'][indicator].items():
    latest = list(years.keys())[0]
    print(f"  {country}: ${years[latest]:.0f}B")

9. Python — GDP Growth Comparison

import requests

resp = requests.get(
    'https://www.imf.org/external/datamapper/api/v1/NGDP_RPCH/USA,CHN,IND'
)
data = resp.json()
indicator = 'NGDP_RPCH'
print("Real GDP Growth (%):")
for country, years in data['values'][indicator].items():
    for year, val in sorted(years.items()):
        print(f"  {country} {year}: {val:.1f}%")