Início
Blog
Como Usar a API de Dados do Youtube
Blog

Como Usar a API de Dados do Youtube

Como Usar a API de Dados do Youtube

Você precisa lançar um recurso de mídia esta semana: dado um ID de vídeo do YouTube, busque vídeos semelhantes para recomendações, carregue os comentários mais recentes para moderação ou widgets de comunidade, e obtenha detalhes ricos do vídeo para sua interface. Ao final deste guia, você usará a API de Dados do Youtube no Zyla API Hub para fazer exatamente isso com requisições que você pode copiar e colar em seu backend ou script hoje.

O que esta API oferece

A API de Dados do Youtube no Zyla API Hub fornece três endpoints focados para aplicações de mídia:

Ilustração: Como Usar a API de Dados do Youtube
  • Vídeos Semelhantes: busque uma lista de vídeos relacionados a um ID de vídeo dado para recomendações.
  • Comentários de Vídeo: recupere os threads de comentários mais recentes (autor, texto, curtidas, timestamps) para um vídeo específico.
  • Detalhes do Vídeo: obtenha metadados principais para um vídeo, incluindo título, descrição, data de publicação e mais.

Esses endpoints estão prontos para uso através do gateway unificado da Zyla e funcionam bem para trilhos de recomendação, filas de moderação de comentários, curadoria editorial e painéis de análise.

Começando no Zyla API Hub

Abra a página da API de Dados do Youtube no Zyla e clique em Inscrever-se ou Começar Teste Gratuito quando disponível. Você receberá uma única chave de API que pode usar em todas as chamadas. A autenticação é via o cabeçalho HTTP Authorization: Bearer SUA_CHAVE_API. A Zyla opera em um modelo de assinatura + cota; verifique a página da API para opções de acesso e preços atuais.

Você pode navegar por mais de 10.000 APIs públicas em zylalabs.com, adicionar várias APIs de mídia e entretenimento a uma conta, e chamá-las com uma chave de API. A API de Dados do Youtube oferece um teste de 7 dias a partir da listagem do marketplace.

Endpoints que você usará

1) Vídeos Semelhantes

Receba uma lista de vídeos mais semelhantes a um dado.

  • Método: GET
  • URL: https://zylalabs.com/api/14/youtube-data-api/56/similar-videos
  • Parâmetros de consulta obrigatórios:
    • relatedToVideoId (string): 7ghhRHRP6t4
    • part (string): id,snippet
    • type (string): video
  • Parâmetros de consulta 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 SUA_CHAVE_API"

Resposta de exemplo oficial:

{"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)\nSubtract, o novo álbum, disponível em 05.05.2023. Pré-venda: https://es.lnk.to/subtract\n \nRetirado 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'. \n \nInscreva-se no canal de Ed Sheeran para todos os melhores e mais recentes videoclipes oficiais, bastidores e apresentações ao vivo.  \nhttp://bit.ly/SubscribeToEdSheeran \n \nVeja mais vídeos oficiais de Ed Sheeran aqui: \nhttps://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz \n\nOuça mais do No. 6 Collaborations Project aqui : \nhttps://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l\n \nSiga Ed Sheeran em: \nInstagram: http://instagram.com/teddysphotos\nTikTok: https://www.tiktok.com/@edsheeran\nFacebook: http://www.facebook.com/EdSheeranMusic\nTwitter: http://twitter.com/edsheeran\nDiscord: http://discord.gg/edsheeran\nSite Oficial: http://edsheeran.com \n\nSobre Ed Sheeran: \nEd Sheeran pode ser a estrela pop quintessencial dos anos 2010: um cantor/compositor internacionalmente aclamado 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. \n\nSeu 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’. \n \nEm 2019, Ed Sheeran lançou o ‘No.6 Collaborations Project’ que abrangeu 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’. \n \n#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…

O que você usará deste payload:

  • items[].id.videoId: o ID do vídeo alvo para vinculação ou reprodução.
  • items[].snippet.title: a manchete clicável para sua interface.
  • items[].snippet.publishedAt: timestamp ISO 8601 que você pode exibir ou classificar.
  • nextPageToken: use-o para paginar se você precisar de mais do que resultsPerPage.
  • pageInfo.totalResults e pageInfo.resultsPerPage: para dimensionar a paginação e a interface.

2) Comentários de Vídeo

