List a YouTube Channel's Shorts Feed

GET/v1/youtube/channel/shorts

Returns paginated vertical Shorts uploaded by a YouTube channel, sorted by newest or popular. Cost: 1 Credit per Short returned (minimum 10 Credits per non-empty call).

Query Parameters

handlestring
YouTube channel handle (e.g. @MrBeast). Provide handle or channel_id.
channel_idstring
sort_bystring
limitinteger
cursorstring

Example Request (cURL / Python / JavaScript)

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

Response Fields

Successful channel Shorts feed

Field	Type	Sample / Notes
`code`	integer
`provider`	string
`status`	string
`msg`	string
`data`	object
`channel`	ChannelData
`channelId`	string	YouTube channel ID (`UC...`).
`handle`	stringnull	Lowercase channel handle without `@`.
`title`	string	Channel title.
`description`	string	Full channel about description.
`subscriberCount`	integer	Parsed integer subscriber count.
`subscriberText`	string	Formatted subscriber count string (e.g. `345M subscribers`).
`videosCount`	integer	Total public videos count.
`viewCount`	integer	Total channel lifetime views.
`country`	stringnull	Channel country code.
`joinedDate`	stringnull	Channel creation date.
`avatarUrl`	stringnull	Channel avatar image URL.
`bannerUrl`	stringnull	Channel banner image URL.
`isVerified`	boolean	Whether the channel has a verification badge.
`keywords`	array of string
`links`	array of object
`url`	string	Canonical YouTube channel URL.
`feedType`	string	Example: shorts
`sortBy`	string
`nextCursor`	stringnull
`continuation`	stringnull
`hasMore`	boolean
`items`	array of VideoData
`kind`	"video" \| "short" \| "live"
`videoId`	string	11-character YouTube video ID.
`videoType`	"video" \| "short" \| "live"
`url`	string	Canonical YouTube video or Shorts URL.
`title`	string	Video title.
`description`	string	Full video description including timestamps and links.
`channelId`	string	Channel ID (`UC...`).
`channelTitle`	string	Channel display name.
`channelHandle`	stringnull	Channel handle without `@` (e.g. `mrbeast`).
`lengthSeconds`	integer	Video duration in seconds.
`viewCount`	integer	Total view count.
`likeCount`	integer	Total like count.
`commentCount`	integer	Total comment count.
`publishDate`	stringnull	ISO 8601 publish timestamp.
`publishedText`	stringnull	Relative or formatted publish date text.
`category`	stringnull	YouTube video category.
`isLiveContent`	boolean
`isShort`	boolean
`isFamilySafe`	boolean
`thumbnailUrl`	stringnull	High-resolution thumbnail URL.
`keywords`	array of string
`hasTranscript`	boolean	True if captions/transcripts are available.
`meta`	ResponseMeta
`request_id`	string	Unique UUID for tracing and support.
`endpoint`	string	Canonical endpoint path.
`cached`	boolean	True if served from L1 Redis or L2 PostgreSQL 16 asset sink.
`source`	string	Data source tier (`redis`, `pg`, `upstream_primary`, `upstream_fallback`, `oembed`).
`items_count`	integer	Number of records returned in `data`.
`credits_charged`	integer	Credits deducted for this request ($1 = 10,000 Credits).
`has_more`	boolean	Whether additional pages are available via `next_cursor`.
`next_cursor`	stringnull	Continuation cursor for the next page.
`latency_ms`	integer	End-to-end gateway latency in milliseconds.

Status Codes

200: Successful channel Shorts feed