Get YouTube video
Returns public metadata for a single YouTube video. This endpoint also supports YouTube Shorts URLs.
Operation
/v1/youtube/videosHeaders
API key (`sfk_...`)
Parameters
Link to the YouTube video. Shorts URLs are also supported.
min 1 chars · max 4096 chars
Optional preferred language for returned text when the source supports localization.
min 2 chars · max 16 chars
Response fields
Endpoint-specific response payload.
Whether the video was resolved for this request.
one of: found, not_found
Video details when found.
YouTube video identifier.
min 1 chars
Canonical public YouTube URL.
min 1 chars
Video title.
Video description text when available.
URLs extracted from the description when available.
min 1 chars
Best available thumbnail image URL.
min 1 chars
Publish timestamp when available.
Human-readable publish date label when available.
Video duration in milliseconds when available.
≥ 0
Human-readable duration label when available.
Category or genre label when available.
Keyword tags associated with the video when available.
min 1 chars
Whether the video is marked as paid promotion.
Uploader channel when found.
Social platform for this channel.
one of: youtube
YouTube channel handle without a leading @.
min 1 chars
Public display name for the YouTube channel.
Canonical public YouTube channel URL.
min 1 chars
YouTube channel id when available.
Engagement metrics when found.
View count when available.
≥ 0
Like count when available.
≥ 0
Comment count when available.
≥ 0
Chapter markers when available.
Chapter title.
Human-readable chapter start time when available.
Chapter start offset in seconds.
≥ 0
Caption and subtitle tracks when available.
Caption track label.
BCP-47 style language code when available.
Caption kind when available.
Whether the track can be translated in the player.
Related videos suggested after playback when available.
Related video id.
min 1 chars
Canonical watch URL when available.
Related video title.
Thumbnail image URL when available.
Resolved publish timestamp when available.
Human-readable relative publish time when available.
View count when available.
≥ 0
Human-readable view count when available.
Duration in seconds when available.
≥ 0
Human-readable duration label when available.
Uploader channel summary when available.
Related video channel title when available.
Related video channel handle when available.
Related video channel URL when available.
Related video channel id when 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 video metadata. Check `data.lookupStatus` for `found` vs `not_found`.
Error codes
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.
Video transcript
Returns structured captions for a YouTube video when available. Pass `url` as a standard watch link (or equivalent). Optional `language` requests a preferred caption language when multiple tracks exist.