Channel Videos

Path Parameters

channel_id

string

required

The channel id (UC…), an @handle, or a custom URL slug.Examples: UCBR8-60-B28hp2BmDPdntcQ, @YouTube

Query Parameters

sort_by

string

default:"newest"

Sort order for the channel’s videos.

Value	Description
`newest`	Most recent first (default)
`oldest`	Oldest first
`popular`	Most popular first

continuation

string

Continuation token from a previous response to fetch the next page.

Response

channel_id

string

The channel id the items belong to.

items

array

Array of the channel’s videos (polymorphic SearchResult shape).

Show SearchResult object

type

string

Result type, e.g. video or short.

video_id

string

Video id (nullable).

title

string

Video title (nullable).

url

string

Full watch URL (nullable).

thumbnail

string

Best thumbnail URL (nullable).

duration

string

Human-readable duration (nullable).

length_seconds

integer

Duration in seconds (nullable).

view_count

integer

View count (nullable).

view_count_text

string

View count as displayed (nullable).

published_time_text

string

Relative publish time (nullable).

badges

array

Result badges, e.g. 4K, CC.

is_live

boolean

Whether the video is live (nullable).

is_short

boolean

Whether the item is a Short (nullable).

continuation

string

Token to fetch the next page (nullable when no more pages).

Example Response

{
  "channel_id": "UCBR8-60-B28hp2BmDPdntcQ",
  "items": [
    {
      "type": "video",
      "video_id": "abc123XYZ_0",
      "title": "What's new on YouTube",
      "url": "https://www.youtube.com/watch?v=abc123XYZ_0",
      "thumbnail": "https://i.ytimg.com/vi/abc123XYZ_0/hqdefault.jpg",
      "duration": "2:14",
      "length_seconds": 134,
      "view_count": 1820000,
      "view_count_text": "1.8M views",
      "published_time_text": "3 weeks ago",
      "is_short": false
    }
  ],
  "continuation": "4qmFsgKZARIY..."
}

Other Channel Tabs

The same paginated shape powers every channel sub-surface — swap the path segment:

Endpoint	Returns
`GET /v1/youtube/channels/{channel_id}/shorts`	The channel’s Shorts
`GET /v1/youtube/channels/{channel_id}/streams`	The channel’s live streams
`GET /v1/youtube/channels/{channel_id}/playlists`	The channel’s playlists
`GET /v1/youtube/channels/{channel_id}/community`	The channel’s community posts (`posts` array of `CommunityPost`)
`GET /v1/youtube/channels/{channel_id}/search?query=...`	Search within the channel (returns a `SearchResponse`)

Each channel-tab page costs 5 credits. Failed requests are not charged.

Overview

Search & Discovery

Videos & Shorts

Channels

Playlists & Community

Path Parameters

Query Parameters

Response

Example Response

Other Channel Tabs

​Path Parameters

​Query Parameters

​Response

​Example Response

​Other Channel Tabs

Path Parameters

Query Parameters

Response

Example Response

Other Channel Tabs