# Video List

List video information. Use this skill to list video information.

## Usage

```bash
yutu video list [flags]
```

## Flags

| Flag | Shorthand | Required | Description |
|------|-----------|----------|-------------|
| `--chart` | `-c` |  | chartUnspecified\|mostPopular |
| `--hl` | `-l` |  | Specifies the localization language |
| `--ids` | `-i` |  | Return videos with the given ids |
| `--jsonpath` | `-j` |  | JSONPath expression to filter the output |
| `--locale` | `-L` |  | Locale of the video metadata to return |
| `--maxHeight` | `-H` |  | Max height of the embedded player in pixels |
| `--maxResults` | `-n` |  | The maximum number of items that should be returned, 0 for no limit (default 5) |
| `--maxWidth` | `-W` |  | Max width of the embedded player in pixels |
| `--myRating` | `-R` |  | Return videos liked/disliked by the authenticated user |
| `--onBehalfOfContentOwner` | `-b` |  | ID of the content owner, for YouTube content partners |
| `--output` | `-o` |  | json\|yaml\|table (default "table") |
| `--parts` | `-p` |  | Comma separated parts (default [id,snippet,status,statistics]) |
| `--regionCode` | `-r` |  | Specific to the specified region |
| `--videoCategoryId` | `-g` |  | Category of the video |

## Examples

```bash
# List a video by ID
yutu video list --ids IBju0NwjQRc
# List multiple videos in JSON format
yutu video list --ids IBju0NwjQRc,wZ9z3FUuNvQ --output json
# List most popular videos by region
yutu video list --chart mostPopular --regionCode US --maxResults 10
# List my liked videos
yutu video list --myRating like --output yaml
```