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

Get YouTube video metadata

Retrieves metadata for a YouTube video identified by its URL or ID. Supply id in one of the supported YouTube URL formats or as a video ID. This operation is closing down and will be removed on a date not specified.

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

4 status codes
200Returns the video ID, title, description, duration, channel information, tags, thumbnail URL, available transcript languages, and available upload date, view count, and like count.
idstringrequired
YouTube video ID
titlestringrequired
Video title
descriptionstringrequired
Video description
durationnumberrequired
Video duration in seconds
channelobjectrequired
Channel information
tagsarray<string>required
Video tags
thumbnailstringoptional
URL to video thumbnail
uploadDatestringoptional
Video upload date
viewCountnumberoptional
Number of views
likeCountnumberoptional
Number of likes
transcriptLanguagesarray<string>required
Available transcript language codes
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 video 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 video 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.