md-platform

display-score-api.md
View raw Back to list

Display Score / Boosted API

Overview

Display score controls the boost/promotion order of videos, channels, and content (movies/series). Items with a display score greater than 0 are considered "boosted" and can be filtered and sorted by score.


Update Display Score

Updates the display score for a single entity.

Video

PUT /admin/v1/videos/{id}/display-score

Channel

PUT /admin/v1/channels/{id}/display-score

Content (Movies / Series)

PUT /admin/v1/contents/{id}/display-score

Request Body

{
  "displayScore": 10
}
Field Type Description
displayScore int The boost priority. 0 = not boosted. Higher values = higher priority.

Response

true

List Boosted Items

Use the existing admin list endpoints with the boosted query parameter to filter and sort by display score.

Videos

GET /admin/v1/videos?page=1&pageSize=20&boosted=true

Live Videos

GET /admin/v1/videos/live?page=1&pageSize=20&boosted=true

Channels

GET /admin/v1/channels?page=1&pageSize=20&boosted=true

Content (Movies / Series)

GET /admin/v1/contents?page=1&pageSize=20&type={type}&boosted=true

Behavior

boosted value Filter Sort
true Only items with displayScore > 0 By displayScore descending
false or omitted All items By createdAt descending (default)

Notes