Obtenha os threads de comentários mais recentes para um vídeo dado. Útil para ferramentas de moderação, seções de prova social e análises de engajamento.

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

Exemplo oficial de curl:

Resposta 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)\nSubtract, o novo álbum, disponível em 05.05.2023. Pré-venda: https://es.lnk.to/subtract\n \nRetirado 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'. \n \nInscreva-se no canal de Ed Sheeran para todos os melhores e mais recentes videoclipes oficiais, bastidores e apresentações ao vivo.  \nhttp://bit.ly/SubscribeToEdSheeran \n \nVeja mais vídeos oficiais de Ed Sheeran aqui: \nhttps://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz \n\nOuça mais do No. 6 Collaborations Project aqui : \nhttps://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l\n \nSiga Ed Sheeran em: \nInstagram: http://instagram.com/teddysphotos\nTikTok: https://www.tiktok.com/@edsheeran\nFacebook: http://www.facebook.com/EdSheeranMusic\nTwitter: http://twitter.com/edsheeran\nDiscord: http://discord.gg/edsheeran\nSite Oficial: http://edsheeran.com \n\nSobre Ed Sheeran: \nEd Sheeran pode ser a estrela pop quintessencial dos anos 2010: um cantor/compositor internacionalmente aclamado 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. \n\nSeu 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’. \n \nEm 2019, Ed Sheeran lançou o ‘No.6 Collaborations Project’ que abrangeu 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’. \n \n#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…

Campos que você geralmente lerá:

  • items[].snippet.topLevelComment.snippet.textOriginal e textDisplay: a string do comentário.
  • items[].snippet.topLevelComment.snippet.authorDisplayName e authorProfileImageUrl: informações do autor.
  • items[].snippet.topLevelComment.snippet.likeCount: métrica de engajamento.
  • items[].snippet.topLevelComment.snippet.publishedAt: timestamp ISO para ordenação.
  • nextPageToken e pageInfo para paginação.

3) Detalhes do Vídeo

Recupere metadados para um vídeo específico. Ideal para páginas de detalhes, embeds e painéis editoriais.

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

Exemplo oficial de curl:

Resposta de exemplo:

