Microsoft Store

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.

get/microsoftstore/charts

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/microsoftstore/charts
  • Auth: API key in header x-api-key

Query parameters

list'TopFree' | 'TopPaid' | 'TopGrossing' | 'toptrending' | 'NewAndRising' | 'Deal' | 'GettingStartedApps' | 'MostPopular' required

Chart to fetch

media_type'apps' | 'games'

Department to scope the chart to

categorystring

Optional category to scope the chart to further

subcategorystring

Optional finer subcategory within category (apps only; requires category to also be set)

discount_filter'onsale'

Optional discount filter

subscription_filter'gamepass'

Optional subscription filter (games only)

num_players_filter'AllPlayers' | 'SinglePlayer' | 'OnlineMultiplayerWithGold' | 'LocalMultiplayer' | 'CoopSupportOnline' | 'CoopSupportLocal'

Optional player-count filter (games only)

pageinteger

1-based page number

page_sizeinteger

Items per page (max 24)

countrystring

Store country/region code (ISO-2)

localestring

Display locale (BCP-47)

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "category": "Photo & video",
    "count": 20,
    "discount_filter": "onsale",
    "items": [
      {
        "average_rating": 4.3,
        "award": {
          "category": "Productivity category",
          "description": "The Microsoft Store Awards celebrate apps and games that emphasize exceptional experiences for their users.",
          "editorial_id": "Editorials/Awards_2025/Global/Notion_xpdbvss44r0l9h",
          "title": "Microsoft Store Awards 2025",
          "year": 2025
        },
        "categories": [
          "[\"Music\"]"
        ],
        "description": "Love music and podcasts? Play your favorite songs...",
        "display_price": "Free",
        "free": true,
        "icon_url": "https://store-images.s-microsoft.com/image/apps.10546...",
        "is_application": true,
        "kind": "app",
        "media_type": "Apps",
        "product_id": "9ncbcszsjrsb",
        "publisher": "Spotify AB",
        "rating_count": "34K",
        "release_date_utc": "2017-10-24T12:04:25Z",
        "title": "Spotify - Music and Podcasts",
        "url": "https://apps.microsoft.com/detail/9ncbcszsjrsb"
      }
    ],
    "list": "TopFree",
    "media_type": "apps",
    "num_players_filter": "SinglePlayer",
    "page": 1,
    "page_size": 20,
    "subcategory": "E-reader",
    "subscription_filter": "gamepass",
    "title": "Must-have free apps"
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.