Skip to content
youtubeapi.io
All endpoints

List a YouTube Channel's Uploaded Videos Feed

GET/v1/youtube/channel/videos

Returns paginated long-form videos uploaded by a channel, sorted by newest, popular, or oldest. Cost: 1 Credit per video returned (minimum 10 Credits per non-empty call).

Query Parameters

  • handlestring

    YouTube channel handle (e.g. @googledevelopers). Provide handle or channel_id.

  • channel_idstring

    YouTube channel ID (UC_x5XG1OV2P6uZZ5FSM9Ttw).

  • sort_bystring

    Sort order: newest, popular, or oldest.

  • limitinteger

  • cursorstring

Example Request (cURL / Python / JavaScript)

curl "https://api.youtubeapi.io/v1/youtube/channel/videos" \
  -H "x-api-key: yt_live_your_api_key"

Response Fields

Successful channel videos feed

FieldTypeSample / Notes
codeinteger
providerstring
statusstring
msgstring
dataobject
channelChannelData
channelIdstringYouTube channel ID (UC...).
handlestringnullLowercase channel handle without @.
titlestringChannel title.
descriptionstringFull channel about description.
subscriberCountintegerParsed integer subscriber count.
subscriberTextstringFormatted subscriber count string (e.g. 345M subscribers).
videosCountintegerTotal public videos count.
viewCountintegerTotal channel lifetime views.
countrystringnullChannel country code.
joinedDatestringnullChannel creation date.
avatarUrlstringnullChannel avatar image URL.
bannerUrlstringnullChannel banner image URL.
isVerifiedbooleanWhether the channel has a verification badge.
keywordsarray of string
linksarray of object
urlstringCanonical YouTube channel URL.
feedTypestringExample: videos
sortBystring
nextCursorstringnull
continuationstringnull
hasMoreboolean
itemsarray of VideoData
kind"video" | "short" | "live"
videoIdstring11-character YouTube video ID.
videoType"video" | "short" | "live"
urlstringCanonical YouTube video or Shorts URL.
titlestringVideo title.
descriptionstringFull video description including timestamps and links.
channelIdstringChannel ID (UC...).
channelTitlestringChannel display name.
channelHandlestringnullChannel handle without @ (e.g. mrbeast).
lengthSecondsintegerVideo duration in seconds.
viewCountintegerTotal view count.
likeCountintegerTotal like count.
commentCountintegerTotal comment count.
publishDatestringnullISO 8601 publish timestamp.
publishedTextstringnullRelative or formatted publish date text.
categorystringnullYouTube video category.
isLiveContentboolean
isShortboolean
isFamilySafeboolean
thumbnailUrlstringnullHigh-resolution thumbnail URL.
keywordsarray of string
hasTranscriptbooleanTrue if captions/transcripts are available.
metaResponseMeta
request_idstringUnique UUID for tracing and support.
endpointstringCanonical endpoint path.
cachedbooleanTrue if served from L1 Redis or L2 PostgreSQL 16 asset sink.
sourcestringData source tier (redis, pg, upstream_primary, upstream_fallback, oembed).
items_countintegerNumber of records returned in data.
credits_chargedintegerCredits deducted for this request ($1 = 10,000 Credits).
has_morebooleanWhether additional pages are available via next_cursor.
next_cursorstringnullContinuation cursor for the next page.
latency_msintegerEnd-to-end gateway latency in milliseconds.

Status Codes

200
Successful channel videos feed