List YouTube 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.
Operation
/v1/youtube/channels/shortsHeaders
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 Shorts.
one of: latest, popular
Opaque pagination cursor returned by a previous response.
min 1 chars
Response fields
Endpoint-specific response payload.
Whether the channel was resolved for this request.
one of: found, not_found
YouTube Shorts returned for the resolved channel. This array may be empty when the channel resolves but there are no Shorts in the returned page.
YouTube Short identifier.
min 1 chars
Canonical public YouTube URL for the Short.
Title shown for the Short.
Short description text when available.
View count for the Short when available.
≥ 0
Human-readable view count label when available.
Comment count for the Short when available.
≥ 0
Human-readable comment count label when available.
Like count for the Short when available.
≥ 0
Human-readable like count label when available.
Publication timestamp label when available.
Category or genre label when available.
Duration of the Short in milliseconds when available.
≥ 0
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 Shorts 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 Shorts for the requested channel. Check `data.lookupStatus` for `found` vs `not_found`.
Error codes
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.
Video
Returns public metadata for a single YouTube video. This endpoint also supports YouTube Shorts URLs.