API para vídeos por canal

Você precisa responder a uma pergunta concreta esta semana: quantos vídeos um canal tem, ou quais canais dominam um tópico? Ao final deste artigo, você será capaz de calcular programaticamente "vídeos por canal" usando a API de Dados do Youtube no Zyla API Hub, com requisições copiáveis que retornam dados reais que você pode agregar por canal.

O que esta API oferece (e como transformá-la em "vídeos por canal")

A API de Dados do Youtube no Zyla expõe endpoints para:

• Buscar vídeos relacionados a um vídeo semente (cada item inclui o ID do canal e o título).
• Buscar detalhes de um vídeo (incluindo seu ID de canal, título, descrição e outros metadados).
• Buscar os comentários mais recentes de um vídeo (útil para sinais de qualidade ou fluxos de moderação).

“Vídeos por canal” podem ser calculados agrupando os vídeos retornados por snippet.channelId e contando. Dois fluxos comuns que são rápidos sem endpoints de descoberta adicionais:

• Cobertura de tópico baseada em semente: comece a partir de um vídeo conhecido, chame Vídeos Similares e, em seguida, conte quantos vídeos relacionados vêm de cada canal.
• Contagem de lista conhecida: se você já tem uma lista de IDs de vídeo (por exemplo, do seu DB, CSV ou campanha), chame Detalhes do Vídeo para cada um, leia snippet.channelId e agregue contagens por canal.

Este artigo mostra ambos os fluxos com endpoints e campos precisos para que você possa construir a agregação com confiança.

Começando no Zyla API Hub

Abra a página da API para a API de Dados do Youtube no Zyla. Clique em Inscrever-se ou Começar teste de 7 dias, e você receberá uma única chave de API que funciona com esta API e outras no hub. Zyla é um marketplace de mais de 10.000 APIs públicas com uma conta, uma chave e um modelo de assinatura + cota (não pago por chamada). Não há Plano Gratuito; para esta API, você pode começar com um teste de 7 dias diretamente na página de listagem.

• Listagem da API: Comece o teste de 7 dias na API de Dados do Youtube
• Navegue pelo marketplace: https://zylalabs.com

Autenticação: envie sua chave no cabeçalho como Authorization: Bearer YOUR_API_KEY. Todos os exemplos abaixo usam esse cabeçalho.

Endpoint que você usará para contar vídeos por canal

1) Vídeos Similares

Receba uma lista de vídeos relacionados para um determinado ID de vídeo. Cada item inclui snippet.channelId e id.videoId, que são exatamente o que você precisa para calcular as contagens por canal dentro do conjunto relacionado.

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

Copie e cole cURL (exemplo oficial):

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"

Exemplo JSON oficial (truncado na listagem; mantenha os campos mostrados):

{"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

Retirado 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 estrela pop quintessencial da década de 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ê usa deste payload:

• items[].id.videoId: o ID único do vídeo.
• items[].snippet.channelId: o canal que publicou o vídeo.
• pageInfo.resultsPerPage e nextPageToken: úteis para entender o tamanho do resultado e a presença de mais resultados. Se você precisar de mais páginas, consulte a página da API para o uso de paginação.
• snippet.publishedAt: timestamps são ISO 8601 com Z (UTC), o que é simples para ordenação e janelamento.

2) Detalhes do Vídeo

Retorna detalhes para um determinado ID de vídeo. Use isso para resolver o canal e os metadados de um vídeo quando você já tem uma lista de IDs de vídeo para contar.

• Método: GET
• URL: https://zylalabs.com/api/14/youtube-data-api/62/video-details
• Parâmetros obrigatórios:
  • id (string): um ID de vídeo (por exemplo, 7ghhRHRP6t4)

cURL:

Do exemplo de resposta, você usará items[].snippet.channelId junto com o vídeo id.

3) Comentários do Vídeo

Busque comentários recentes para um determinado vídeo. Embora não seja necessário para calcular contagens por canal, este endpoint pode ajudá-lo a priorizar canais por engajamento ou moderar conteúdo relacionado a canais de alto volume que você destaca.

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

cURL:

Calcule “vídeos por canal” com uma única requisição

