Endpoint Playground

Try the Microsoft Store Charts API

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.

What a live request returned

14 Oct 2026: 20 items; 16 fields had a value in every checked item and 3 varied between items.

Observed request: GET /microsoftstore/charts?list=TopFree&page_size=20
Fields with a value in every checked item: product_id, title, description, publisher, categories, media_type, kind, average_rating

Sample value profiles: 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.

Request: GET /microsoftstore/charts
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.5%, median 1.24 s
Monitored request: GET /microsoftstore/charts?list=TopFree

Microsoft Store Charts API documentation Microsoft Store platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/microsoftstore/charts?list=TopFree&media_type=apps&discount_filter=onsale&subscription_filter=gamepass&num_players_filter=AllPlayers' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
list	string	Yes	TopFree	Chart to fetch
media_type	string	No	apps	Department to scope the chart to
category	string	No		Optional category to scope the chart to further
subcategory	string	No		Optional finer subcategory within category (apps only; requires category to also be set)
discount_filter	string	No	onsale	Optional discount filter
subscription_filter	string	No	gamepass	Optional subscription filter (games only)
num_players_filter	string	No	AllPlayers	Optional player-count filter (games only)
page	integer	No		1-based page number
page_size	integer	No		Items per page (max 24)
country	string	No		Store country/region code (ISO-2)
locale	string	No		Display locale (BCP-47)

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "list": "TopFree",
    "title": "Must-have free apps",
    "media_type": "apps",
    "page": 1,
    "page_size": 3,
    "count": 3,
    "items": [
      {
        "product_id": "9nksqgp7f2nh",
        "title": "WhatsApp",
        "publisher": "Meta Platforms, Inc.",
        "media_type": "Apps",
        "kind": "app",
        "price": 0,
        "display_price": "Free",
        "free": true,
        "url": "https://apps.microsoft.com/detail/9nksqgp7f2nh"
      }
    ],
    "source_url": "https://apps.microsoft.com/api/Reco/GetComputedProductsList?filteredCategories=AllProducts&listName=TopFree&mediaType=apps&noItems=24&pgNo=1&gl=US&hl=en-US"
  }
}

More Microsoft Store endpoints

Get the full Microsoft Store category (and subcategory) taxonomy for a department Browse a Microsoft Store category without a keyword Get a Microsoft Store editorial article by id Get a Microsoft Store department's special-events shelf Get Microsoft Store details for a single product List a Microsoft Store publisher's full catalog Get the Microsoft Store's default recommendation shelf Get products related to a Microsoft Store product Get paginated Microsoft Store reviews for a product Get a Microsoft Store product's aggregate rating summary Search the Microsoft Store Get the Microsoft Store home page or department spotlight All 14 Microsoft Store endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestmicrosoftstore.chartsResponseDocMicrosoft Store

GET /microsoftstore/charts

Get a curated Microsoft Store chart

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

list

requiredstring

Chart to fetch · allowed: TopFree, TopPaid, TopGrossing, toptrending, NewAndRising, Deal, GettingStartedApps, MostPopular

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "list": "TopFree",
    "title": "Must-have free apps",
    "media_type": "apps",
    "page": 1,
    "page_size": 3,
    "count": 3,
    "items": [
      {
        "product_id": "9nksqgp7f2nh",
        "title": "WhatsApp",
        "publisher": "Meta Platforms, Inc.",
        "media_type": "Apps",
        "kind": "app",
        "price": 0,
        "display_price": "Free",
        "free": true,
        "url": "https://apps.microsoft.com/detail/9nksqgp7f2nh"
      }
    ],
    "source_url": "https://apps.microsoft.com/api/Reco/GetComputedProductsList?filteredCategories=AllProducts&listName=TopFree&mediaType=apps&noItems=24&pgNo=1&gl=US&hl=en-US"
  }
}

Endpoint Playground

Try the Microsoft Store Charts API

What a live request returned

14 Oct 2026: 20 items; 16 fields had a value in every checked item and 3 varied between items.

Observed request: GET /microsoftstore/charts?list=TopFree&page_size=20
Fields with a value in every checked item: product_id, title, description, publisher, categories, media_type, kind, average_rating

Sample value profiles: 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.

Request: GET /microsoftstore/charts
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.5%, median 1.24 s
Monitored request: GET /microsoftstore/charts?list=TopFree

Microsoft Store Charts API documentation Microsoft Store platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/microsoftstore/charts?list=TopFree&media_type=apps&discount_filter=onsale&subscription_filter=gamepass&num_players_filter=AllPlayers' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
list	string	Yes	TopFree	Chart to fetch
media_type	string	No	apps	Department to scope the chart to
category	string	No		Optional category to scope the chart to further
subcategory	string	No		Optional finer subcategory within category (apps only; requires category to also be set)
discount_filter	string	No	onsale	Optional discount filter
subscription_filter	string	No	gamepass	Optional subscription filter (games only)
num_players_filter	string	No	AllPlayers	Optional player-count filter (games only)
page	integer	No		1-based page number
page_size	integer	No		Items per page (max 24)
country	string	No		Store country/region code (ISO-2)
locale	string	No		Display locale (BCP-47)

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "list": "TopFree",
    "title": "Must-have free apps",
    "media_type": "apps",
    "page": 1,
    "page_size": 3,
    "count": 3,
    "items": [
      {
        "product_id": "9nksqgp7f2nh",
        "title": "WhatsApp",
        "publisher": "Meta Platforms, Inc.",
        "media_type": "Apps",
        "kind": "app",
        "price": 0,
        "display_price": "Free",
        "free": true,
        "url": "https://apps.microsoft.com/detail/9nksqgp7f2nh"
      }
    ],
    "source_url": "https://apps.microsoft.com/api/Reco/GetComputedProductsList?filteredCategories=AllProducts&listName=TopFree&mediaType=apps&noItems=24&pgNo=1&gl=US&hl=en-US"
  }
}

More Microsoft Store endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestmicrosoftstore.chartsResponseDocMicrosoft Store

GET /microsoftstore/charts

Get a curated Microsoft Store chart

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

list

requiredstring

Chart to fetch · allowed: TopFree, TopPaid, TopGrossing, toptrending, NewAndRising, Deal, GettingStartedApps, MostPopular

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "list": "TopFree",
    "title": "Must-have free apps",
    "media_type": "apps",
    "page": 1,
    "page_size": 3,
    "count": 3,
    "items": [
      {
        "product_id": "9nksqgp7f2nh",
        "title": "WhatsApp",
        "publisher": "Meta Platforms, Inc.",
        "media_type": "Apps",
        "kind": "app",
        "price": 0,
        "display_price": "Free",
        "free": true,
        "url": "https://apps.microsoft.com/detail/9nksqgp7f2nh"
      }
    ],
    "source_url": "https://apps.microsoft.com/api/Reco/GetComputedProductsList?filteredCategories=AllProducts&listName=TopFree&mediaType=apps&noItems=24&pgNo=1&gl=US&hl=en-US"
  }
}