{
"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/13680/youtube+scene+recognition+api/31124/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 Reconhecimento 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 Reconhecimento de Cena do YouTube ajuda os usuários a identificar e explorar os momentos mais relevantes em vídeos do YouTube sem precisar assistir manualmente ao vídeo inteiro. Ao inserir um ID de vídeo do YouTube, a API recupera momentos-chave e os organiza em uma resposta estruturada e fácil de usar, completa com timestamps, títulos e miniaturas.
A API é projetada para aplicações que precisam entender rapidamente as seções importantes de conteúdos longos do YouTube. Em vez de forçar os usuários a procurar por um vídeo inteiro, 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 inicial 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 timestamps, 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 de 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. Os momentos-chave geralmente sã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 horários, títulos e miniaturas, facilitando a descoberta eficiente de conteúdo
O parâmetro principal é `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 em preferências de região e idioma
Os usuários podem utilizar os dados retornados para criar resumos de vídeo, aprimorar recursos de navegação ou desenvolver interfaces pesquisáveis Ao vincular diretamente a momentos chave, os aplicativos podem melhorar o envolvimento do usuário e a acessibilidade do conteúdo
Casos de uso típicos incluem criar resumos de vídeo desenvolver navegação de capítulos para vídeos longos aprimorar ferramentas de descoberta de conteúdo e construir sistemas automatizados para análise de vídeo facilitando a busca de conteúdo relevante pelos usuários
A precisão dos dados é mantida através da análise automatizada do conteúdo de vídeo aproveitando os metadados existentes do YouTube e os algoritmos para identificar momentos-chave Atualizações regulares e verificações de qualidade garantem a confiabilidade das cenas detectadas