YouTube Shorts API
Pricing
from $0.01 / 1,000 shorts
Extract YouTube Shorts from any channel's Shorts tab or direct Short links: views, likes, comments, publish time, duration, hashtags and full channel stats. Sort newest, popular or oldest, filter by date, pay per Short. No browser, no quota.
Title
title
Optional
Title of the Short.
Translated title
translatedTitle
Optional
Reserved for a translated title; null in this version.
Translated description
translatedText
Optional
Reserved for a translated description; null in this version.
Type
type
Optional
Content type, always shorts for a Short row.
Video id
id
Optional
YouTube video id of the Short.
URL
url
Optional
Canonical Short URL.
Thumbnail
thumbnailUrl
Optional
Largest available thumbnail image.
Views
viewCount
Optional
Exact view count at fetch time.
Published
date
Optional
Publish timestamp in ISO 8601 UTC. Day precision (YYYY-MM-DD) only in the rare case YouTube withholds the exact time.
Likes
likes
Optional
Exact like count at fetch time.
Location
location
Optional
Location attached to the Short when the creator set one; usually null.
Channel name
channelName
Optional
Display name of the channel that published the Short.
Channel URL
channelUrl
Optional
Canonical channel URL (channel id form).
Channel id
channelId
Optional
YouTube channel id (UC...).
Collaborators
collaborators
Optional
Collaborating channels on the Short; empty when none.
Channel handle
channelUsername
Optional
Channel handle without the @ sign.
Channel description
channelDescription
Optional
The channel's About text.
Channel joined
channelJoinedDate
Optional
Date the channel was created, as YouTube shows it.
Channel links
channelDescriptionLinks
Optional
Links from the channel's About section as {text, url} objects.
Channel location
channelLocation
Optional
Country the channel lists in its About section.
Channel avatar
channelAvatarUrl
Optional
Channel profile image URL.
Channel banner
channelBannerUrl
Optional
Channel banner image URL.
Channel videos
channelTotalVideos
Optional
Total videos on the channel.
Channel views
channelTotalViews
Optional
Total views across the channel.
Subscribers
numberOfSubscribers
Optional
Subscriber count. Exact below 1,000, otherwise parsed from YouTube's rounded figure (15.1M = 15100000).
Channel verified
isChannelVerified
Optional
Whether the channel shows the verified badge.
Input channel URL
inputChannelUrl
Optional
Normalized URL of the channel that was requested.
Age restricted
isAgeRestricted
Optional
Whether YouTube marks the Short as age-restricted.
Channel info
aboutChannelInfo
Optional
All channel fields repeated in one object for convenience.
Duration
duration
Optional
Length as HH:MM:SS.
Description
text
Optional
Full description text of the Short.
Description links
descriptionLinks
Optional
URLs found in the description as {url, text} objects.
Subtitles
subtitles
Optional
Reserved; null in this version. Use the YouTube Transcripts API for captions.
Order
order
Optional
Zero-based position of the Short in the returned list for its channel.
Comments off
commentsTurnedOff
Optional
True when the creator disabled comments on the Short.
Source URL
fromYTUrl
Optional
The YouTube page the Short was read from: the channel's Shorts tab, or the Short link itself for direct links.
Monetized
isMonetized
Optional
Reserved; YouTube does not expose monetization publicly, so this is null.
Members only
isMembersOnly
Optional
True when the Short is restricted to channel members.
Input
input
Optional
The exact input value (channel or link) that produced this row.
List page
fromChannelListPage
Optional
shorts when the row came from a channel's Shorts tab; null for direct links.
Error code
error
Optional
Present only on error rows: CHANNEL_DOES_NOT_EXIST, CHANNEL_HAS_NO_SHORTS, DATE_FILTER_TOO_STRICT, VIDEO_UNAVAILABLE, AGE_RESTRICTED, INVALID_INPUT, NO_RESULTS, YOUTUBE_BLOCKED, or INPUT_TRUNCATED. Error rows are never charged.
Error note
note
Optional
Human-readable explanation on error rows.
Comments
commentsCount
Optional
Comment count. Exact below 1,000, otherwise parsed from YouTube's rounded figure (11K = 11000). Null when comments are turned off.