---
title: "Get a Microsoft Store editorial article by id"
method: GET
path: "/microsoftstore/editorial"
tags: ["Microsoft Store"]
---

# Get a Microsoft Store editorial article by id

`GET /microsoftstore/editorial`

## Request

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

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.

## Query parameters

- `editorial_id` string, required
- `country` string
- `locale` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MicrosoftstoreEditorialResponseDoc
  - `code` integer
  - `data` MicrosoftstoreEditorialResponse
    - `editorial_id` string
    - `header_image` string
    - `paragraphs` string[]
    - `relevant_products` MicrosoftstoreProduct[]
      - `average_rating` number
      - `award` MicrosoftstoreAward
        - `category` string
        - `description` string
        - `editorial_id` string
        - `title` string
        - `year` integer
      - `categories` string[]
      - `description` string
      - `display_price` string
      - `free` boolean
      - `icon_url` string
      - `is_application` boolean
      - `is_game` boolean
      - `is_pwa` boolean
      - `is_subscription` boolean
      - `is_theme` boolean
      - `kind` string
      - `media_type` string
      - `poster_art_url` string
      - `price` number
      - `product_id` string
      - `publisher` string
      - `rating_count` string
      - `release_date_utc` string
      - `title` string
      - `url` string
    - `source_url` string
    - `subtitle` MicrosoftstoreEditorialSubtitle
      - `icon` string
      - `text` string
    - `title` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)