YouTube Channel Shorts API reference

Can pass channelId or handle. Provide at least one of: channelId, handle.

YouTube channel handle without the @ symbol. Provide at least one of: channelId, handle.

Only shorts published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Older shorts are left off the page, and the page that reaches one ends the walk: next_cursor is not returned and pagination.stopped_at is since. Pinned shorts sit out of date order and never end the walk. The page still costs what a page costs, so a daily poll pays for the pages it walks and no more.

The id (post.id) or URL (post.url) of the newest short you already hold. The page stops just before it: that short and everything after it are left off, next_cursor is not returned, and pagination.stopped_at is known_id. A pinned short never counts as the stop point. If it is not on this page the page is returned in full with its cursor, so keep walking. pagination.stopped_at is end when the list ran out first and null while there is more to walk.

Sort by newest (descending publish date) or popular (descending view count). Both orderings are genuinely applied, unlike /v1/youtube/search's popular, which is a popularity-weighted ranking rather than a view sort.

Set to channel (one token only) to add the channel's subscriber count to every row (post.ext.author_followers, YouTube's own figure, rounded to three significant figures above 1,000) plus post.author.display_name, .avatar_url and author.id where missing. Adds well under a second (never more than 8).

The pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.