https://videomentions.com/api/v1/video?id=${VIDEO_ID}
–or–
https://videomentions.com/api/v1/video?url=${VIDEO_URL}
This endpoint can be used for fetching data for an individual YouTube video.
id - string. (optional) Video ID. Must be included if no url parameter has been provided.url - string. (optional) A UTF-8 encoded video URL. Must be included if no id parameter has been provided.url parameterurl parameter must be UTF-8 encoded. This can be accomplished using encodeURIComponent() in the browser/Node.js, or by other means on other platforms or languages.https://www.youtube.com/watch?v=${VIDEO_ID}), the v query string parameter is used to identify the video. All other query string parameters are ignored.https://youtu.be/${VIDEO_ID}), the path is used to identify the video. All query string parameters, hash properties, etc. are ignored.id - string. Video ID.title - string. Video title.publishedAt - string. Date the video was published in YYYY-MM-DD format.description - string. Video description.thumbnails array. Video thumbnail images. url - string. Thumbnail URL.width - integer. Thumbnail width in pixels.height - integer. Thumbnail height in pixels.channelId - string. Channel ID.channelTitle - string. Channel title.hasAutomaticChapters - boolean. true if the video has automatically generated chapters, else false.chapters - array|null. Video chapters. null if the video has no chapters. timestamp - string. Human-readable chapter start time, typically in hh:mm:ss or mm:ss format.text - string. The chapter name.seconds - integer. The chapter start time in seconds.tags - string[]. A list of keyword tags associated with the video.category - string|null. The name of the category the videos is in. null if data is unavailable.duration - integer|null. The video duration in seconds. null if data is unavailable.isFamilySafe - boolean|null. true if the video is considered family safe, else false. null if data is unavailable.viewCount - integer|null. The number of views the video has received. null if data is unavailable.likeCount - integer|null. The number of likes the video has received. null if data is unavailable.commentCount - integer|null. The number of comments the video has received. null if data is unavailable.transcript - array|null. English transcript/captions. null if video has no transcript. transcription - string. The line of spoken words (“utterance”).attributes - array. Transcription line attributes. start - string. Transcription line start time in seconds.duration - string. Transcription line duration in seconds.A number of the fields this endpoint returns are nullable. In practice, the values for category, duration, isFamilySafe, viewCount, likeCount, and commentCount are almost always available in the response, but because their existence isn’t strictly guaranteed, the possibility for a null value exists.
If an invalid video ID or URL is provided, a 404 Not Found error response will be returned.
Below are example requests for getting the data for the YouTube video with an ID of ENtxJcI5Ll4 and a URL of https://www.youtube.com/watch?v=ENtxJcI5Ll4.
Approach #1: Pass in the video ID as the id parameter:
curl -X GET
-H "API-Key: your-api-key"
-H "API-Secret: your-api-secret"
https://videomentions.com/api/v1/video?id=ENtxJcI5Ll4Approach #2: Pass in the UTF-8 encoded video URL as the url parameter:
curl -X GET
-H "API-Key: your-api-key"
-H "API-Secret: your-api-secret"
https://videomentions.com/api/v1/video?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DENtxJcI5Ll4The two approaches above both yield this same result:
{
"id": "ENtxJcI5Ll4",
"title": "Apple WWDC 2023 keynote in 26 minutes",
"publishedAt": "2023-06-05",
"description": "Apple just finished up its annual Worldwide Developers Conference keynote, where it made some of the biggest announcements it’s ever made at the event, including its Vision Pro mixed reality headset and a bigger 15-inch MacBook Air. Plus, the Mac Studio and Mac Pro get an upgrade with a more powerful M2 Ultra chip. We also got a look at new updates for iOS and iPadOS, including interactive widgets. Here’s everything you missed. #Apple #WWDC #Technology\n\nRead more: https://trib.al/6fqFRDg\n\n00:00 Intro\n02:04 15" Macbook Air\n01:10 Mac Studio M2 Max M2 Ultra\n02:39 Mac Pro with Apple Silicon\n03:19 Prices\n03:30 IOS 17\n04:36 Check In\n05:04 Plus Button and Stickers\n05:38 Airdrop\n06:16 Autocorrect\n06:50 Journal App\n07:28 Standby\n08:18 Siri\n08:48 iPad OS 17\n10:30 iPad PDF collaboration\n11:01 MacOS Sonoma\n12:02 Gaming (Death Stranding)\n12:28 Video Conferencing\n13:10 Safari WebKit\n14:28 Adaptive Audio\n14:52 AirPlay in Hotels\n15:10 Shareplay to Cars\n15:25 watchOS 10\n16:08 Apple Vision Pro\n17:40 Vision Pro EyeSight\n18:31 VisionPro FaceTime\n20:40 Vision Pro Hardware\n23:46 VisionOS\n24:51 Reality Composer Pro\n25:14 Optic ID\n25:38 Vision Pro Price and release\n\nSubscribe: http://goo.gl/G5RXGs\nLike The Verge on Facebook: https://goo.gl/2P1aGc\nFollow on Twitter: https://goo.gl/XTWX61\nFollow on Instagram: https://goo.gl/7ZeLvX\nFollow on TikTok: http://bit.ly/42VeCVU\n\nThe Vergecast Podcast: https://pod.link/430333725\nDecoder with Nilay Patel: http://apple.co/3v29nDc \nMore about our podcasts: https://www.theverge.com/podcasts\n\nRead More: http://www.theverge.com\nCommunity guidelines: http://bit.ly/2D0hlAv\nWallpapers from The Verge: https://bit.ly/2xQXYJr\n\nSubscribe to The Vergecast on YouTube, new episodes on Wednesday and Friday: https://bit.ly/3I6nJtz",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/ENtxJcI5Ll4/maxresdefault.jpg",
"width": 1920,
"height": 1080
},
{
"url": "https://i.ytimg.com/vi/ENtxJcI5Ll4/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAEJH1q0vqwOSQ2Jb-P4RTBELasPw",
"width": 336,
"height": 188
},
{
"url": "https://i.ytimg.com/vi/ENtxJcI5Ll4/hqdefault.jpg?sqp=-oaymwEcCPYBEIoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLArqvmIshvhOW2lagYej4GZ0wpODQ",
"width": 246,
"height": 138
},
{
"url": "https://i.ytimg.com/vi/ENtxJcI5Ll4/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLALneJy_kIRPdLJ1aUX3SIt_gfyLQ",
"width": 196,
"height": 110
},
{
"url": "https://i.ytimg.com/vi/ENtxJcI5Ll4/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLD82TO_fdiiM1WUv4V_OMitDeDxPg",
"width": 168,
"height": 94
}
],
"channelId": "UCddiUEpeqJcYeBxX1IVBKvQ",
"channelTitle": "The Verge",
"chapters": [
{
"timestamp": "0:00:00",
"text": "Into and Course Overview",
"seconds": 0
},
{
"timestamp": "0:02:08",
"text": "Downloading Project Code",
"seconds": 128
},
{
"timestamp": "0:03:19",
"text": "Setting Up the Project",
"seconds": 199
}
// etc.
],
"tags": [
"Apple wwdc",
"apple",
"apple headset",
"apple wwdc 2023",
"wwdc",
"wwdc 2023",
"Worldwide Developer Conference",
"Worldwide Developer Conference keynote",
"wwdc highlights",
"wwdc news",
"apple new headset",
"apple reality pro",
"apple mixed reality headset",
"macbook air",
"ios",
"macos",
"ipados",
"ios 17",
"ios 17 top features",
"apple vr headset",
"apple vr",
"apple event",
"ios 16",
"ios 17 features",
"ipados 17",
"apple ar",
"apple ar headset",
"macos 14",
"apple leaks",
"apple watch",
"apple news",
"wwdc 23",
"the verge",
"verge"
],
"category": "Science & Technology",
"duration": 1559,
"isFamilySafe": true,
"viewCount": 669335,
"likeCount": 9097,
"commentCount": 684,
"transcript": [
{
"transcription": "welcome to WWDC introducing the 15-inch",
"attributes": {
"start": "0",
"dur": "7.44"
}
},
{
"transcription": "MacBook Air it's only 11.5 millimeters",
"attributes": {
"start": "4.2",
"dur": "5.7"
}
},
{
"transcription": "thin making it the world's thinnest",
"attributes": {
"start": "7.44",
"dur": "5.88"
}
},
{
"transcription": "15-inch laptop and it's easy to carry",
"attributes": {
"start": "9.9",
"dur": "6.06"
}
}
// etc.
]
}