Channel Videos

Path Parameters

string

required

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

Query Parameters

string

default:"newest"

Sort order for the channel’s videos.

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

string

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

Response

string

The channel id the items belong to.

array

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

Show SearchResult object

string

Result type, e.g. video or short.

string

Video id (nullable).

string

Video title (nullable).

string

Full watch URL (nullable).

string

Best thumbnail URL (nullable).

string

Human-readable duration (nullable).

integer

Duration in seconds (nullable).

integer

View count (nullable).

string

View count as displayed (nullable).

string

Relative publish time (nullable).

array

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

boolean

Whether the video is live (nullable).

boolean

Whether the item is a Short (nullable).

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