Quando você não tem um endpoint de descoberta de canal, o caminho mais rápido é começar a partir de um vídeo conhecido que representa seu tópico e contar quantos vídeos relacionados vêm de cada canal. Isso é frequentemente suficiente para:

• Encontrar quais canais dominam um cluster de tópicos.
• Construir “canais principais” sugeridos para uma barra lateral de recomendações.
• Pré-filtrar canais para contatar para uma parceria ou incluir em um feed curado.

Exemplo em Python: contar canais a partir de Vídeos Similares

Este script chama Vídeos Similares, agrupa por snippet.channelId e retorna uma lista ordenada de canais por contagem. Ele usa o endpoint e os parâmetros exatos da listagem do hub.

import os
import requests
from collections import Counter

API_KEY = os.environ.get("ZYLALABS_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, headers=headers, params=params, timeout=30)
resp.raise_for_status()
data = resp.json()

# Agregar vídeos por channelId
channel_counts = Counter()
videos_by_channel = {}

for item in data.get("items", []):
snippet = item.get("snippet", {})
channel_id = snippet.get("channelId")
videos_id = item.get("id", {}).get("videoId")
title = snippet.get("title")
if channel_id and videos_id:
channel_counts[channel_id] += 1
videos_by_channel.setdefault(channel_id, []).append({
"videoId": videos_id,
"title": title
})

# Imprimir canais principais por contagem
for channel_id, count in channel_counts.most_common():
print(f"{channel_id}: {count} vídeos")
# Opcionalmente liste os IDs dos vídeos para construir links ou uma playlist
for v in videos_by_channel[channel_id]:
print(f" - {v['videoId']} :: {v.get('title','')}")

# Nota: os dados podem incluir 'nextPageToken' se mais resultados estiverem disponíveis.
# Consulte a página da API para buscar páginas adicionais quando necessário.

Notas de implementação que economizam tempo:

• As contagens refletem a fatia que você busca. Se você quiser uma cobertura mais ampla, escolha vídeos sementes que representem bem seu tópico e repita a agregação em várias sementes.
• publishedAt é ISO 8601 em UTC. Você pode filtrar para uma janela de tempo antes de contar para focar em atividades recentes.
• Se um nextPageToken estiver presente, há mais resultados disponíveis. Verifique a página da API para o uso exato de paginação para continuar buscando.
• Cache o JSON para cada requisição com chave por parâmetros. Para iteração rápida, persista a resposta bruta e re-execute a agregação localmente sem re-buscar.

Alternativa: contar um conjunto conhecido de IDs de vídeo (usando Detalhes do Vídeo)

Se você já tem uma lista de IDs de vídeo (por exemplo, uploads que você rastreia, links de campanha ou um CSV), chame Detalhes do Vídeo para cada um para resolver seu snippet.channelId e, em seguida, conte por canal. Isso produz uma quebra exata por canal sobre seu conjunto de entrada.

Passos de alto nível:

1. Itere os IDs de vídeo em sua lista.
2. Para cada um, GET https://zylalabs.com/api/14/youtube-data-api/62/video-details?id=VIDEO_ID.
3. Leia items[0].snippet.channelId e incremente um contador.

Dica: Armazene um pequeno mapa local de {videoId: channelId} para evitar re-chamar a API para o mesmo item durante o desenvolvimento.

Use sinais de engajamento ao classificar canais

Uma vez que você tenha contagens por canal, pode querer classificar além do volume puro. Uma abordagem leve é puxar comentários recentes para um vídeo representativo dos principais canais e usar likeCount, publishedAt ou comprimento do texto para gerar heurísticas simples (por exemplo, “canais com comentários recentes de alta curtida recebem um leve impulso”). O endpoint de Comentários do Vídeo retorna:

• textOriginal e authorDisplayName: para NLP simples e atribuições.
• likeCount, publishedAt: para pontuação rápida e janelas de recência.

Chamando de agentes de IA via MCP

Se você orquestra a partir de um agente IDE (Claude Code, Cursor, Windsurf ou qualquer cliente compatível com MCP), use o endpoint MCP da Zyla. Forneça sua chave de API e deixe o agente invocar os endpoints do hub diretamente do seu editor. Veja o ponto de entrada do MCP aqui: MCP. O mesmo cabeçalho de Autorização se aplica nos bastidores, e cada chamada de ferramenta mapeia para o endpoint correspondente da API Zyla. Se você precisar de uma chave de conta, crie uma em Zyla API Hub e, em seguida, aponte seu agente para o endpoint MCP com sua chave.

Dicas operacionais

• Auth: Sempre inclua Authorization: Bearer YOUR_API_KEY.
• Quotas e faturamento: Zyla usa assinatura + cota (não pago por chamada). Para esta API, você pode iniciar um teste de 7 dias a partir da listagem. Verifique a página da API para opções de acesso e preços atuais.
• Timestamps: Campos como publishedAt são ISO 8601 UTC (Z). Normalize para UTC em seu datastore.
• Paginação: Se a resposta incluir nextPageToken, existem mais resultados. Consulte a página da API para continuar a paginação conforme necessário; persista seu último token ao construir trabalhos em lote.
• Deduplicação: Use id.videoId como a chave canônica para deduplicar ao agregar em vários vídeos sementes.
• Respostas parciais: Confie apenas nos campos mostrados nos exemplos ou especificados na documentação da API. Lide defensivamente com campos ausentes em seu código.

Exemplo de fluxo de trabalho de ponta a ponta

Objetivo: produzir uma tabela de classificação de canais para um determinado tópico sem um endpoint dedicado de listagem de canais.

1. Escolha 3–5 vídeos sementes representativos para o tópico (por exemplo, um por subtópico).
2. Para cada semente, chame Vídeos Similares com part=id,snippet e type=video. Mantenha maxResults em 50 para amplitude. Cache arquivos JSON brutos.
3. Combine todos os itens, agrupe por snippet.channelId e conte.
4. Opcionalmente, para os N canais principais, amostre 1–2 vídeos e chame Comentários do Vídeo para coletar dicas rápidas de engajamento.
5. Renderize: ID do canal e contagem de vídeos; opcionalmente liste alguns vídeos representativos por canal.

Por que isso funciona rapidamente para “vídeos por canal”

Você está trabalhando com IDs de canal retornados diretamente de cada snippet de vídeo. Contá-los é simples e evita descobertas em múltiplas etapas. Se seu produto realmente precisa do total de uploads públicos por canal (ou seja, tamanho total do catálogo), use uma cobertura de semente mais ampla e repita a busca de Vídeos Similares em vários âncoras conhecidas; então persista e dedupe ao longo do tempo. Para muitos casos de uso (curadoria, recomendações, divulgação), o volume relativo dentro de um cluster temático é o que você deseja, e essa abordagem o entrega com uma requisição e uma pequena agregação.

Referência: detalhes do endpoint em um só lugar

Vídeos Similares

• GET https://zylalabs.com/api/14/youtube-data-api/56/similar-videos
• Parâmetros:
  • relatedToVideoId (obrigatório): 7ghhRHRP6t4
  • part (obrigatório): id,snippet
  • type (obrigatório): video
  • maxResults (opcional): 50

Detalhes do Vídeo

• GET https://zylalabs.com/api/14/youtube-data-api/62/video-details
• Parâmetros:
  • id (obrigatório): 7ghhRHRP6t4

Comentários do Vídeo

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

FAQ

Como faço para autenticar?
Envie sua chave no cabeçalho: Authorization: Bearer YOUR_API_KEY.

Posso buscar mais de 50 vídeos relacionados?
A resposta mostra nextPageToken quando mais resultados existem. Verifique a página da API para como continuar a paginação além da primeira página.

Quais campos identificam o canal e o vídeo?
Use items[].id.videoId para a identidade do vídeo e items[].snippet.channelId para o canal.

Há um plano gratuito?
Não há Plano Gratuito. Você pode iniciar um teste de 7 dias a partir da listagem da API. Verifique a página da API para opções de acesso e preços atuais.

Posso chamar isso de um agente de IA?
Sim. Use o endpoint MCP da Zyla com sua chave de API para permitir que clientes compatíveis com MCP chamem os mesmos endpoints.

Pronto para enviar sua agregação de “vídeos por canal”? Comece seu teste de 7 dias e obtenha sua chave de API na listagem: API de Dados do Youtube no Zyla. Uma chave funciona em todo o hub, para que você possa expandir sua integração à medida que avança.

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

Retirado 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 estrela pop quintessencial da década de 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":{"…