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

# Get stories by IDs

`GET /v1/stories/ids`

## Request

- Base URL: `https://blazefeed.clipro.tv`
- URL: `https://blazefeed.clipro.tv/v1/stories/ids`
- Auth: none declared

Retrieves stories by their content IDs

## Query parameters

- `ApiKey` string, required
- `ContentIds` string[], required
- `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` number, double, nullable: Length in seconds.
      - `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

## Changes

- **2026-11-03** `0e0d8b514e69`: 1 breaking
  - the `result/items/pages/items/duration` response's property type changed from `string` to `number`, and format from no format to `double` for status `200`

[Operation history](https://skmtc.dev/wsc-sports/apis/blaze-feed-api/changes/v1/stories/ids/get.md)

---

[API](https://skmtc.dev/wsc-sports/apis/blaze-feed-api.md) - [All operations](https://skmtc.dev/wsc-sports/apis/blaze-feed-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wsc-sports/apis/blaze-feed-api/revisions/0e0d8b514e69?raw)