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

List video IDs from a YouTube playlist

Lists video IDs from a YouTube playlist identified by its URL or ID. Set limit to control the maximum number returned; it defaults to 100 and must be between 1 and 5000.

2 parameters
idstringrequired
The YouTube playlist URL 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 100 when omitted.
Default:100

4 status codes
200Returns arrays of video IDs, Shorts IDs, and live video IDs found in the playlist.
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 below 1 or above 5000; 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 playlist 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. A 404 is returned when the playlist identified by the id query parameter cannot be found. A 500 is returned when an internal error occurs.