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

Get YouTube playlist metadata

Retrieves metadata for a YouTube playlist identified by its URL or ID. Supply id in one of the supported YouTube URL formats or as a playlist ID.

1 parameter
idstringrequired
The YouTube playlist URL or ID to retrieve metadata for; use a supported YouTube URL format.

4 status codes
200Returns the playlist ID, title, video count, and channel information, with the description, view count, and last-updated timestamp when available.
idstringrequired
YouTube playlist ID
titlestringrequired
Playlist title
descriptionstringoptional
Playlist description (empty string when the playlist has none)
videoCountnumberrequired
Number of videos in the playlist
viewCountnumberoptional
Number of views for the playlist
lastUpdatedstringoptional
When the playlist was last updated
channelobjectrequired
Channel information
400Returned when the request is invalid; 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. 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; use the error response's message and details to diagnose the issue.