> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_youtube_channel_videos

# get_youtube_channel_videos

> The latest videos of one YouTube channel with titles, dates, views and length. ₹0.20 per page; a channel with no videos is ₹0.

## What it does

The latest videos of one channel, newest first: `data.videos[]` with `video_id`, `title`, `url`, `published_time`, `view_count`, `duration` and `description`, plus `data.channel`. About thirty a page; pass `continuation_token` for the next.

It takes the channel's `UC` id, not a handle: [`get_youtube_channel`](https://parel.si/docs/tools/get_youtube_channel.md) gives you that. To find videos on a subject across channels use [`search_youtube`](https://parel.si/docs/tools/search_youtube.md).

Dates and view counts are the text YouTube shows ("8 days ago", "1.2M views"), not exact figures.

India: any public channel.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `channel_id` | string | yes | The channel's id, starting UC. get_youtube_channel gives it from a handle. |
| `continuation_token` | string | no | From the last answer, for the next page. |

## What drives the cost

Flat per page of about thirty videos. Each `continuation_token` page is a new call. A channel with no videos is `class: "ok_free"`, ₹0.

## Price today

| | |
|---|---|
| Price today | **₹0.20** per page (`cost_paise: 20`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_youtube_channel_videos"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_youtube_channel_videos"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_youtube_channel_videos","input":{"channel_id":"UCX6OQ3DkcsbYNE6H8uQQuVA"}}'
```

## What comes back

`data.channel` and `data.videos[]`. A real answer recorded during the live check of 2026-11-05, trimmed to two videos:

```json
{
  "channel": {
    "id": "UCSHZKyawb77ixDdsGog4iWA",
    "name": "Lex Fridman"
  },
  "videos": [
    {
      "video_id": "ZAzWPE9CItg",
      "title": "AI Crisis in Math: Navier-Stokes, Riemann Hypothesis & Complexity Theory | Lex Fridman Podcast #503",
      "url": "https://www.youtube.com/watch?v=ZAzWPE9CItg",
      "published_time": "8 days ago",
      "view_count": "1.2M views",
      "duration": "3:34:27",
      "description": ""
    },
    {
      "video_id": "FGCP2F_7rQk",
      "title": "Taiwan: The Most Epic Night Market Experience w/ Jensen Huang | Lex Fridman",
      "url": "https://www.youtube.com/watch?v=FGCP2F_7rQk",
      "published_time": "3 weeks ago",
      "view_count": "1.5M views",
      "duration": "1:30:18",
      "description": ""
    }
  ],
  "continuation_token": "4qmFsgLZCRIYVUNTSFpLeWF3Yjc3aXhEZHNHb2c0…"
}
```

## Notes

- Flat price per page of about thirty videos; a channel with no videos is free.
- Needs the UC channel id: get it from get_youtube_channel.
- Dates and counts are as YouTube displays them.

## Siblings

- [`get_youtube_channel`](https://parel.si/docs/tools/get_youtube_channel.md) for a channel's id and profile.
- [`search_youtube`](https://parel.si/docs/tools/search_youtube.md) to search across channels.
- [`get_youtube_transcript`](https://parel.si/docs/tools/get_youtube_transcript.md) for a video's words.
