List a channel's videos
Read one page of a channel's Videos tab (30 videos) in the list shape: videos with title, URL, thumbnail, channel, view count, relative publish time with its computed timestamp, duration and badges, plus the continuation token for the next page. sort=latest (default), popular or oldest; since/until filter by publication time. includeExtras=true adds per-video description, like and comment counts, publish date, genre and duration from two public API reads per video; extrasDetail=player halves that to the player read alone. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.
Request
- Base URL: https://api.scrapeatlas.com
- URL: https://api.scrapeatlas.com/v1/youtube/channel-videos
- Auth: API key in header x-api-key
Query parameters
YouTube channel ID (UC…) of the channel; exactly one of channelId, handle or url identifies the channel on the first page.
Channel handle with or without @.
Channel URL (youtube.com/@handle, /channel/UC…, /user/name, /c/name or a legacy youtube.com/name link).
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.
latest (default), popular or oldest. Popular and oldest read the tab's sort chip continuation (one extra upstream request); repeat sort with continuationToken.
Set to true to read per-video details for every listed video (two small public API calls per video, issued together: the player metadata and the watch-next data; up to 48 videos, 12 at a time) and add description, commentCountText, commentCountInt, likeCountInt, likeCountText, publishDate (ISO 8601 with the channel's offset), genre, durationMs and durationFormatted to each video, and replace viewCountText/viewCountInt with the exact count. Defaults to false. Videos whose details could not be read keep null extras and the response is partial with extras_incomplete.
full (default) reads the player and the watch-next data per video; player reads only the player (one call per video, about half the upstream bytes) and leaves the watch-next fields commentCountText and commentCountInt null (description is then the player's raw text), with the coverage warning watch_next_omitted. Requires includeExtras=true.
Earliest publication time to include, ISO 8601 or Unix seconds.
Publication time to stop before, ISO 8601 or Unix seconds; later than since.
Response
Inspect the response status and failure or coverage fields.
Changes
No recorded changes to this operation across all 1 revision of this API.