List YouTube channel videos
Lists videos for a YouTube channel. Pass `channelId` or `handle` to identify the channel. Optional query `sortBy` controls ordering, `cursor` continues from `data.page.nextCursor`, and `includeExtras=true` may add richer per-video metadata when available. An empty `data.videos` array can still accompany `data.lookupStatus: "found"` when the channel resolves but no videos are returned for the current page.
Operation
/v1/youtube/channels/videosHeaders
API key (`sfk_...`)
Parameters
Optional YouTube channel id for the request.
min 1 chars · max 4096 chars
Optional YouTube channel handle for the request.
Optional sort order for the returned YouTube videos.
one of: latest, popular
Opaque pagination cursor returned by a previous response.
min 1 chars
Optional flag to include richer per-video metadata when available.
Response fields
Endpoint-specific response payload.
Whether the channel was resolved for this request.
one of: found, not_found
YouTube videos returned for the resolved channel. This array may be empty when the channel resolves but there are no videos in the returned page.
YouTube video identifier.
min 1 chars
Canonical public YouTube URL for the video.
Title shown for the YouTube video.
Best available thumbnail image URL for the video.
View count for the video when available.
≥ 0
Human-readable view count label when available.
ISO-8601 timestamp for when the video was published, when available.
Human-readable relative publish time text when available.
Duration of the video in seconds when available.
≥ 0
Human-readable duration label for the video when available.
Channel title shown alongside the video when available.
Channel thumbnail image URL shown alongside the video when available.
Video description text when available.
Comment count for the video when available.
≥ 0
Human-readable comment count label when available.
Like count for the video when available.
≥ 0
Human-readable like count label when available.
Publish date text when available.
Video category or genre label when available.
Duration of the video in milliseconds when available.
≥ 0
Alternative formatted duration label when available.
Pagination information for the current response.
Cursor to pass in the next request when another page exists.
Whether another page of videos is available.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
YouTube videos for the requested channel. Check `data.lookupStatus` for `found` vs `not_found`.
Error codes
Channel
Looks up a YouTube channel by `channelId`, `handle`, or full `url`.
Channel shorts
Lists Shorts for a YouTube channel. Pass `channelId` or `handle` to identify the channel. Optional query `sortBy` controls ordering, and `cursor` continues from `data.page.nextCursor`. An empty `data.shorts` array can still accompany `data.lookupStatus: "found"` when the channel resolves but no Shorts are returned for the current page.