Microsoft Store

Get a Microsoft Store department's special-events shelf

Returns a department's "Special events" promotional shelf -- featured/limited-time products, distinct from the ranked charts (/microsoftstore/charts) and the curated home/department spotlight (/microsoftstore/spotlight). Only apps and games have this shelf; any other media_type is rejected.

get/microsoftstore/events

Request

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

Query parameters

media_type'apps' | 'games'

Department to fetch special events for

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": {
    "count": 7,
    "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"
      }
    ],
    "media_type": "apps",
    "page": 1,
    "page_size": 20,
    "title": "Special events"
  },
  "msg": "OK"
}

Changes

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