Endpoint Playground

Try the Microsoft Store Spotlight API

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.

What a live request returned

14 Oct 2026: 8 items; 7 fields had a value in every checked item and 6 varied between items.

Observed request: GET /microsoftstore/spotlight
Fields with a value in every checked item: product_id, title, description, kind, price, free, url

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

Request: GET /microsoftstore/spotlight
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.5%, median 0.70 s
Monitored request: GET /microsoftstore/spotlight

Microsoft Store Spotlight API documentation Microsoft Store platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/microsoftstore/spotlight?media_type=home' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
media_type	string	No	home	Which spotlight to fetch
country	string	No		Store country/region code (ISO-2)
locale	string	No		Display locale (BCP-47)

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "media_type": "home",
    "count": 8,
    "items": [
      {
        "product_id": "9ncbcszsjrsb",
        "title": "Spotify - Music and Podcasts",
        "media_type": "Apps",
        "kind": "app",
        "price": 0,
        "display_price": "Free",
        "free": true,
        "url": "https://apps.microsoft.com/detail/9ncbcszsjrsb"
      }
    ],
    "source_url": "https://apps.microsoft.com/api/reco/getPromotionProducts?collectionName=Home%2FSpotlight%2FHome_Spotlight_T1_T2&gl=US&hl=en-US&site=SFA"
  }
}

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 curated Microsoft Store chart 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 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.spotlightResponseDocMicrosoft Store

GET /microsoftstore/spotlight

Get the Microsoft Store home page or department spotlight

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

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": {
    "media_type": "home",
    "count": 8,
    "items": [
      {
        "product_id": "9ncbcszsjrsb",
        "title": "Spotify - Music and Podcasts",
        "media_type": "Apps",
        "kind": "app",
        "price": 0,
        "display_price": "Free",
        "free": true,
        "url": "https://apps.microsoft.com/detail/9ncbcszsjrsb"
      }
    ],
    "source_url": "https://apps.microsoft.com/api/reco/getPromotionProducts?collectionName=Home%2FSpotlight%2FHome_Spotlight_T1_T2&gl=US&hl=en-US&site=SFA"
  }
}

Endpoint Playground

Try the Microsoft Store Spotlight API

What a live request returned

14 Oct 2026: 8 items; 7 fields had a value in every checked item and 6 varied between items.

Observed request: GET /microsoftstore/spotlight
Fields with a value in every checked item: product_id, title, description, kind, price, free, url

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

Request: GET /microsoftstore/spotlight
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.5%, median 0.70 s
Monitored request: GET /microsoftstore/spotlight

Microsoft Store Spotlight API documentation Microsoft Store platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/microsoftstore/spotlight?media_type=home' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
media_type	string	No	home	Which spotlight to fetch
country	string	No		Store country/region code (ISO-2)
locale	string	No		Display locale (BCP-47)

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "media_type": "home",
    "count": 8,
    "items": [
      {
        "product_id": "9ncbcszsjrsb",
        "title": "Spotify - Music and Podcasts",
        "media_type": "Apps",
        "kind": "app",
        "price": 0,
        "display_price": "Free",
        "free": true,
        "url": "https://apps.microsoft.com/detail/9ncbcszsjrsb"
      }
    ],
    "source_url": "https://apps.microsoft.com/api/reco/getPromotionProducts?collectionName=Home%2FSpotlight%2FHome_Spotlight_T1_T2&gl=US&hl=en-US&site=SFA"
  }
}

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.spotlightResponseDocMicrosoft Store

GET /microsoftstore/spotlight

Get the Microsoft Store home page or department spotlight

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

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": {
    "media_type": "home",
    "count": 8,
    "items": [
      {
        "product_id": "9ncbcszsjrsb",
        "title": "Spotify - Music and Podcasts",
        "media_type": "Apps",
        "kind": "app",
        "price": 0,
        "display_price": "Free",
        "free": true,
        "url": "https://apps.microsoft.com/detail/9ncbcszsjrsb"
      }
    ],
    "source_url": "https://apps.microsoft.com/api/reco/getPromotionProducts?collectionName=Home%2FSpotlight%2FHome_Spotlight_T1_T2&gl=US&hl=en-US&site=SFA"
  }
}