IMF

Economic forecasts, country rankings and economic indicators

IMF economic data provides country and regional forecasts with actual or forecast labels, and country rankings by World Economic Outlook indicators, excluding groups and missing values.

Get economic forecast

Get World Economic Outlook figures for a country or region by year, with actual or forecast labels. Unavailable measures are null; some regions have no WEO series.

Your information

Country

Country or region name, such as Germany, World, or Euro area.

More options

End YearOptional

Last year to show, for example 2028. Defaults to two years after the current year.

Start YearOptional

First year to show, for example 2024. Defaults to the current year.

1 credit per completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

Germany economic outlook

Germany, April 2026

Year	Status	Real GDP growth	Inflation	GDP (US$ billions)
2,026	forecast	0.8%	2.7%	5,452.86
2,027	forecast	1.2%	2.3%	5,642.16
2,028	forecast	1.2%	2%	5,818.88

About the IMF tool

IMF, also called IMF DataMapper, returns World Economic Outlook figures by year for a country or region supplied as input.

IMF ranks countries by a selected World Economic Outlook indicator and year, with an optional sort direction and result limit.

Built from imf.org. Last checked Sep 29, 2026.

Actions

Get economic forecast

1 credit

Get World Economic Outlook figures for a country or region by year, with actual or forecast labels. Unavailable measures are null; some regions have no WEO series.

What you provide

Field	Type	Required	Description
Country`country`	Text	Required	Country or region name, such as Germany, World, or Euro area.Example: Germany
End Year`end_year`	Number	Optional	Last year to show, for example 2028. Defaults to two years after the current year.Example: 2027
Start Year`start_year`	Number	Optional	First year to show, for example 2024. Defaults to the current year.Example: 2025

What you get

Field	Type	Description
Years`years`	List	Economic measures for each requested year.
Year`years[].year`	Number	Example: 2026
Status`years[].status`	Text	Example: Forecast
Page URL`years[].page_url`	Text	Example: https://www.imf.org/external/datamapper/NGDP_RPCH@WEO/DEU
Gdp Billions (USD)`years[].gdp_billions_usd`	Number	Example: 5452.858
Inflation (%)`years[].inflation_percent`	Number	Example: 2.7
Gdp Per Person (USD)`years[].gdp_per_person_usd`	Number	Example: 65302.893
Unemployment (%)`years[].unemployment_percent`	Number	Example: 3.9
Real Gdp Growth (%)`years[].real_gdp_growth_percent`	Number	Example: 0.8
Government Debt Percent of Gdp`years[].government_debt_percent_of_gdp`	Number	Example: 64.6
Current Account Balance Percent of Gdp`years[].current_account_balance_percent_of_gdp`	Number	Example: 3.9
Country`country`	Text	Country or region name.Example: Germany
Weo Edition`weo_edition`	Text	World Economic Outlook edition.Example: April 2026
Imf Country Code`imf_country_code`	Text	IMF code for this country or group.Example: DEU

Example result

For Country: Germany

JSON

{
  "years": [
    {
      "year": 2026,
      "status": "forecast",
      "page_url": "https://www.imf.org/external/datamapper/NGDP_RPCH@WEO/DEU",
      "gdp_billions_usd": 5452.858,
      "inflation_percent": 2.7,
      "gdp_per_person_usd": 65302.893,
      "unemployment_percent": 3.9,
      "real_gdp_growth_percent": 0.8,
      "government_debt_percent_of_gdp": 64.6,
      "current_account_balance_percent_of_gdp": 3.9
    },
    {
      "year": 2027,
      "status": "forecast",
      "page_url": "https://www.imf.org/external/datamapper/NGDP_RPCH@WEO/DEU",
      "gdp_billions_usd": 5642.156,
      "inflation_percent": 2.3,
      "gdp_per_person_usd": 67613.107,
      "unemployment_percent": 3.5,
      "real_gdp_growth_percent": 1.2,
      "government_debt_percent_of_gdp": 66.5,
      "current_account_balance_percent_of_gdp": 3.8
    },
    {
      "year": 2028,
      "status": "forecast",
      "page_url": "https://www.imf.org/external/datamapper/NGDP_RPCH@WEO/DEU",
      "gdp_billions_usd": 5818.884,
      "inflation_percent": 2,
      "gdp_per_person_usd": 69804.854,
      "unemployment_percent": 3.2,
      "real_gdp_growth_percent": 1.2,
      "government_debt_percent_of_gdp": 68.4,
      "current_account_balance_percent_of_gdp": 3.8
    }
  ],
  "country": "Germany",
  "weo_edition": "April 2026",
  "imf_country_code": "DEU"
}

List country rankings

1 credit

Rank countries by a World Economic Outlook indicator for a chosen year. Excludes regional and country-group totals and countries without a value; forecast labels follow the indicator’s published projection year.

What you provide

Field	Type	Required	Description
Year`year`	Number	Optional	Calendar year to rank, for example 2026. Defaults to the current year.Example: 2024
Order`order`	Text	Optional	Sort direction, for example highest_first.Example: Lowest first
Indicator`indicator`	Text	Optional	Economic measure to rank, for example gdp_growth.Example: Government debt
Max Results`max_results`	Number	Optional	Maximum countries to return, for example 20.Example: 7

What you get

Field	Type	Description
Unit`unit`	Text	Unit of the country values.Example: % of GDP
Year`year`	Number	Calendar year of the rankings.Example: 2024
Rankings`rankings`	List
Rank`rankings[].rank`	Number	Example: 1
Value`rankings[].value`	Number	Example: 0
Country`rankings[].country`	Text	Example: Macao SAR
Page URL`rankings[].page_url`	Text	IMF DataMapper page for this indicator and country.Example: https://www.imf.org/external/datamapper/GGXWDG_NGDP@WEO/MAC
Indicator`indicator`	Text	Plain name of the economic measure.Example: Government debt
Data Status`data_status`	Text	Whether the chosen year precedes the forecast cutoff.Example: Actual

Example result

For Year: 2024, Order: Lowest first, Indicator: Government debt, Max Results: 7

JSON

{
  "unit": "% of GDP",
  "year": 2024,
  "rankings": [
    {
      "rank": 1,
      "value": 0,
      "country": "Macao SAR",
      "page_url": "https://www.imf.org/external/datamapper/GGXWDG_NGDP@WEO/MAC"
    },
    {
      "rank": 2,
      "value": 0.5,
      "country": "Liechtenstein",
      "page_url": "https://www.imf.org/external/datamapper/GGXWDG_NGDP@WEO/LIE"
    },
    {
      "rank": 3,
      "value": 1.6,
      "country": "Brunei Darussalam",
      "page_url": "https://www.imf.org/external/datamapper/GGXWDG_NGDP@WEO/BRN"
    }
  ],
  "indicator": "Government debt",
  "data_status": "Actual"
}

For developers

Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.

cURL

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@imf",
  "visibility": "public",
  "operation": "get_economic_forecast",
  "version": 1,
  "input": {
    "country": "Germany"
  },
  "response": {
    "format": "json"
  }
}'

What you can do with it

Compare economic forecasts across countries and years
Track projected inflation and unemployment
Rank countries by economic growth
Review government debt as a share of GDP
Compare GDP per person across regions

Questions about IMF

Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

Can I call this IMF tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

Do I need a IMF account?

No. You only need a Fous account.

How current is the data?

Fous gets the data from imf.org when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.