YouTube

List a channel's Shorts

Retrieve a page of channel Shorts with views, descriptions, engagement, publication dates, genre and duration. Sort by newest, popular or oldest and filter by publication time. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/youtube/channel/shorts

Request

  • Base URL: https://api.scrapeatlas.com
  • URL: https://api.scrapeatlas.com/v1/youtube/channel/shorts
  • Auth: API key in header x-api-key

Query parameters

channelIdstring

YouTube channel ID (UC…) of the channel; exactly one of channelId, handle or url identifies the channel on the first page.

handlestring

Channel handle with or without @.

urlstring

Channel URL (youtube.com/@handle, /channel/UC…, /user/name, /c/name or a legacy youtube.com/name link).

continuationTokenstring

YouTube's own continuation token for the next page, or null at the end. Pass it back unchanged as continuationToken; tokens are caller-carried and never stored.

sort'newest' | 'popular' | 'oldest'

newest (default), popular or oldest. Popular and oldest read the tab's sort chip continuation (one extra upstream request); repeat sort with continuationToken.

extrasDetail'full' | 'player'

full (default) reads the player and the watch-next data per Short; player reads only the player (one call per Short, about half the upstream bytes) and leaves commentCountText and commentCountInt null (description is then the player's raw text), with the coverage warning watch_next_omitted.

number
OR
string

Earliest publication time to include, ISO 8601 or Unix seconds.

number
OR
string

Publication time to stop before, ISO 8601 or Unix seconds; later than since.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.