# 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

```json
{
  "displayScore": 10
}
```

| Field | Type | Description |
|---|---|---|
| `displayScore` | `int` | The boost priority. `0` = not boosted. Higher values = higher priority. |

### Response

```json
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 `displayScore` field is already included in the list DTOs (`AdminListLiveVideoDto`, `AdminListVideoDto`, `AdminListChannelDto`, `ListAdminContentDto`).
- To "unboost" an item, set its `displayScore` to `0`.