# IMF API: List country rankings

> Ranks countries by a World Economic Outlook indicator for a chosen year, excluding regional and group totals and countries without a value.

Unofficial. Not affiliated with or endorsed by IMF.

- Page: https://fous.com/methods/imf.org/list-country-rankings
- Method: `imf.org/list_country_rankings`, version 1
- Website: imf.org
- Returns: indicator, unit, year, data status, ranked countries with values and page URLs
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `year` | integer | no |  | Calendar year to rank, for example 2026. Defaults to the current year. |
| `order` | string | no |  | Sort direction, for example highest_first. One of "highest_first", "lowest_first". Default "highest_first". |
| `indicator` | string | no |  | Economic measure to rank, for example gdp_growth. One of "gdp_growth", "inflation", "unemployment", "gdp", "gdp_per_person", "government_debt". Default "gdp_growth". |
| `max_results` | integer | no |  | Maximum countries to return, for example 20. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{}
```

Its output:

```json
{
  "unit": "%",
  "year": 2026,
  "rankings": [
    {
      "rank": 1,
      "value": 22.3,
      "country": "Guyana",
      "page_url": "https://www.imf.org/external/datamapper/NGDP_RPCH@WEO/GUY"
    },
    {
      "rank": 2,
      "value": 10.7,
      "country": "Taiwan Province of China",
      "page_url": "https://www.imf.org/external/datamapper/NGDP_RPCH@WEO/TWN"
    },
    {
      "rank": 3,
      "value": 10.5,
      "country": "South Sudan, Republic of",
      "page_url": "https://www.imf.org/external/datamapper/NGDP_RPCH@WEO/SSD"
    }
  ],
  "indicator": "Real GDP growth",
  "data_status": "Forecast"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"imf.org/list_country_rankings","input":{}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Which countries had the highest GDP growth rate in 2026 according to the IMF World Economic Outlook?
- Rank the lowest inflation countries for 2025, top 15, from lowest to highest
- Show me a ranking of countries by unemployment rate for 2027, highest first, limited to 10 results
- List the countries with the largest government debt as a share of GDP in 2024 on imf.org
- I need the top 50 countries ranked by GDP per person for 2026, sorted from lowest to highest value

## Input schema

```json
{
  "type": "object",
  "required": [],
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 1900,
      "description": "Calendar year to rank, for example 2026. Defaults to the current year."
    },
    "order": {
      "enum": [
        "highest_first",
        "lowest_first"
      ],
      "type": "string",
      "default": "highest_first",
      "description": "Sort direction, for example highest_first."
    },
    "indicator": {
      "enum": [
        "gdp_growth",
        "inflation",
        "unemployment",
        "gdp",
        "gdp_per_person",
        "government_debt"
      ],
      "type": "string",
      "default": "gdp_growth",
      "description": "Economic measure to rank, for example gdp_growth."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum countries to return, for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "indicator",
    "unit",
    "year",
    "data_status",
    "rankings"
  ],
  "properties": {
    "unit": {
      "type": "string"
    },
    "year": {
      "type": "integer"
    },
    "rankings": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "country",
          "value",
          "page_url"
        ],
        "properties": {
          "rank": {
            "type": "integer"
          },
          "value": {
            "type": "number"
          },
          "country": {
            "type": "string"
          },
          "page_url": {
            "type": "string"
          }
        }
      }
    },
    "indicator": {
      "type": "string"
    },
    "data_status": {
      "enum": [
        "Actual",
        "Forecast"
      ],
      "type": "string"
    }
  }
}
```

## See more

- [IMF API: Get economic forecast](https://fous.com/methods/imf.org/get-economic-forecast.md): Gets World Economic Outlook figures for a country or region by year, labelled as actual or forecast. Measures the IMF does not publish for a year are null.
- [World Bank API: Compare countries by a statistic](https://fous.com/methods/worldbank.org/compare-countries.md): Ranks countries by a World Development Indicators statistic for a given year, or for the latest year with broad country coverage. Regional aggregates and countries without data for that year are left out.
- [Trading Economics API: List countries by indicator](https://fous.com/methods/tradingeconomics.com/list-countries-by-indicator.md): Compares the latest reported value of an economic indicator across countries in a region, highest first. World includes all listed countries; Australia uses the Oceania region.
- [World Bank API: Get country statistic](https://fous.com/methods/data.worldbank.org/get-country-statistic.md): Looks up a World Bank statistic for a country and returns its annual values and latest value for the selected years.
- [FIFA API: Get world ranking](https://fous.com/methods/fifa.com/get-world-ranking.md): Gets the latest official FIFA men's or women's national-team ranking, with points and movement since the previous ranking. Unranked teams are excluded.
- [Forbes API: List Forbes Global 2000 companies](https://fous.com/methods/forbes.com/list-global-2000.md): Lists companies in the Forbes Global 2000 in rank order, optionally for a given year, country of headquarters and industry. Financial figures are in billions of US dollars; up to 500 results.
- [World Health Organization API: Get country health statistics](https://fous.com/methods/who.int/get-country-health-statistics.md): Gets the latest WHO value of a health statistic for a country, with sex-specific values, the regional value for the same year, and up to 10 years of history.
- [Times Higher Education API: List THE World University Rankings](https://fous.com/methods/timeshighereducation.com/list-university-rankings.md): Lists THE World University Rankings for a year, optionally filtered by country, with displayed ranks, scores, student figures and university links. Subject rankings are supported by name.
- [All IMF methods](https://fous.com/methods/imf.org.md)