Trabalhando com a API de Dados do Youtube

Você precisa extrair metadados de vídeos do YouTube, pegar os comentários mais recentes e recomendar vídeos relacionados sem perder uma semana lidando com autenticação ou documentos dispersos. Ao final deste guia, você fará consultas a vídeos semelhantes para um determinado ID de vídeo, buscará comentários e recuperará detalhes do vídeo usando a API de Dados do Youtube no Zyla API Hub, com requisições copiáveis e dicas amigáveis para produção.

O que esta API faz e quando usá-la

A API de Dados do Youtube no Zyla oferece três capacidades focadas para aplicativos de mídia:

• Vídeos Semelhantes: Obtenha uma lista de vídeos relacionados passando um ID de vídeo do YouTube. Útil para carrosséis de “Próximo” ou recomendações de conteúdo.
• Comentários de Vídeo: Busque os comentários mais recentes de nível superior com autor, curtidas e timestamps. Útil para filas de moderação, pipelines de sentimento ou painéis comunitários.
• Detalhes do Vídeo: Recupere metadados canônicos como título, descrição, data de publicação e métricas de engajamento. Útil para ingestão, indexação e interfaces de visualização.

Esses endpoints visam fluxos de trabalho comuns de entretenimento e mídia, como construir feeds de assistir a seguir, preencher detalhes de catálogo e analisar feedback do público.

Começando no Zyla API Hub

Abra a página da API, inscreva-se e chame-a com uma única chave de API. O Zyla API Hub fornece uma conta, uma chave de API e um modelo de assinatura + cota em APIs de mídia (não é pago por chamada). Para sua primeira API, você verá um teste de 7 dias ou 50 requisições; não há Plano Gratuito. Verifique a página da API para opções de acesso e preços atuais. Quando estiver pronto, inscreva-se e obtenha sua chave aqui:

Comece o teste de 7 dias na API de Dados do Youtube

Todas as requisições usam o cabeçalho Authorization: Bearer YOUR_API_KEY contra as URLs do hub do Zyla. Você não precisa gerenciar diferentes esquemas de autenticação por provedor.

Endpoints que você usará

Abaixo estão os três endpoints disponíveis nesta lista, incluindo seus métodos HTTP exatos, URLs e parâmetros necessários. Mantenha as URLs e os nomes dos parâmetros exatamente como mostrado.

1) Vídeos Semelhantes

Receba uma lista de vídeos relacionados. Passe um ID de vídeo e obtenha vídeos que são mais semelhantes a ele.

• Método: GET
• URL: https://zylalabs.com/api/14/youtube-data-api/56/similar-videos
• Parâmetros obrigatórios:
  • relatedToVideoId (string): 7ghhRHRP6t4
  • part (string): id,snippet
  • type (string): video
• Parâmetros opcionais:
  • maxResults (string): 50

Exemplo oficial de cURL:

curl -s -X GET "https://zylalabs.com/api/14/youtube-data-api/56/similar-videos?relatedToVideoId=7ghhRHRP6t4&part=id%2Csnippet&type=video&maxResults=50" \
-H "Authorization: Bearer YOUR_API_KEY"

Resposta JSON oficial de exemplo:

