Skip to main content

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.
ValueDescription
newestMost recent first (default)
oldestOldest first
popularMost 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).
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:
EndpointReturns
GET /v1/youtube/channels/{channel_id}/shortsThe channel’s Shorts
GET /v1/youtube/channels/{channel_id}/streamsThe channel’s live streams
GET /v1/youtube/channels/{channel_id}/playlistsThe channel’s playlists
GET /v1/youtube/channels/{channel_id}/communityThe 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.