YouTube Channel Shorts API
Page a channel's public Shorts feed — titles, view counts, likes, duration, and publish dates — without mixing in long-form uploads.
GET /v1/youtube/channels/shorts1 credit per successful request.
About this endpoint
Shorts-first creator tools need a different list than the classic uploads tab. A channel can ship vertical clips daily while long-form sits idle; if you pull the wrong feed, your view averages, posting cadence, and monetization models land on the wrong population.
`GET /v1/youtube/channels/shorts` takes `handle` or `channelId` (pass one), plus optional `sortBy` (`latest` or `popular`) and `cursor` for pagination. On a found response you get `data.shorts` rows with id, url, title, description, view/like/comment counts, publish date, genre, and duration fields, plus `data.page` (`hasMore`, `nextCursor`). Branch on `data.lookupStatus` before you treat an empty array as "zero Shorts."
Pricing is on the credit badge for this operation; bill from `meta.creditsCharged`. Long-form upload lists are `GET /v1/youtube/channels/videos`. Channel identity (subscribers, bio) is `GET /v1/youtube/channel`. Platform-wide trending Shorts are a separate route. Same API key across the YouTube tag.
YouTube Channel Shorts API FAQ
How do I list YouTube Shorts for a channel via API?
Call GET /v1/youtube/channels/shorts with your Social Fetch API key (x-api-key) and either handle or channelId. Read data.lookupStatus, then data.shorts and data.page. Full parameters and examples are in the API docs.
How much does the YouTube Channel Shorts API cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.
What does each Shorts row include?
When found: id, url, title, description, viewCount (and text form), likeCount, commentCount, publishDate, genre, durationMs, and durationFormatted. Always branch on data.lookupStatus first.
How does pagination work on channel Shorts?
When data.page.hasMore is true, pass data.page.nextCursor as the cursor query param on the next request. Keep the same handle or channelId and sortBy across pages.
Can I sort channel Shorts by latest or popular?
Yes. Pass optional sortBy=latest or sortBy=popular. When you omit sortBy, the feed uses the default ordering for that request.
How is this different from GET /v1/youtube/channels/videos?
This route returns Shorts only. GET /v1/youtube/channels/videos lists long-form (and other non-Shorts) uploads. Use Shorts for vertical cadence and view samples; use videos when you need the classic uploads tab.
Does a completed request always mean Shorts were found?
No. HTTP 200 means the request finished. Check data.lookupStatus: found means you got a Shorts page (which may still be empty); not_found means the channel identifier did not resolve. Persist meta.requestId when you need to debug a miss.
Do I need a Google Cloud project for this endpoint?
No. You authenticate to Social Fetch with an API key. The route reads public channel Shorts data; it does not act on behalf of a logged-in YouTube user.