---
title: "Get stories"
method: GET
path: "/v1/stories"
tags: ["Feed"]
---

# Get stories

`GET /v1/stories`

Retrieves a paginated list of stories based on various filter criteria

## Query parameters

- `ApiKey` string, required
- `Title` string
- `LabelsFilterExpression` string
- `Statuses` ContentStatus[]
- `Geo` string
- `OnlyLive` boolean
- `UpdateTime.From` string
- `UpdateTime.To` string
- `CreateTime.From` string
- `CreateTime.To` string
- `Entities.Game.WscId` integer
- `Entities.Game.ServiceProviderId` string
- `Entities.Team.WscId` integer
- `Entities.Team.ServiceProviderId` string
- `Entities.Player.WscId` integer
- `Entities.Player.ServiceProviderId` string
- `Entities.Round.WscId` integer
- `Entities.Round.ServiceProviderId` string
- `Entities.Season.WscId` integer
- `Entities.Season.ServiceProviderId` string
- `Entities.IdType` 'WscId' | 'ServiceProviderId'
- `PageNum` integer
- `PageSize` integer

## Response `200`

OK

- StoryDTOPaginationSearchResponse
  - `totalItems` integer
  - `result` StoryDTO[], nullable
    - `id` string, nullable
    - `type` 'Story' | 'Moment' | 'Video'
    - `title` string, nullable
    - `description` string, nullable
    - `version` integer
    - `aspectRatios` AssetVideoAspectRatio[], nullable
    - `status` 'Draft' | 'Active'
    - `isLive` boolean
    - `createTime` string, date-time
    - `updateTime` string, date-time
    - `thumbnails` ThumbnailDTO[], nullable
      - `url` string, nullable
      - `aspectRatio` 'Square' | 'Horizontal' | 'Vertical' | 'Unknown' | 'FourToFive' | 'FiveToFour' | 'ThreeToFour' | 'FourToThree' | 'TwoToOne' | 'OneToTwo' | 'SevenToEight' | 'EightToSeven' | 'TwoToThree' | 'ThreeToOne' | 'ThreeToTwo' | 'OneToThree' | 'ThreeToEight' | 'FiveToOne'
    - `geoTargeting` GeoTargeting
      - `includedGeos` string[], nullable
      - `excludedGeos` string[], nullable
    - `metadata` ContentMetadata
      - `competition` MetadataEntityIds
        - `provider` string, nullable
        - `providerId` string, nullable
        - `wscId` integer
      - `competitions` MetadataEntityIds[], nullable
        - `provider` string, nullable
        - `providerId` string, nullable
        - `wscId` integer
      - `game` MetadataEntityIds
        - `provider` string, nullable
        - `providerId` string, nullable
        - `wscId` integer
      - `team` MetadataEntityIds
        - `provider` string, nullable
        - `providerId` string, nullable
        - `wscId` integer
      - `player` MetadataEntityIds
        - `provider` string, nullable
        - `providerId` string, nullable
        - `wscId` integer
      - `round` MetadataEntityIds
        - `provider` string, nullable
        - `providerId` string, nullable
        - `wscId` integer
      - `season` MetadataEntityIds
        - `provider` string, nullable
        - `providerId` string, nullable
        - `wscId` integer
    - `executionTimeType` 'None' | 'PreGame' | 'InGame' | 'PostGame'
    - `htmlUrl` string, nullable
    - `pages` PageDTO[], nullable
      - `id` string, nullable
      - `index` integer
      - `duration` string, nullable
      - `thumbnails` ThumbnailDTO[], nullable
        - `url` string, nullable
        - `aspectRatio` 'Square' | 'Horizontal' | 'Vertical' | 'Unknown' | 'FourToFive' | 'FiveToFour' | 'ThreeToFour' | 'FourToThree' | 'TwoToOne' | 'OneToTwo' | 'SevenToEight' | 'EightToSeven' | 'TwoToThree' | 'ThreeToOne' | 'ThreeToTwo' | 'OneToThree' | 'ThreeToEight' | 'FiveToOne'
      - `createTime` string, date-time
      - `updateTime` string, date-time
      - `metadata` ContentMetadata
        - `competition` MetadataEntityIds
          - `provider` string, nullable
          - `providerId` string, nullable
          - `wscId` integer
        - `competitions` MetadataEntityIds[], nullable
          - `provider` string, nullable
          - `providerId` string, nullable
          - `wscId` integer
        - `game` MetadataEntityIds
          - `provider` string, nullable
          - `providerId` string, nullable
          - `wscId` integer
        - `team` MetadataEntityIds
          - `provider` string, nullable
          - `providerId` string, nullable
          - `wscId` integer
        - `player` MetadataEntityIds
          - `provider` string, nullable
          - `providerId` string, nullable
          - `wscId` integer
        - `round` MetadataEntityIds
          - `provider` string, nullable
          - `providerId` string, nullable
          - `wscId` integer
        - `season` MetadataEntityIds
          - `provider` string, nullable
          - `providerId` string, nullable
          - `wscId` integer
      - `extraInfo` object, nullable
    - `labels` LabelDTO[], nullable
      - `title` string, nullable
      - `identifier` string, nullable
    - `extraInfo` object, nullable

---

[API](https://skmtc.net/wsc-sports/apis/blaze-feed-api.md) · [All operations](https://skmtc.net/wsc-sports/apis/blaze-feed-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wsc-sports/blaze-feed-api/versions/042ee8ecc444/schema)