---
title: "Get trending content"
method: GET
path: "/v1/recommendations/trending"
tags: ["Feed"]
---

# Get trending content

`GET /v1/recommendations/trending`

## Request

- Base URL: `https://blazefeed.clipro.tv`
- URL: `https://blazefeed.clipro.tv/v1/recommendations/trending`
- Auth: none declared

Retrieves the content that is currently trending for a single content type, ordered from the highest trending score to the lowest, up to 100 items. Trending scores are not exposed and no field marks an item as trending: the response order carries the ranking. Returns an empty result when trending is not enabled for the app and content type, or when there is no trending content.

## Query parameters

- `ApiKey` string, required
- `ContentType` 'Story' | 'Moment', required
- `Geo` string

## Response `200`

OK

- RecommendationsResponseDTO
  - `lastUpdated` string, date-time, nullable: When the newest item in the trending set was created. Null when recommendations is empty.
  - `recommendations` StoryDTO[], nullable: The trending content, matching the requested content type. Up to 100 items. For Moment requests each item is a Moment object.
    - `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

## Other responses

- `400`: Missing or unsupported ContentType, or an invalid Geo country code

## Changes

- **2026-11-03** `0e0d8b514e69`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wsc-sports/apis/blaze-feed-api/changes/v1/recommendations/trending/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)