# Channel Endpoints

Resolve handles, search inside a channel, list recent uploads, and track new ones.

Source: https://youtubetranscriptapi.com/docs/api/channel

The Channel endpoints expose four operations against a single channel: resolve a `@handle` or URL to a canonical `UC…` ID, search videos within that channel, list its most recent uploads (up to 100), and pull the latest 15 uploads via RSS. Authenticate with `Authorization: Bearer YOUR_API_KEY`. Resolve and latest are free but require ≥1 active credit; search charges 1 credit and videos charges 20 credits per successful call. 4xx, 5xx, and 429 responses never debit.

## Resolve a channel

`GET /api/v2/youtube/channel/resolve` — Free

Convert any `@handle`, full channel URL, or `UC…` ID to its canonical channel ID. Free endpoint — costs 0 credits but requires ≥1 active credit on your account.

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `input` (required) | `string` | — | @handle, channel URL, or UC… ID. 1–200 chars. |

```bash
curl -X GET "https://youtubetranscriptapi.com/api/v2/youtube/channel/resolve?input=@TED" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json
{
  "channel_id": "UCAuUUnT6oDeKwE6v1NGQxug",
  "resolved_from": "@TED"
}
```

## Search videos inside a channel

`GET /api/v2/youtube/channel/search` — 1 credit

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `channel` (required) | `string` | — | @handle, URL, or UC… ID. |
| `q` (required) | `string` | — | Search query, 1–200 chars. |
| `limit` | `integer` | `30` | Max results (1–50). |

```bash
curl -X GET "https://youtubetranscriptapi.com/api/v2/youtube/channel/search?channel=@TED&q=review&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## List channel uploads

`GET /api/v2/youtube/channel/videos` — 20 credits (first page)

Returns the channel's most recent uploads, up to 100 videos. Only the first page is served for now: `continuation_token` is always `null`, and a request with `continuation` is refused with `422 continuation_unavailable` before the credit check, so it needs no balance and is never charged. `has_more` still tells you whether the channel has more uploads. In `playlist_info`, `numVideos` and `viewCount` are always `null`.

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `channel` (required) | `string` | — | @handle, URL, or UC… ID. |
| `continuation` | `string` | — | Not served yet. Refused with 422 continuation_unavailable before the credit check: needs no balance and is never charged. |

```json
{
  "results": [
    {
      "videoId": "abc123xyz00",
      "title": "Latest Video",
      "channelId": "UCAuUUnT6oDeKwE6v1NGQxug",
      "channelTitle": "TED",
      "channelHandle": "@TED",
      "lengthText": "15:22",
      "viewCountText": "3.2M views 2 weeks ago",
      "thumbnails": [
        { "url": "https://i.ytimg.com/vi/abc123xyz00/default.jpg", "width": 120, "height": 90 },
        { "url": "https://i.ytimg.com/vi/abc123xyz00/mqdefault.jpg", "width": 320, "height": 180 },
        { "url": "https://i.ytimg.com/vi/abc123xyz00/hqdefault.jpg", "width": 480, "height": 360 }
      ],
      "index": "0"
    }
  ],
  "playlist_info": {
    "title": "Uploads from TED",
    "numVideos": null,
    "ownerName": "TED",
    "viewCount": null
  },
  "continuation_token": null,
  "has_more": true
}
```

## Track new uploads

`GET /api/v2/youtube/channel/latest` — Free

RSS-backed list of the latest 15 uploads. Free endpoint, ideal for daily-recap or new-content alert pipelines.

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `channel` (required) | `string` | — | @handle, URL, or UC… ID. |

```bash
curl -X GET "https://youtubetranscriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

`results` holds up to 15 videos, newest first. Fields that aren't available for a video are `null`, and `publishedAt` can be approximate.

```json
{
  "channel_id": "UCAuUUnT6oDeKwE6v1NGQxug",
  "channel_title": "TED",
  "results": [
    {
      "videoId": "abc123xyz00",
      "title": "Latest Video",
      "url": "https://www.youtube.com/watch?v=abc123xyz00",
      "channelId": "UCAuUUnT6oDeKwE6v1NGQxug",
      "channelTitle": "TED",
      "publishedAt": "2026-10-17T15:00:00+00:00",
      "updatedAt": "2026-10-18T09:30:00+00:00",
      "description": "Video description...",
      "thumbnail_url": "https://i.ytimg.com/vi/abc123xyz00/hqdefault.jpg",
      "viewCount": 52000
    }
  ],
  "result_count": 15
}
```