microsoftstore_charts
Fetch curated Microsoft Store app and game charts—top free, paid, grossing, trending, deals, new releases, or popular—filtered by category, country, or Game Pass.
Instructions
Get a curated Microsoft Store chart. Returns a curated Microsoft Store chart (top free, top paid, top grossing, trending, deals, new releases, getting-started picks, or -- apps only -- most popular), optionally scoped to a category/subcategory and, for games, by Xbox Game Pass availability or player count. Some charts (notably NewAndRising) can legitimately return fewer items than page_size even at the first page -- that reflects real sparsity for that chart.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list | Yes | Chart to fetch | |
| page | No | 1-based page number | |
| locale | No | Display locale (BCP-47) | |
| country | No | Store country/region code (ISO-2) | |
| category | No | Optional category to scope the chart to further | |
| page_size | No | Items per page (max 24) | |
| media_type | No | Department to scope the chart to | |
| subcategory | No | Optional finer subcategory within category (apps only; requires category to also be set) | |
| discount_filter | No | Optional discount filter | |
| num_players_filter | No | Optional player-count filter (games only) | |
| subscription_filter | No | Optional subscription filter (games only) |