{"kind":"youtube#searchListResponse","nextPageToken":"CDIQAA","pageInfo":{"totalResults":108,"resultsPerPage":50},"items":[{"kind":"youtube#searchResult","id":{"kind":"youtube#video","videoId":"mj0XInqZMHY"},"snippet":{"publishedAt":"2019-06-27T14:44:32Z","channelId":"UC0C-w0YjGpqDXGB8IHb662A","title":"Ed Sheeran - Beautiful People (feat. Khalid) [Official Music Video]","description":"O videoclipe oficial de Ed Sheeran - Beautiful People (feat. @khalid)
Subtract, o novo álbum, disponível em 05.05.2023. Pré-venda: https://es.lnk.to/subtract

Extraído do No.6 Collaborations Project lançado em 2019, que apresentou os singles de sucesso 'I Don't Care', 'Cross Me', 'Beautiful People', 'Blow', 'Best Part of Me', 'Antisocial', 'South of the Border' &'Take Me Back To London'.

Inscreva-se no canal de Ed Sheeran para todos os melhores e mais recentes videoclipes oficiais, bastidores e apresentações ao vivo. 
http://bit.ly/SubscribeToEdSheeran

Veja mais vídeos oficiais de Ed Sheeran aqui:
https://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz

Ouça mais do No. 6 Collaborations Project aqui :
https://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l

Siga Ed Sheeran em:
Instagram: http://instagram.com/teddysphotos
TikTok: https://www.tiktok.com/@edsheeran
Facebook: http://www.facebook.com/EdSheeranMusic
Twitter: http://twitter.com/edsheeran
Discord: http://discord.gg/edsheeran
Site Oficial: http://edsheeran.com

Sobre Ed Sheeran:
Ed Sheeran pode ser a quintessência da estrela pop dos anos 2010: um cantor/compositor aclamado internacionalmente e multi-premiado que parece não reconhecer limites entre estilos ou épocas, com elementos de folk, hip-hop, pop, dance, soul e rock entrelaçados em sua música.

Seu incrível catálogo inclui os álbuns de estúdio ‘+’ (plus), ‘x’ (multiply) e ‘÷’ (divide) que geraram singles de sucesso como ‘The A team’, ’Lego House’, ‘Sing', ‘Thinking Out Loud’, ‘Photograph’, ‘Shape Of You’, ‘Castle on The Hill’ e ‘Perfect’.

Em 2019, Ed Sheeran lançou o abrangente ‘No.6 Collaborations Project’ que apresentou uma ampla gama de artistas, incluindo ‘Justin Bieber’, ‘Camilla’ Cabello’, ‘Travis Scott’, ‘Eminem’, ‘Cardi B, ‘Paulo Londra’, ‘Bruno Mars’ e ‘Stormzy’ entre muitos outros, produzindo sucessos como ‘I Don’t Care’, ‘Beautiful People’, ‘South of The Border’ e ‘Take Me Back To London’.

#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…

O que você usará na prática:

• items[].id.videoId: o ID do vídeo relacionado (string).
• items[].snippet.title: título exibido para sua interface.
• items[].snippet.publishedAt: timestamp ISO 8601 (Z = UTC).
• nextPageToken: passe este token de volta em chamadas subsequentes (como o token de página quando suportado) para paginar por mais resultados.

2) Comentários de Vídeo

Obtenha uma lista dos comentários mais recentes sobre um vídeo específico. Você receberá o texto do comentário, informações do autor, curtidas e timestamps de criação/atualização.

• Método: GET
• URL: https://zylalabs.com/api/14/youtube-data-api/61/video-comments
• Parâmetros obrigatórios:
  • part (string): snippet
  • videoId (string): 7ghhRHRP6t4
  • maxResults (string): 100

Campos típicos para ler da resposta:

• items[].snippet.topLevelComment.snippet.textDisplay ou textOriginal: o corpo do comentário.
• items[].snippet.topLevelComment.snippet.authorDisplayName: nome de exibição do comentarista.
• items[].snippet.topLevelComment.snippet.likeCount: contagem de curtidas inteira.
• items[].snippet.topLevelComment.snippet.publishedAt e updatedAt: tempos UTC ISO 8601.
• nextPageToken: se fornecido, continue a paginação.

3) Detalhes do Vídeo

Obtenha detalhes de qualquer vídeo: título, descrição, data de publicação e contagens de engajamento.

• Método: GET
• URL: https://zylalabs.com/api/14/youtube-data-api/62/video-details
• Parâmetros obrigatórios:
  • id (string): 7ghhRHRP6t4

Campos típicos para ler da resposta:

• items[].snippet.title e items[].snippet.description para exibição e indexação.
• items[].snippet.publishedAt para cronologia e filtragem.
• Outros campos de estatísticas podem estar presentes dependendo do provedor upstream; consulte a carga útil que você recebe.

Exemplo em Python: buscar e renderizar vídeos relacionados

Este trecho de Python chama o endpoint de Vídeos Semelhantes, extrai o videoId e o título para renderizar uma lista de assistir a seguir, e mostra como lidar com a paginação via nextPageToken.

import requests

API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/14/youtube-data-api/56/similar-videos"
params = {
"relatedToVideoId": "7ghhRHRP6t4",
"part": "id,snippet",
"type": "video",
"maxResults": "50",
}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()

# Extrair itens para a interface
items = data.get("items", [])
related = []
for item in items:
vid = ((item or {}).get("id") or {}).get("videoId")
title = ((item or {}).get("snippet") or {}).get("title")
if vid and title:
related.append({"videoId": vid, "title": title})

print(f"Obtido {len(related)} vídeos relacionados:")
for r in related[:5]:
print(f"- {r['videoId']}: {r['title']}")

# Lidar com paginação se nextPageToken estiver presente (passe-o como um token de página quando suportado)
next_token = data.get("nextPageToken")
if next_token:
print("Mais páginas disponíveis via nextPageToken:", next_token)

Casos de uso de mídia do mundo real que você pode enviar esta semana

• Assistir a seguir e recomendações: Use Vídeos Semelhantes para semear um “Porque você assistiu X” em seu aplicativo ou interface de player incorporada.
• Páginas de detalhes do vídeo: Preencha os metadados principais com Detalhes do Vídeo; armazene em cache a resposta JSON para minimizar buscas repetidas.
• Comunidade e moderação: Alimente Comentários de Vídeo em uma fila para moderação ou um simples widget de “Comentários recentes”; armazene authorDisplayName, textOriginal, likeCount e timestamps.
• Curadoria editorial: Construa ferramentas internas onde editores coloquem um ID de vídeo e instantaneamente obtenham conteúdo relacionado para construção de coleções.
• Notificações e alertas: Monitore comentários em vídeos de alta prioridade (poll em um intervalo razoável) e alerte criadores ou equipes de suporte.

Notas de implementação que economizam tempo

• Timestamps: os campos publishedAt e updatedAt são strings ISO 8601 com um Z final para UTC. Converta uma vez e normalize em seus serviços.
• Paginação: Se nextPageToken estiver presente na resposta, capture-o e emita requisições de acompanhamento para recuperar resultados adicionais. Não assuma que todos os resultados cabem em uma página.
• maxResults: Mantenha em 50 quando precisar de menos viagens; reduza para interfaces leves onde a renderização inicial precisa ser rápida.
• Cache: Armazene em cache os Detalhes do Vídeo para vídeos estáveis para reduzir latência e uso de cota. Para comentários, aplique janelas de cache mais curtas, pois novos comentários chegam com frequência.
• Tratamento de erros: Trate respostas não-2xx como problemas transitórios ou relacionados a permissões. Registre a URL da requisição e o status; evite tempestades de tentativas.
• Segurança: Use o cabeçalho Authorization: Bearer YOUR_API_KEY do lado do servidor. Evite expor sua chave de API no código do lado do cliente.

Como chamá-lo de um agente de IA (MCP)

Se você estiver orquestrando tarefas com um cliente compatível com MCP (por exemplo, Claude Code, Cursor, Windsurf), você pode direcionar chamadas através do endpoint MCP do Zyla e reutilizar a mesma chave. Consulte a documentação do MCP e configure seu cliente para apontar para:

MCP

Passe sua chave de API conforme indicado pela configuração do seu cliente MCP (apikey=YOUR_API_KEY na URL do endpoint). A partir daí, seu agente pode invocar as ferramentas da API de Dados do Youtube expostas pelo hub sem codificar manualmente chamadas HTTP. Isso é útil para curadoria de conteúdo scriptada ou extrações de dados ad-hoc enquanto você prototipa.

Referência: requisições e campos exatos

Vídeos Semelhantes

GET https://zylalabs.com/api/14/youtube-data-api/56/similar-videos

• relatedToVideoId (obrigatório)
• part (obrigatório)
• type (obrigatório)
• maxResults (opcional)

Campos principais para ler:

• items[].id.videoId
• items[].snippet.title
• items[].snippet.publishedAt
• nextPageToken

Comentários de Vídeo

GET https://zylalabs.com/api/14/youtube-data-api/61/video-comments

• part (obrigatório)
• videoId (obrigatório)
• maxResults (obrigatório)

Campos principais para ler:

• items[].snippet.topLevelComment.snippet.textDisplay
• items[].snippet.topLevelComment.snippet.authorDisplayName
• items[].snippet.topLevelComment.snippet.likeCount
• items[].snippet.topLevelComment.snippet.publishedAt
• nextPageToken (se presente)

Detalhes do Vídeo

GET https://zylalabs.com/api/14/youtube-data-api/62/video-details

• id (obrigatório)

Campos principais para ler:

• items[].snippet.title
• items[].snippet.description
• items[].snippet.publishedAt

Orientações operacionais para aplicativos de mídia

• Planejamento de throughput: O Zyla usa um modelo de assinatura + cota, não pago por chamada. Sua primeira API inclui um teste de 7 dias ou 50 requisições. Para volumes maiores, monitore seu uso e verifique a página da API para opções atuais.
• Frescor dos dados: Comentários mudam rapidamente; detalhes do vídeo menos. Ajuste seus TTLs de cache de acordo.
• Estratégia de indexação: Armazene identificadores estáveis (videoId) como sua chave estrangeira e desnormalize título/descrição para suportar pesquisa e renderizações rápidas.
• Resiliência: Aplique backoff em respostas 429/5xx. Registre qual endpoint e parâmetros foram usados para acelerar a depuração.
• Internacionalização: Títulos e descrições podem conter Unicode e entidades HTML. Normalize e escape para seu framework de interface.

FAQ

P: Que autenticação eu uso?
R: Use o cabeçalho Authorization: Bearer YOUR_API_KEY em cada requisição para as URLs do hub do Zyla.

P: Existe um plano gratuito?
R: Não há Plano Gratuito. Para sua primeira API, você verá um teste de 7 dias ou 50 requisições. Verifique a página da API para opções de acesso e preços atuais.

P: Como faço para paginar resultados?
R: Leia nextPageToken da resposta. Quando presente, chame o endpoint novamente e inclua esse token como o token de página onde suportado para buscar a próxima página.

P: Quais timestamps e fuso horário devo esperar?
R: Timestamps como publishedAt e updatedAt são strings ISO 8601 com um sufixo Z indicando UTC.

P: Posso chamar isso do meu agente de codificação de IA?
R: Sim, via endpoint MCP do Zyla. Configure seu cliente compatível com MCP para usar a URL MCP e sua chave de API para que o agente possa chamar as ferramentas da API de Dados do Youtube sem código HTTP manual.

Pronto para enviar sua integração de mídia? Inscreva-se e obtenha sua chave de API na lista do marketplace: Comece o teste de 7 dias na API de Dados do Youtube. Explore milhares de outras APIs de mídia e envie mais rápido no Zyla API Hub.

Resposta oficial da API

{"kind":"youtube#searchListResponse","nextPageToken":"CDIQAA","pageInfo":{"totalResults":108,"resultsPerPage":50},"items":[{"kind":"youtube#searchResult","id":{"kind":"youtube#video","videoId":"mj0XInqZMHY"},"snippet":{"publishedAt":"2019-06-27T14:44:32Z","channelId":"UC0C-w0YjGpqDXGB8IHb662A","title":"Ed Sheeran - Beautiful People (feat. Khalid) [Official Music Video]","description":"O videoclipe oficial de Ed Sheeran - Beautiful People (feat. @khalid)
Subtract, o novo álbum, disponível em 05.05.2023. Pré-venda: https://es.lnk.to/subtract

Extraído do No.6 Collaborations Project lançado em 2019, que apresentou os singles de sucesso 'I Don't Care', 'Cross Me', 'Beautiful People', 'Blow', 'Best Part of Me', 'Antisocial', 'South of the Border' &'Take Me Back To London'.

Inscreva-se no canal de Ed Sheeran para todos os melhores e mais recentes videoclipes oficiais, bastidores e apresentações ao vivo. 
http://bit.ly/SubscribeToEdSheeran

Veja mais vídeos oficiais de Ed Sheeran aqui:
https://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz

Ouça mais do No. 6 Collaborations Project aqui :
https://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l

Siga Ed Sheeran em:
Instagram: http://instagram.com/teddysphotos
TikTok: https://www.tiktok.com/@edsheeran
Facebook: http://www.facebook.com/EdSheeranMusic
Twitter: http://twitter.com/edsheeran
Discord: http://discord.gg/edsheeran
Site Oficial: http://edsheeran.com

Sobre Ed Sheeran:
Ed Sheeran pode ser a quintessência da estrela pop dos anos 2010: um cantor/compositor aclamado internacionalmente e multi-premiado que parece não reconhecer limites entre estilos ou épocas, com elementos de folk, hip-hop, pop, dance, soul e rock entrelaçados em sua música.

Seu incrível catálogo inclui os álbuns de estúdio ‘+’ (plus), ‘x’ (multiply) e ‘÷’ (divide) que geraram singles de sucesso como ‘The A team’, ’Lego House’, ‘Sing', ‘Thinking Out Loud’, ‘Photograph’, ‘Shape Of You’, ‘Castle on The Hill’ e ‘Perfect’.

Em 2019, Ed Sheeran lançou o abrangente ‘No.6 Collaborations Project’ que apresentou uma ampla gama de artistas, incluindo ‘Justin Bieber’, ‘Camilla’ Cabello’, ‘Travis Scott’, ‘Eminem’, ‘Cardi B, ‘Paulo Londra’, ‘Bruno Mars’ e ‘Stormzy’ entre muitos outros, produzindo sucessos como ‘I Don’t Care’, ‘Beautiful People’, ‘South of The Border’ e ‘Take Me Back To London’.

#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…

Resposta oficial da API

{"kind":"youtube#searchListResponse","nextPageToken":"CDIQAA","pageInfo":{"totalResults":108,"resultsPerPage":50},"items":[{"kind":"youtube#searchResult","id":{"kind":"youtube#video","videoId":"mj0XInqZMHY"},"snippet":{"publishedAt":"2019-06-27T14:44:32Z","channelId":"UC0C-w0YjGpqDXGB8IHb662A","title":"Ed Sheeran - Beautiful People (feat. Khalid) [Official Music Video]","description":"O videoclipe oficial de Ed Sheeran - Beautiful People (feat. @khalid)
Subtract, o novo álbum, disponível em 05.05.2023. Pré-venda: https://es.lnk.to/subtract

Extraído do No.6 Collaborations Project lançado em 2019, que apresentou os singles de sucesso 'I Don't Care', 'Cross Me', 'Beautiful People', 'Blow', 'Best Part of Me', 'Antisocial', 'South of the Border' &'Take Me Back To London'.

Inscreva-se no canal de Ed Sheeran para todos os melhores e mais recentes videoclipes oficiais, bastidores e apresentações ao vivo. 
http://bit.ly/SubscribeToEdSheeran

Veja mais vídeos oficiais de Ed Sheeran aqui:
https://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz

Ouça mais do No. 6 Collaborations Project aqui :
https://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l

Siga Ed Sheeran em:
Instagram: http://instagram.com/teddysphotos
TikTok: https://www.tiktok.com/@edsheeran
Facebook: http://www.facebook.com/EdSheeranMusic
Twitter: http://twitter.com/edsheeran
Discord: http://discord.gg/edsheeran
Site Oficial: http://edsheeran.com

Sobre Ed Sheeran:
Ed Sheeran pode ser a quintessência da estrela pop dos anos 2010: um cantor/compositor aclamado internacionalmente e multi-premiado que parece não reconhecer limites entre estilos ou épocas, com elementos de folk, hip-hop, pop, dance, soul e rock entrelaçados em sua música.

Seu incrível catálogo inclui os álbuns de estúdio ‘+’ (plus), ‘x’ (multiply) e ‘÷’ (divide) que geraram singles de sucesso como ‘The A team’, ’Lego House’, ‘Sing', ‘Thinking Out Loud’, ‘Photograph’, ‘Shape Of You’, ‘Castle on The Hill’ e ‘Perfect’.

Em 2019, Ed Sheeran lançou o abrangente ‘No.6 Collaborations Project’ que apresentou uma ampla gama de artistas, incluindo ‘Justin Bieber’, ‘Camilla’ Cabello’, ‘Travis Scott’, ‘Eminem’, ‘Cardi B, ‘Paulo Londra’, ‘Bruno Mars’ e ‘Stormzy’ entre muitos outros, produzindo sucessos como ‘I Don’t Care’, ‘Beautiful People’, ‘South of The Border’ e ‘Take Me Back To London’.

#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…