# Microsoft API: List top charts

> Lists the ranked Microsoft Store apps or games in a top chart, optionally for one category and country. Paid listings without a published numeric price return a null price.

Unofficial. Not affiliated with or endorsed by Microsoft.

- Page: https://fous.com/methods/apps.microsoft.com/list-top-charts
- Method: `apps.microsoft.com/list_top_charts`, version 1
- Website: apps.microsoft.com
- Returns: rank, name, publisher, average rating, price, currency, store link, product id
- 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 |
|---|---|---|---|---|
| `chart` | string | no | `"top_free_apps"` | Chart to list, for example top_free_apps. Default "top_free_apps". |
| `country` | string | no | `"United States"` | Country name or two-letter code, for example United States or US. Default "United States". |
| `category` | string | no | `"productivity"` | Store category name, for example productivity or photo and video; default all. Default "all". |
| `max_results` | integer | no | `8` | Maximum ranked items to return, for example 50. Default 50. |

## Output

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

```json
{
  "chart": "top_free_apps",
  "country": "United States",
  "category": "productivity",
  "max_results": 8
}
```

Its output:

```json
{
  "chart": "Top free apps",
  "items": [
    {
      "name": "Adobe Acrobat Reader DC",
      "rank": 1,
      "price": 0,
      "currency": "USD",
      "publisher": "ADOBE INC.",
      "store_link": "https://apps.microsoft.com/detail/xpdp273c0xhqh2?hl=en-US&gl=US",
      "average_rating": 3.4,
      "store_product_id": "xpdp273c0xhqh2"
    },
    {
      "name": "Zoom Workplace",
      "rank": 2,
      "price": 0,
      "currency": "USD",
      "publisher": "Zoom Communications, Inc.",
      "store_link": "https://apps.microsoft.com/detail/xp99j3kp4xz4vv?hl=en-US&gl=US",
      "average_rating": 4.2,
      "store_product_id": "xp99j3kp4xz4vv"
    },
    {
      "name": "Microsoft Teams",
      "rank": 3,
      "price": 0,
      "currency": "USD",
      "publisher": "Microsoft Corporation",
      "store_link": "https://apps.microsoft.com/detail/xp8bt8dw290mpq?hl=en-US&gl=US",
      "average_rating": 3.3,
      "store_product_id": "xp8bt8dw290mpq"
    }
  ]
}
```

## 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":"apps.microsoft.com/list_top_charts","input":{"chart":"top_free_apps","country":"United States","category":"productivity","max_results":8}}'
```

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

- Show me the top free apps on the Microsoft Store in the United States right now
- What are the highest ranked paid games in the Microsoft Store for Germany, top 20 with prices?
- List the top productivity apps on Microsoft Store in the UK, including ratings and publishers
- Which photo and video apps rank highest in the Microsoft Store chart for CA? Give me 10 results
- I need the top 75 free games chart from the Microsoft Store in Japan with product IDs and store links

## Input schema

```json
{
  "type": "object",
  "properties": {
    "chart": {
      "type": "string",
      "default": "top_free_apps",
      "description": "Chart to list, for example top_free_apps."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code, for example United States or US."
    },
    "category": {
      "type": "string",
      "default": "all",
      "description": "Store category name, for example productivity or photo and video; default all."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum ranked items to return, for example 50.",
      "x-fous-developer": true
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "chart",
    "items"
  ],
  "properties": {
    "chart": {
      "type": "string",
      "description": "Chart name."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "name",
          "publisher",
          "average_rating",
          "price",
          "currency",
          "store_link",
          "store_product_id"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "rank": {
            "type": "integer"
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "publisher": {
            "type": [
              "string",
              "null"
            ]
          },
          "store_link": {
            "type": "string"
          },
          "average_rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "store_product_id": {
            "type": "string",
            "x-fous-developer": true
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Microsoft API: Search Microsoft Store apps](https://fous.com/methods/apps.microsoft.com/search-apps.md): Searches Microsoft Store apps and games by keywords in a chosen country and returns them in Store order. Subscription-included items can show a price of 0.
- [Microsoft API: Get app](https://fous.com/methods/apps.microsoft.com/get-app.md): Looks up the best-matching Microsoft Store app or game by name, store link or product ID, optionally filtered by publisher and country, and returns its listing details.
- [Apple API: List top App Store charts](https://fous.com/methods/apps.apple.com/list-top-charts.md): Lists ranked iPhone or iPad apps from the public App Store charts for a chart, category, and country. App bundles and apps that are no longer available are left out.
- [Google API: List Google Play top charts](https://fous.com/methods/play.google.com/list-top-charts.md): Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
- [Apple API: List top charts](https://fous.com/methods/music.apple.com/list-top-charts.md): Lists the current top songs, albums, or music videos on Apple Music for a country, in chart order. Countries without an Apple Music chart return no results.
- [Apple API: List top podcasts](https://fous.com/methods/podcasts.apple.com/list-top-podcasts.md): Lists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes.
- [Roblox API: List top games](https://fous.com/methods/roblox.com/list-top-games.md): Lists ranked Roblox experiences from a current Charts list. Each game includes players online, approval percentage, creator, icon and game link.
- [Spotify API: List top podcasts](https://fous.com/methods/open.spotify.com/list-top-podcasts.md): Lists Spotify's top or trending podcasts for a country in chart order, with rank, movement, publisher, artwork and Spotify link. Category charts exist only for some countries.
- [All Microsoft methods](https://fous.com/methods/microsoft.com.md)