Prospect demo — Supadata (unofficial)
GET/youtube/channel/videos

List video IDs from a YouTube channel

Lists video IDs from a YouTube channel identified by its URL, handle, or ID. Use type to select all videos, regular videos, Shorts, or live streams, and limit to set the maximum number returned.

3 parameters
idstringrequired
The YouTube channel URL, handle, or ID to list videos from; use a supported YouTube URL format.
limitnumberoptional
Maximum number of video IDs to return. Must be between 1 and 5000. Defaults to 30 when omitted. When `type` is `all`, regular videos are included before Shorts and live streams.
Default:30
typestringoptional
The video type to return: `all`, `video`, `short`, or `live`. Defaults to `all` when omitted.
Allowed:allvideoshortliveDefault:all

4 status codes
200Returns arrays of video IDs, Shorts IDs, and live video IDs for the selected channel and video type.
videoIdsarray<string>required
List of vertical video IDs
shortIdsarray<string>required
List of Shorts IDs
liveIdsarray<string>required
List of live video IDs
400Returned when the request is invalid, including when `limit` is outside 1–5000 or `type` is not an accepted value; the response includes an error code, message, and details.
errorstringrequired
Error code identifying the type of error
Allowed:invalid-requestinternal-errorforbiddenunauthorizedupgrade-requiredtranscript-unavailablenot-foundlimit-exceeded
messagestringrequired
Human readable error message
detailsstringrequired
Detailed error description
documentationUrlstringoptional
URL to error documentation
404Returned when the requested YouTube channel cannot be found; the response includes an error code, message, and details.
errorstringrequired
Error code identifying the type of error
Allowed:invalid-requestinternal-errorforbiddenunauthorizedupgrade-requiredtranscript-unavailablenot-foundlimit-exceeded
messagestringrequired
Human readable error message
detailsstringrequired
Detailed error description
documentationUrlstringoptional
URL to error documentation
500Returned when an internal error occurs; the response includes an error code, message, and details.
errorstringrequired
Error code identifying the type of error
Allowed:invalid-requestinternal-errorforbiddenunauthorizedupgrade-requiredtranscript-unavailablenot-foundlimit-exceeded
messagestringrequired
Human readable error message
detailsstringrequired
Detailed error description
documentationUrlstringoptional
URL to error documentation

Error handling

A 400 is returned when the request is invalid; limit must be between 1 and 5000, and type must be all, video, short, or live. A 404 is returned when the channel identified by the id query parameter cannot be found. A 500 is returned when an internal error occurs.