# Microsoft API: Search Microsoft Store apps

> 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.

Unofficial. Not affiliated with or endorsed by Microsoft.

- Page: https://fous.com/methods/apps.microsoft.com/search-apps
- Method: `apps.microsoft.com/search_apps`, version 1
- Website: apps.microsoft.com
- Returns: name, publisher, average rating, rating count, price, currency, type, 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 |
|---|---|---|---|---|
| `type` | string | no | `"games"` | Search all listings, apps only or games only; for example games. One of "all", "apps", "games". Default "all". |
| `query` | string | yes | `"minecraft"` | Words to search for, for example pdf editor. |
| `country` | string | no | `"Canada"` | Country name or two-letter code, for example Canada or CA. Default "United States". |
| `max_results` | integer | no | `25` | Maximum number of results, for example 20. Default 20. |

## Output

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

```json
{
  "type": "games",
  "query": "minecraft",
  "country": "Canada",
  "max_results": 25
}
```

Its output:

```json
{
  "results": [
    {
      "name": "Minecraft Dungeons II",
      "type": "game",
      "price": 0,
      "currency": "CAD",
      "publisher": "Xbox Game Studios",
      "store_link": "https://apps.microsoft.com/detail/9pm3j18qm4q3?gl=CA&hl=en-US",
      "rating_count": 13,
      "average_rating": 2.7,
      "store_product_id": "9pm3j18qm4q3"
    },
    {
      "name": "Minecraft Dungeons II Deluxe Edition",
      "type": "game",
      "price": 69.99,
      "currency": "CAD",
      "publisher": "Xbox Game Studios",
      "store_link": "https://apps.microsoft.com/detail/9mzv840ndmbm?gl=CA&hl=en-US",
      "rating_count": 10,
      "average_rating": 2.3,
      "store_product_id": "9mzv840ndmbm"
    },
    {
      "name": "Minecraft Dungeons II Deluxe Upgrade",
      "type": "game",
      "price": 29.99,
      "currency": "CAD",
      "publisher": "Xbox Game Studios",
      "store_link": "https://apps.microsoft.com/detail/9ngkd5t4jrg9?gl=CA&hl=en-US",
      "rating_count": null,
      "average_rating": 0,
      "store_product_id": "9ngkd5t4jrg9"
    }
  ]
}
```

## 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/search_apps","input":{"type":"games","query":"minecraft","country":"Canada","max_results":25}}'
```

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

- Find free photo editing apps in the Microsoft Store for United States, top 10 results
- Show me games on the Store matching racing simulator, limit 15, country CA
- Search Microsoft Store apps for pdf editor available in the UK, all types
- What Store listings come up for meditation app in Germany, maximum 25 results?
- Look up games with the keyword co-op puzzle in the US Store and tell me their prices and ratings

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "type": {
      "enum": [
        "all",
        "apps",
        "games"
      ],
      "type": "string",
      "default": "all",
      "description": "Search all listings, apps only or games only; for example games."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words to search for, for example pdf editor."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code, for example Canada or CA."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of results, for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "publisher",
          "average_rating",
          "rating_count",
          "price",
          "currency",
          "type",
          "store_link",
          "store_product_id"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "type": {
            "enum": [
              "app",
              "game"
            ],
            "type": "string"
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "publisher": {
            "type": [
              "string",
              "null"
            ]
          },
          "store_link": {
            "type": "string"
          },
          "rating_count": {
            "type": [
              "integer",
              "null"
            ]
          },
          "average_rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "store_product_id": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

## See more

- [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.
- [Microsoft API: List top charts](https://fous.com/methods/apps.microsoft.com/list-top-charts.md): 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.
- [Google API: Search Google Play apps](https://fous.com/methods/play.google.com/search-apps.md): Finds Android apps on Google Play by keywords, in Play search order, with each listing's developer, star rating, price and currency for the chosen country, download range and link. Results are limited to apps shown on the public search page.
- [Apple API: Search apps](https://fous.com/methods/apps.apple.com/search-apps.md): Finds iPhone and iPad apps by keyword in a chosen country's App Store, with ratings, prices, categories and App Store links.
- [Apple API: Search podcasts](https://fous.com/methods/podcasts.apple.com/search-podcasts.md): Finds Apple Podcasts shows by name or topic in a country, ordered by search relevance, with ratings when the show page provides them.
- [Spotify API: Search music](https://fous.com/methods/spotify.com/search-music.md): Searches Spotify for songs, artists, albums, playlists or podcasts by keywords and returns them in Spotify's result order. Songs and albums include a release date when Spotify gives a full date.
- [Xbox API: Get game](https://fous.com/methods/xbox.com/get-game.md): Finds an Xbox or PC game by name or by xbox.com store link. Returns its store details, prices and Game Pass availability for a country.
- [Apple API: Search songs](https://fous.com/methods/music.apple.com/search-songs.md): Searches the Apple Music song catalog by title and artist words, returning matching tracks in relevance order with prices and previews when available.
- [All Microsoft methods](https://fous.com/methods/microsoft.com.md)