GET/microsoftstore/categoriesapiKey1 credit/request
Returns every accepted category for a department, and -- apps only -- each category's own finer subcategories (e.g. Books & reference -> E-reader, Fiction, Nonfiction, Reference). This is the discovery endpoint for the category/subcategory values accepted by /microsoftstore/search, /microsoftstore/category, and /microsoftstore/charts. Subcategories are apps-only: games categories have none.
Optional: media_type (8 allowed values: apps, games, devices, passes, fonts, themes, tencent-android, tencent-mini).
Sampled 14 Oct 2026: 25 items. Filled in every item: category. Not in every item: subcategories (13). In the sample: category: “Books & reference” and 24 other values; subcategories: median 4 entries.
Open in Playground
GET/microsoftstore/categoryapiKey1 credit/request
Returns a page of a single department+category listing, cursor-paginated, with no search keyword required -- the way to list an entire category (search requires a non-empty query and returns nothing for an empty one). category is required; the accepted set depends on media_type (see /microsoftstore/search's markdown doc for the full per-department lists). media_type defaults to apps; all is not accepted here since it has no category filter.
Required: category. Optional: media_type (8 allowed values: apps, games, devices, passes, fonts, themes, tencent-android, tencent-mini), cursor, country, locale.
Sampled 14 Oct 2026: 20 items. Filled in every item: product_id, title, description, publisher, categories, media_type, kind, average_rating and 8 more. Not in every item: release_date_utc (14). In the sample: release_date_utc: 2013-05-17 to 2025-09-16; display_price: Free (19), Paid (1); average_rating: 3.2 to 4.9, median 4.5; title: “CapCut” and 19 other values; icon_url: images-eds-ssl.xboxlive.com and 1 other host; free: true in 20 of 20; description: median 1,518 characters; categories: median 1 entry.
Open in Playground
GET/microsoftstore/chartsapiKey1 credit/request
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.
Required: list (8 allowed values: TopFree, TopPaid, TopGrossing, toptrending, NewAndRising, Deal, GettingStartedApps, MostPopular). Optional: media_type (2 allowed values: apps, games), category, subcategory, discount_filter (onsale), subscription_filter (gamepass), num_players_filter (6 allowed values: AllPlayers, SinglePlayer, OnlineMultiplayerWithGold, LocalMultiplayer, CoopSupportOnline, CoopSupportLocal), page, page_size, country, locale.
Sampled 14 Oct 2026: 20 items. Filled in every item: product_id, title, description, publisher, categories, media_type, kind, average_rating and 8 more. Not in every item: release_date_utc (14), is_pwa (4), award (1). In the sample: release_date_utc: 2010-10-18 to 2026-03-04; average_rating: 2.4 to 4.9, median 4.1; title: “WhatsApp” and 19 other values; icon_url: store-images.s-microsoft.com and 2 other hosts; free: true in 20 of 20; description: median 455 characters; categories: median 1 entry; publisher: “WhatsApp Inc.” and 16 other values.
Open in Playground
GET/microsoftstore/editorialapiKey1 credit/request
Returns a Microsoft Store editorial article (currently only seen in the wild as a per-product Microsoft Store Awards writeup). There is no discovery endpoint for editorial ids: they are only found embedded in a product's own award.editorial_id field, returned by /microsoftstore/search, /microsoftstore/category, /microsoftstore/charts, /microsoftstore/publisher, and /microsoftstore/related when that product carries an award. An unknown/invalid id returns a 503 upstream error, not a clean 404 -- the upstream itself does not distinguish the two.
Required: editorial_id. Optional: country, locale.
Sampled 14 Oct 2026: 7 fields returned with a value. In the sample: header_image: images-eds-ssl.xboxlive.com; title: 21 characters; paragraphs: 1 entry; subtitle.text: 27 characters; subtitle.icon: cdn.storeedgefd.dsx.mp.microsoft.com; relevant_products: 1 entry.
Open in Playground
GET/microsoftstore/eventsapiKey1 credit/request
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.
Optional: media_type (2 allowed values: apps, games), page, page_size, country, locale.
Sampled 14 Oct 2026: 19 items. Filled in every item: product_id, title, description, publisher, categories, media_type, kind, average_rating and 8 more. Not in every item: release_date_utc (18), is_pwa (8). In the sample: release_date_utc: 2010-10-18 to 2026-06-10; title: Amazon Music (5), Paramount+ (3), Netflix (3) and 5 more; average_rating: 2.6 to 4.7, median 3.8; icon_url: images-eds-ssl.xboxlive.com and 1 other host; free: true in 19 of 19; description: median 1,209 characters; categories: median 1 entry; publisher: AMZN Mobile LLC (5), CBS Interactive Inc. (3), Netflix, Inc. (3) and 5 more.
Open in Playground
GET/microsoftstore/productapiKey1 credit/request
Returns Microsoft Store listing details for a single product id: title, description, publisher, category, media type, aggregate rating and content-rating breakdown, price and SKU summary, size, supported platforms/languages, capabilities, version/release/update timestamps, feature callouts, and media (icon, poster art, screenshots, trailers).
Required: product_id. Optional: country, locale.
Sampled 14 Oct 2026: 37 fields returned with a value. In the sample: release_date_utc: 2017-10-24; average_rating: 4.3; title: “Spotify - Music and Podcasts”; website: spotify.com; free: true; description: 1,690 characters; categories: 1 entry; publisher: “Spotify AB”.
Open in Playground
GET/microsoftstore/publisherapiKey1 credit/request
Returns every product a publisher/developer has listed on the Microsoft Store, cursor-paginated. publisher_name must match the publisher name exactly as shown on a listing (e.g. the publisher field returned by /microsoftstore/product or /microsoftstore/search).
Required: publisher_name. Optional: cursor, country, locale.
Sampled 14 Oct 2026: 1 item. Filled in every item: product_id, title, description, publisher, categories, media_type, kind, average_rating and 9 more. In the sample: release_date_utc: 2017-10-24; title: “Spotify - Music and Podcasts”; icon_url: store-images.s-microsoft.com; free: true in 1 of 1; description: median 1,690 characters; categories: median 1 entry; publisher: “Spotify AB”; media_type: “Apps”.
Open in Playground
GET/microsoftstore/recommendedapiKey1 credit/request
Returns the store's default, query-less "Recommended for you" shelf -- the same recommendations the search box shows before a caller types anything. No query parameters beyond region/locale.
Optional: country, locale.
Sampled 14 Oct 2026: 15 items. Filled in every item: product_id, title, average_rating, icon_url, url. Not in every item: categories (14). In the sample: average_rating: 3.8 to 4.9, median 4.5; title: “Grounded” and 14 other values; icon_url: store-images.s-microsoft.com and 1 other host; categories: median 1 entry; url: apps.microsoft.com.
Open in Playground
GET/microsoftstore/relatedapiKey1 credit/request
Returns products related to a seed product id, paginated. product_type must match the seed product's own media type (apps -> Application, games -> Game, passes -> Passes) -- any other value is rejected upstream. Omit product_type to have it resolved automatically from product_id via one extra lightweight lookup; pass it explicitly to skip that lookup.
Required: product_id. Optional: product_type (3 allowed values: Application, Game, Passes), page, page_size, country, locale.
Sampled 14 Oct 2026: 20 items. Filled in every item: product_id, title, description, publisher, categories, media_type, kind, average_rating and 8 more. Not in every item: release_date_utc (14), is_pwa (9), award (1). In the sample: release_date_utc: 2010-10-18 to 2024-09-07; average_rating: 3.1 to 4.9, median 4.4; title: “Discord” and 19 other values; icon_url: images-eds-ssl.xboxlive.com and 1 other host; free: true in 20 of 20; description: median 455 characters; categories: median 1 entry; publisher: “Discord, Inc.” and 18 other values.
Open in Playground
GET/microsoftstore/reviewsapiKey2 credits/request
Returns one page of written Microsoft Store reviews for a product id, each with rating, title, text, submission time, helpful-vote counts, and device/OS info. sort controls ordering (MostHelpful or MostRecent -- the only two values the upstream API itself accepts; any other value is rejected).
Required: product_id. Optional: sort (2 allowed values: MostHelpful, MostRecent), page, page_size, country, locale.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, reviewer_name, rating, title, text, market, locale, submitted_at_utc and 5 more. Not in every item: is_revised (6). In the sample: submitted_at_utc: 2026-04-30 to 2026-09-25; rating: 1 to 4, median 1; url: ratingsedge.rnr.microsoft.com; is_revised: true in 6 of 6; helpful_positive: 4 to 181, median 21; helpful_negative: 0 to 108, median 7.
Open in Playground
GET/microsoftstore/reviews/summaryapiKey1 credit/request
Returns a product's aggregate rating: average rating, total review count, a 1-5 star rating distribution, and the upstream-selected most critical and most favorable written reviews.
Required: product_id. Optional: country, locale.
Sampled 14 Oct 2026: 30 fields returned with a value. In the sample: most_critical_review.submitted_at_utc: 2026-07-12; average_rating: 4.3; most_favorable_review.is_revised: true; most_critical_review.text: 992 characters; review_count: 299; most_critical_review.rating: 1; most_critical_review.helpful_positive: 93; most_critical_review.helpful_negative: 45.
Open in Playground
GET/microsoftstore/searchapiKey1 credit/request
Returns a page of Microsoft Store search results (apps, games, devices, and other listings) for a keyword, with cursor-based pagination and per-item publisher, rating, price, and media. media_type selects the department (apps, games, devices, passes, fonts, themes, tencent-android, tencent-mini, or all); category further filters within that department (the accepted set depends on media_type -- see the markdown doc for the full per-department lists). Pass the previous response's next_cursor to fetch the next page.
Required: query. Optional: media_type (9 allowed values: all, apps, games, devices, passes, fonts, themes, tencent-android, tencent-mini), category, price (4 allowed values: all, Free, Paid, Sale), age (16 allowed values: all, TO3, TO4, TO5, TO6, TO7, TO8, TO9, TO10, TO11, TO12, TO13, TO14, TO15, TO16, TO17), cursor, country, locale.
Sampled 14 Oct 2026: 20 items. Filled in every item: product_id, title, description, publisher, categories, media_type, kind, average_rating and 8 more. Not in every item: release_date_utc (19). In the sample: release_date_utc: 2011-02-23 to 2026-03-27; average_rating: 3.1 to 4.7, median 4.4; title: “Spotify - Music and Podcasts” and 19 other values; icon_url: store-images.s-microsoft.com and 1 other host; free: true in 20 of 20; description: median 1,209 characters; categories: median 1 entry; publisher: “Spotify AB” and 18 other values.
Open in Playground
GET/microsoftstore/spotlightapiKey1 credit/request
Returns the curated hero/spotlight shelf shown at the top of the store's home page or one department's landing page (the large featured banners, not the ranked charts or the smaller "Special events" shelf). Only home, apps, and games have a spotlight; any other media_type is rejected.
Optional: media_type (3 allowed values: home, apps, games), country, locale.
Sampled 14 Oct 2026: 8 items. Filled in every item: product_id, title, description, kind, price, free, url. Not in every item: media_type (7), display_price (7), release_date_utc (6), is_application (3), is_game (3), is_subscription (1). In the sample: release_date_utc: 2017-02-01 to 9999-12-31; media_type: Apps (3), Games (3), Passes (1); price: 0 to 99.99, median 0; title: “Spotify - Music and Podcasts” and 7 other values; url: apps.microsoft.com; free: true in 6 of 8; description: “Download now” and 6 other values; kind: app (3), game (3), collection (1) and 1 more.
Open in Playground
GET/microsoftstore/suggestapiKey1 credit/request
Returns typeahead-style Microsoft Store search suggestions for a partial search term: plain-text completions plus a short list of matching products (id, title, icon, department, and store URL).
Required: prefix. Optional: country, locale.
Sampled 14 Oct 2026: 5 items. Filled in every item: product_id, title, icon_url, media_type, url. Not in every item: is_game (2), is_application (2). In the sample: media_type: games (2), apps (2), themes (1); title: “Spot The Differences! Party” and 4 other values; icon_url: store-images.s-microsoft.com; is_game: true in 2 of 2; url: xbox.com and 1 other host; is_application: true in 2 of 2.
Open in Playground