{
"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/13681/youtube+scene+detection+api/31125/key+scenes' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Detecção de Cena do YouTube API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.
(Economize 2 meses com cobrança anual 🎉)
A API de Detecção de Cenas do YouTube ajuda os usuários a identificar e explorar os momentos mais relevantes em vídeos do YouTube sem precisar assistir todo o vídeo manualmente. Ao inserir um ID de vídeo do YouTube, a API recupera momentos-chave e os organiza em uma resposta estruturada e amigável ao usuário, completa com timestamps, títulos e miniaturas
A API foi projetada para aplicativos que precisam entender rapidamente as seções importantes de conteúdos longos do YouTube. Em vez de forçar os usuários a pesquisarem por todo o vídeo, ela fornece links diretos para os destaques, tornando a navegação em vídeos mais rápida e eficiente
Cada momento-chave detectado inclui seu título, posição de início em segundos e uma miniatura associada. Essas informações podem ser usadas para criar resumos de vídeos, navegação por capítulos, resumos de conteúdo, interfaces de vídeo pesquisáveis e ferramentas de descoberta automatizada
A API retorna dados estruturados sobre momentos-chave em vídeos do YouTube, incluindo carimbos de tempo, títulos e miniaturas para cada cena detectada Isso permite que os usuários naveguem rapidamente para partes relevantes do vídeo sem assisti-lo na íntegra
Os campos principais na resposta incluem `video.id`, `video.title`, `video.length_seconds`, `search_metadata` e detalhes sobre cada momento chave, como `timestamp`, `title` e `thumbnail`. Esses campos fornecem informações essenciais para a navegação em vídeos
Os dados da resposta estão organizados em várias seções: `search_metadata` contém detalhes da solicitação, `search_parameters` mostra os parâmetros de entrada e `video` fornece informações sobre o próprio vídeo. Momentos-chave geralmente estão listados em uma seção separada
A API fornece informações sobre o vídeo, incluindo seu título, duração, visualizações, curtidas e autor, bem como momentos-chave com seus respectivos timestamps, títulos e miniaturas, facilitando a descoberta eficiente de conteúdo
O principal parâmetro é `video_id`, que especifica o vídeo do YouTube a ser analisado. Parâmetros adicionais podem incluir `gl` (geolocalização) e `hl` (idioma), permitindo que os usuários personalizem suas solicitações com base nas preferências de região e idioma
Os usuários podem utilizar os dados retornados para criar resumos em vídeo aprimorar recursos de navegação ou desenvolver interfaces pesquisáveis. Ao vincular diretamente a momentos-chave os aplicativos podem melhorar o engajamento do usuário e a acessibilidade do conteúdo
Casos de uso típicos incluem a criação de resumos de vídeo, o desenvolvimento de navegação por capítulos para vídeos longos, a melhoria das ferramentas de descoberta de conteúdo e a construção de sistemas automatizados para análise de vídeo, facilitando para os usuários encontrar conteúdo relevante
A precisão dos dados é mantida através da análise automatizada de conteúdo de vídeo aproveitando os metadados existentes do YouTube e algoritmos para identificar momentos-chave Atualizações regulares e verificações de qualidade garantem a confiabilidade das cenas detectadas