---
title: "Get one page of a curated Xbox collection"
method: GET
path: "/xbox/collection"
tags: ["Xbox"]
---

# Get one page of a curated Xbox collection

`GET /xbox/collection`

## Request

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

Returns one page of a named, editorially curated Xbox collection (e.g. Top Free Games, Top Paid Games, Optimized for Series X|S, Xbox Play Anywhere). Pages forward via an opaque cursor: pass the previous response's next_cursor to fetch the next page. This is a partial, non-exhaustive list of known collection ids -- there is no discovery endpoint for the full set.

## Query parameters

- `id` 'TopFreeGames' | 'TopPaidGames' | 'OptimizedSeriesXS' | 'XboxPlayAnywhere', required
- `cursor` string
- `locale` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- XboxCollectionResponseDoc
  - `code` integer
  - `data` XboxCollectionResponse
    - `has_more` boolean
    - `id` string
    - `items` XboxGameSummary[]
      - `available_on` string[]
      - `average_rating` number
      - `box_art_url` string
      - `categories` string[]
      - `content_rating` XboxContentRating
        - `age` integer
        - `board` string
        - `description` string
        - `descriptors` string[]
        - `image_url` string
        - `rating` string
      - `hero_art_url` string
      - `is_preorder` boolean
      - `poster_url` string
      - `price` XboxPrice
        - `currency` string
        - `discount_percentage` number
        - `is_free` boolean
        - `list_price` number
        - `msrp` number
        - `sale_end_date_utc` string
      - `product_id` string
      - `product_kind` string
      - `publisher` string
      - `rating_count` integer
      - `release_date_utc` string
      - `title` string
      - `url` string
    - `next_cursor` string
    - `title` string
    - `total_items` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `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/0497899e2016?raw)