{"kind":"youtube#videoListResponse","items":[{"kind":"youtube#video","id":"7ghhRHRP6t4","snippet":{"publishedAt":"2020-07-24T04:00:10Z","channelId":"UCN1hnUccO4FD5WfM7ithXaw","title":"Maroon 5 - Nobody's Love (Official Music Video)","description":"“Nobody’s Love” está disponível agora: https://smarturl.it/NobodysLove \n\nPara mais, visite: \nInstagram: https://www.instagram.com/maroon5 \nFacebook: https://www.facebook.com/maroon5 \nTwitter: https://twitter.com/maroon5 \nInscreva-se para atualizações: http://smarturl.it/Maroon5.News \n\n// \n\nLETRA \n\nVocê poderia fazer um homem crescido chorar\nSe você algum dia dissesse adeus\nNunca deixarei você ir oh-woah oh-I\nNunca deixarei você ir oh-woah oh-I\nVocê poderia fazer um homem crescido chorar\nSe você algum dia deixasse meu lado\nNunca deixarei você ir oh-woah oh-I\nNunca deixarei você ir oh-woah oh-I\n\nVocê é a única mão no meu bolso de trás\nSe você algum dia saísse, eu ficaria psicótico\nO céu me ouça chorando chorando oh oh\nBaby, você é a chave do meu coração\nSe você algum dia saísse, nunca a desbloqueie\nSozinho como uma ilha, ilha oh oh\n\nSe meu amor não é seu amor, nunca será o amor de ninguém\nNunca vou precisar do amor de ninguém, exceto o seu, exceto o seu\nSe meu amor não é seu amor, nunca será o amor de ninguém\nNunca vou precisar de nob…

Da resposta, você geralmente renderiza:

  • items[0].snippet.title e description: os principais metadados para a página.
  • items[0].snippet.publishedAt: exibir no horário local após conversão de UTC ISO 8601.
  • items[0].id: o ID de vídeo canônico a ser passado para outros endpoints.

Exemplo de ponta a ponta: construir um trilho de “Vídeos Relacionados”

O seguinte trecho de Python chama o endpoint de Vídeos Semelhantes, lista o ID, título e timestamp de publicação de cada vídeo relacionado, e mostra como lidar com a paginação via nextPageToken, se presente. Substitua SUA_CHAVE_API pelo seu valor do Zyla.

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "SUA_CHAVE_API")
BASE_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}",
}

def fetch_similar_videos():
r = requests.get(BASE_URL, params=params, headers=headers, timeout=20)
r.raise_for_status()
data = r.json()
for item in data.get("items", []):
vid = item.get("id", {}).get("videoId")
snip = item.get("snippet", {})
title = snip.get("title")
published = snip.get("publishedAt")
print(f"{vid}\t{published}\t{title}")
# Se você precisar de páginas adicionais, verifique nextPageToken em data
if "nextPageToken" in data:
print("Próximo token de página:", data["nextPageToken"])

if __name__ == "__main__":
fetch_similar_videos()

Notas que economizam tempo:

  • Os timestamps como publishedAt e comment publishedAt estão em ISO 8601 em UTC. Converta do lado do cliente para exibições locais.
  • Use nextPageToken para paginar. Armazene respostas por ID de vídeo para evitar hits repetidos quando os usuários rolarem ou revisitarem.
  • O cabeçalho Authorization deve estar presente em cada requisição para os endpoints da Zyla.

Casos de uso práticos de mídia que você pode lançar

  • Recomendações de página de visualização: chame Vídeos Semelhantes com o ID do vídeo atual e renderize um carrossel horizontal a partir de items[].
  • Moderação de comentários: busque Comentários de Vídeo; exiba textOriginal, authorDisplayName, likeCount e publishedAt na sua interface de revisão.
  • Curadoria editorial: hidrate cartões com Detalhes do Vídeo (título, publishedAt) e use Vídeos Semelhantes para preencher “Mais como este.”
  • Embeds de newsletter ou blog: pré-busque detalhes e algumas escolhas semelhantes para reduzir mudanças de layout e chamadas no momento do envio.
  • Enriquecimento de análises: armazene nextPageToken e pageInfo para entender a cobertura vs. totalResults para estratégias de amostragem.

Chame a API de agentes de IA via MCP

Você pode invocar esses mesmos endpoints da Zyla a partir de ferramentas de desenvolvedor compatíveis com MCP (Claude Code, Cursor, Windsurf e outros). Aponte seu agente ou cliente para o gateway MCP e passe sua chave de API Zyla.

  • Endpoint MCP: https://mcp.zylalabs.com/mcp
  • Autenticação: inclua sua chave de API; consulte seu cliente MCP sobre como definir cabeçalhos ou parâmetros de consulta.
  • Fluxo típico: defina uma ferramenta que emite um GET para os URLs de Vídeos Semelhantes, Comentários de Vídeo ou Detalhes do Vídeo mostrados acima, com os mesmos parâmetros de consulta e cabeçalho de Autorização.

Leia mais sobre o Protocolo de Contexto do Modelo aqui: MCP.

Orientações operacionais

  • Autenticação: sempre envie Authorization: Bearer SUA_CHAVE_API. Uma conta e uma chave funcionam em todas as suas APIs assinadas na Zyla.
  • Método HTTP: todos os endpoints cobertos aqui são GET. Não envie um corpo; use os parâmetros de consulta exatamente como especificado.
  • Paginando: verifique nextPageToken quando presente; pageInfo.resultsPerPage indica quantos itens você recebeu.
  • Cache: armazene por videoId para detalhes e comentários, e por relatedToVideoId para resultados semelhantes. Invalide conforme seu produto exigir.
  • Tratamento de erros: trate não-2xx como erros recuperáveis ou voltados para o usuário de acordo com seu SLA. Preserve os parâmetros de requisição nos logs para rápida reprodução.
  • Tipos de dados: datas são strings ISO 8601; IDs são strings; contagens como likeCount são numéricas na resposta.

Onde obter sua chave e próximos passos

Crie sua conta em Zyla API Hub, abra a listagem da API de Dados do Youtube e comece o teste para obter sua chave. As chamadas são cobradas em um modelo de assinatura + cota; verifique a listagem para seus limites atuais. Use os trechos de curl e Python acima como suas primeiras requisições.

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

FAQ

Como eu autentico?
Inclua o cabeçalho Authorization: Bearer SUA_CHAVE_API em cada requisição para os endpoints da Zyla mostrados acima.

Posso paginar resultados de Vídeos Semelhantes e Comentários de Vídeo?
Sim. Quando nextPageToken estiver presente na resposta, passe-o de acordo com o esquema de paginação do endpoint. Use pageInfo.totalResults e resultsPerPage para moldar sua interface.

Quais timestamps devo esperar?
Campos como publishedAt e updatedAt são strings UTC ISO 8601. Converta para os fusos horários locais de seus usuários no cliente.

Há um plano gratuito?
Verifique a página da API para opções de acesso e preços atuais. A listagem oferece um teste de 7 dias que você pode iniciar a partir da página do item do marketplace.

Esses endpoints aceitam corpos de requisição?
Não. Os endpoints documentados aqui são apenas GET e usam parâmetros de consulta exatamente como mostrado nos exemplos.

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)\nSubtract, o novo álbum, disponível em 05.05.2023. Pré-venda: https://es.lnk.to/subtract\n \nRetirado 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'. \n \nInscreva-se no canal de Ed Sheeran para todos os melhores e mais recentes videoclipes oficiais, bastidores e apresentações ao vivo.  \nhttp://bit.ly/SubscribeToEdSheeran \n \nVeja mais vídeos oficiais de Ed Sheeran aqui: \nhttps://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz \n\nOuça mais do No. 6 Collaborations Project aqui : \nhttps://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l\n \nSiga Ed Sheeran em: \nInstagram: http://instagram.com/teddysphotos\nTikTok: https://www.tiktok.com/@edsheeran\nFacebook: http://www.facebook.com/EdSheeranMusic\nTwitter: http://twitter.com/edsheeran\nDiscord: http://discord.gg/edsheeran\nSite Oficial: http://edsheeran.com \n\nSobre Ed Sheeran: \nEd Sheeran pode ser a estrela pop quintessencial dos anos 2010: um cantor/compositor internacionalmente aclamado 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. \n\nSeu 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’. \n \nEm 2019, Ed Sheeran lançou o ‘No.6 Collaborations Project’ que abrangeu 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’. \n \n#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…

