Find notable moments across YouTube videos and provide timestamps, scene titles, and thumbnails for easy navigation.
Run in Postman
{
"search_metadata": {
"id": "search_pVr1MO4QrQFQBrmq9vblzoE9",
"status": "Success",
"created_at": "2026-08-19T21:53:29Z",
"request_time_taken": 1.67,
"parsing_time_taken": 0.02,
"total_time_taken": 1.69,
"request_url": "https://www.youtube.com/watch?v=cJRP3LRcUFg",
"html_url": "-/api/v1/searches/search_pVr1MO4QrQFQBrmq9vblzoE9.html",
"json_url": "-/api/v1/searches/search_pVr1MO4QrQFQBrmq9vblzoE9"
},
"search_parameters": {
"engine": "youtube_video",
"video_id": "cJRP3LRcUFg",
"gl": "US",
"hl": "en"
},
"video": {
"id": "cJRP3LRcUFg",
"title": "The Smiths - This Charming Man (Official Music Video)",
"length_seconds": 163,
"views": 131903053,
"likes": 819000,
"author": "The Smiths",
"category": "Music",
"published_time": "Feb 6, 2014",
"description": "Official video for This Charming Man by The Smiths \n\nStream The Smiths greatest hits here ▶ https://lnk.to/TheSmithsHits\n\nSubscribe here ▶ https://www.youtube.com/c/thesmithsofficial?sub_confirmation=1\n\nWatch The Smiths' other official music videos ▶ https://www.youtube.com/playlist?list=PLFIhsqj9dojqMSmDjAf6xLl9limlz95-e\n\n\n\"This Charming Man\" was released as the group's second single in October 1983.\nThe single was re-issued in 1992, reaching number 8 on the UK singles chart. Mojo magazine journalists placed the track at number one on their 2008 \"50 Greatest UK Indie Records of All Time\" feature.\n\n\nLyrics\n\nPunctured bicycle \nOn a hillside desolate \nWill nature make a man of me yet?\nWhen in this charming car \nThis charming man\nWhy pamper life's complexity \nWhen the leather runs smooth \nOn the passenger's seat?\nI would go out tonight \nBut I haven't got a stitch to wear \nThis man said \"it's gruesome \nThat someone so handsome should care\"\nAh ! A jumped-up pantry boy \nWho never knew his place \nHe said \"return the ring\"\nHe knows so much about these things \nHe knows so much about these things\nI would go out tonight \nBut I haven't got a stitch to wear \nThis man said \"it's gruesome \nThat someone so handsome should care\"\nLa, la-la, la-la, la-la, this charming man\nOh, la-la, la-la, la-la, this charming man\nAh ! A jumped-up pantry boy \nWho never knew his place \nHe said \"return the ring\"\nHe knows so much about these things \nHe knows so much about these things \nHe knows so much about these things\n\n#TheSmiths #ThisCharmingMan",
"keywords": [
"The Smiths",
"This Charming Man",
"The Smiths This Charming Man",
"The Smiths Official Video",
"This Charming Man Official Video",
"The Smiths Music",
"The Smiths Lyrics",
"This Charming Man Lyrics",
"The Smiths 1983",
"The Smiths Songs",
"Indie",
"Rock",
"Indie Rock",
"Alternative Rock",
"English Music",
"English Songs",
"Morrissey",
"Johnny Marr",
"Andy Rourke",
"Mike Joyce",
"Smiths",
"smiths this charming man",
"Music",
"80s",
"1980s",
"80s music",
"Charming Man"
],
"is_family_safe": true,
"thumbnail": "https://i.ytimg.com/vi_webp/cJRP3LRcUFg/maxresdefault.webp",
"formats": [
{
"itag": 137,
"mime_type": "video/mp4; codecs=\"avc1.640028\"",
"bitrate": 1955659,
"width": 1920,
"height": 1080,
"last_modified_unix": "1754953971894876",
"last_modified": "2025-08-11 23:12:51 UTC",
"content_length": "26712677",
"quality": "hd1080",
"fps": 25,
"quality_label": "1080p",
"projection_type": "RECTANGULAR"
},
{
"itag": 248,
"mime_type": "video/webm; codecs=\"vp9\"",
"bitrate": 1042274,
"width": 1920,
"height": 1080,
"last_modified_unix": "1754952798685398",
"last_modified": "2025-08-11 22:53:18 UTC",
"content_length": "13124082",
"quality": "hd1080",
"fps": 25,
"quality_label": "1080p",
"projection_type": "RECTANGULAR"
},
{
"itag": 399,
"mime_type": "video/mp4; codecs=\"av01.0.08M.08\"",
"bitrate": 953565,
"width": 1920,
"height": 1080,
"last_modified_unix": "1754953882267106",
"last_modified": "2025-08-11 23:11:22 UTC",
"content_length": "11025743",
"quality": "hd1080",
"fps": 25,
"quality_label": "1080p",
"projection_type": "RECTANGULAR"
},
{
"itag": 136,
"mime_type": "video/mp4; codecs=\"avc1.4d401f\"",
"bitrate": 652716,
"width": 1280,
"height": 720,
"last_modified_unix": "1754953355439237",
"last_modified": "2025-08-11 23:02:35 UTC",
"content_length": "8802649",
"quality": "hd720",
"fps": 25,
"quality_label": "720p",
"projection_type": "RECTANGULAR"
},
{
"itag": 247,
"mime_type": "video/webm; codecs=\"vp9\"",
"bitrate": 637838,
"width": 1280,
"height": 720,
"last_modified_unix": "1754952856986506",
"last_modified": "2025-08-11 22:54:16 UTC",
"content_length": "7856656",
"quality": "hd720",
"fps": 25,
"quality_label": "720p",
"projection_type": "RECTANGULAR"
},
{
"itag": 398,
"mime_type": "video/mp4; codecs=\"av01.0.05M.08\"",
"bitrate": 601898,
"width": 1280,
"height": 720,
"last_modified_unix": "1754952847297264",
"last_modified": "2025-08-11 22:54:07 UTC",
"content_length": "6692893",
"quality": "hd720",
"fps": 25,
"quality_label": "720p",
"projection_type": "RECTANGULAR"
},
{
"itag": 135,
"mime_type": "video/mp4; codecs=\"avc1.4d401e\"",
"bitrate": 369240,
"width": 854,
"height": 480,
"last_modified_unix": "1754953355575678",
"last_modified": "2025-08-11 23:02:35 UTC",
"content_length": "4859497",
"quality": "large",
"fps": 25,
"quality_label": "480p",
"projection_type": "RECTANGULAR"
},
{
"itag": 244,
"mime_type": "video/webm; codecs=\"vp9\"",
"bitrate": 377979,
"width": 854,
"height": 480,
"last_modified_unix": "1754953013758245",
"last_modified": "2025-08-11 22:56:53 UTC",
"content_length": "4595408",
"quality": "large",
"fps": 25,
"quality_label": "480p",
"projection_type": "RECTANGULAR"
},
{
"itag": 397,
"mime_type": "video/mp4; codecs=\"av01.0.04M.08\"",
"bitrate": 330704,
"width": 854,
"height": 480,
"last_modified_unix": "1754953139343507",
"last_modified": "2025-08-11 22:58:59 UTC",
"content_length": "3971250",
"quality": "large",
"fps": 25,
"quality_label": "480p",
"projection_type": "RECTANGULAR"
},
{
"itag": 134,
"mime_type": "video/mp4; codecs=\"avc1.4d401e\"",
"bitrate": 253995,
"width": 640,
"height": 360,
"last_modified_unix": "1754953355483447",
"last_modified": "2025-08-11 23:02:35 UTC",
"content_length": "3298445",
"quality": "medium",
"fps": 25,
"quality_label": "360p",
"projection_type": "RECTANGULAR"
},
{
"itag": 243,
"mime_type": "video/webm; codecs=\"vp9\"",
"bitrate": 261001,
"width": 640,
"height": 360,
"last_modified_unix": "1754952851653408",
"last_modified": "2025-08-11 22:54:11 UTC",
"content_length": "3317371",
"quality": "medium",
"fps": 25,
"quality_label": "360p",
"projection_type": "RECTANGULAR"
},
{
"itag": 396
}
]
},
"_note": "Response truncated for documentation purposes"
}
curl --location --request GET 'https://zylalabs.com/api/13679/youtube+scene+analysis+api/31123/key+scenes' --header 'Authorization: Bearer YOUR_API_KEY'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the YouTube Scene Analysis API simply include your bearer token in the Authorization header.
| Header | Description |
|---|---|
Authorization
|
Required
Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.
|
No long-term commitment. Upgrade, downgrade, or cancel anytime.
(Save 2 months with annual billing 🎉)
The YouTube Scene Analysis API helps users identify and explore the most relevant moments in YouTube videos without having to manually watch the entire video. By entering a YouTube video ID, the API retrieves key moments and organizes them into a structured, user-friendly response, complete with timestamps, titles, and thumbnails.
The API is designed for applications that need to quickly understand the important sections of long YouTube content. Instead of forcing users to search through an entire video, it provides direct links to highlights, making video navigation faster and more efficient.
Each detected key moment includes its title, starting position in seconds, and an associated thumbnail. This information can be used to create video summaries, chapter navigation, content summaries, searchable video interfaces, and automated discovery tools.
The API returns structured data about key moments in YouTube videos, including timestamps, titles, and thumbnails for each detected scene. This allows users to quickly navigate to relevant parts of the video without watching it in full.
Key fields in the response include `video.id`, `video.title`, `video.length_seconds`, `search_metadata`, and details about each key moment such as `timestamp`, `title`, and `thumbnail`. These fields provide essential information for video navigation.
The response data is organized into several sections: `search_metadata` contains request details, `search_parameters` shows the input parameters, and `video` provides information about the video itself. Key moments are typically listed under a separate section.
The API provides information about the video, including its title, length, views, likes, and author, as well as key moments with their respective timestamps, titles, and thumbnails, facilitating efficient content discovery.
The main parameter is `video_id`, which specifies the YouTube video to analyze. Additional parameters may include `gl` (geolocation) and `hl` (language), allowing users to customize their requests based on region and language preferences.
Users can utilize the returned data to create video summaries, enhance navigation features, or develop searchable interfaces. By linking directly to key moments, applications can improve user engagement and content accessibility.
Typical use cases include creating video summaries, developing chapter navigation for long videos, enhancing content discovery tools, and building automated systems for video analysis, making it easier for users to find relevant content.
Data accuracy is maintained through automated analysis of video content, leveraging YouTube's existing metadata and algorithms to identify key moments. Regular updates and quality checks ensure the reliability of the detected scenes.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
