display-score-api.md
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
- All endpoints require admin authorization.
- The
displayScorefield is already included in the list DTOs (AdminListLiveVideoDto,AdminListVideoDto,AdminListChannelDto,ListAdminContentDto). - To "unboost" an item, set its
displayScoreto0.