Pronto para usar o Zyla API HUB?

Experimente agora!

Posts Relacionados

Trabalhando com a API de Dados do Zillow em Tempo Real

Trabalhando com a API de Dados do Zillow em Tempo Real

Sua equipe precisa de um inventário imobiliário ao vivo que você possa filtrar por cidade, limites de mapa ou um polígon...

 API para obter alertas e congestionamentos

API para obter alertas e congestionamentos

Você precisa de dados de tráfego ao vivo que pode enviar esta semana: alertas para acidentes, perigos, polícia, fechamen...

 API para exercício por ID

API para exercício por ID

Você tem um ID de exercício em seu aplicativo esportivo e precisa obter dados concretos de treinamento agora mesmo: movi...

 Trabalhando com a API de Vídeo do Youtube para Áudio

Trabalhando com a API de Vídeo do Youtube para Áudio

Você precisa transformar vídeos específicos do YouTube em áudio para download esta semana—sem truques de navegador, sem...

 API para listar partes do corpo

API para listar partes do corpo

Você precisa de uma API para listar as partes do corpo que seu aplicativo suporta, para que os usuários possam navegar p...

 API para pontuações de qualidade de localização

API para pontuações de qualidade de localização

Você precisa classificar bairros rapidamente—autocompletar endereços, puxar listagens ativas dentro de uma caixa delimit...

Pesquisar

Posts Relacionados

Posts Recentes