FlowData

Como consultar as estatísticas de um canal do YouTube?

Publicado em 10. novembro 2026

A área YouTube retorna os indicadores públicos de um canal do YouTube: inscritos, número de vídeos e total de visualizações, além de título, descrição e imagem. Isso serve, por exemplo, para um painel dos seus próprios canais, para relatórios a clientes ou para avaliar criadores para uma parceria.

A requisição

A consulta é um GET para https://api.flowdata.one/v1/youtube/stats/ com o identificador do canal no final:

curl "https://api.flowdata.one/v1/youtube/stats/@YouTube" \
  -H "Authorization: Bearer fd_SUA_CHAVE"

Duas formas de identificador funcionam:

  • Handle, com ou sem @, por exemplo @YouTube ou YouTube.
  • ID do canal, que começa com UC e tem 24 caracteres, por exemplo UC7hD4tWk2nQmL9xRb3sYp0E.

O ID do canal é único e, portanto, a escolha mais segura. Onde encontrá-lo está em O YouTube informa 'canal não encontrado' ou retorna outro canal: o que fazer?.

A resposta

{
  "success": true,
  "cached": true,
  "data": {
    "id": 412,
    "channel_id": "UC7hD4tWk2nQmL9xRb3sYp0E",
    "handle": "@example-channel",
    "title": "Example Channel",
    "description": "Tutorials about data quality and automation for small online stores.",
    "subscriber_count": 4820,
    "video_count": 137,
    "view_count": 612904,
    "thumbnail_url": "https://yt3.example.com/example-channel-avatar.jpg",
    "last_synced_at": "2026-11-05T08:14:22.000000Z",
    "created_at": "2026-10-12T09:03:51.000000Z",
    "updated_at": "2026-11-05T08:14:22.000000Z"
  }
}

O canal do exemplo é fictício. Como ler os campos em data:

  • channel_id: o ID único do canal.
  • handle: o handle do canal, como o YouTube o informa.
  • title, description: nome e descrição do canal.
  • subscriber_count: número de inscritos.
  • video_count: número de vídeos públicos.
  • view_count: visualizações de todos os vídeos somadas.
  • thumbnail_url: endereço da imagem do canal.
  • last_synced_at: quando os números foram consultados no YouTube pela última vez.
  • id, created_at, updated_at: dados internos do registro salvo, que você pode ignorar.

Quão atuais são os números?

O FlowData guarda os números de cada canal depois da consulta. Se você consultar o mesmo canal de novo em até 24 horas, recebe os números guardados e cached fica true. Se os números guardados tiverem mais de 24 horas ou o FlowData ainda não conhecer o canal, eles são buscados novamente no YouTube e cached fica false.

Portanto, os números podem ter até um dia de idade, e last_synced_at mostra o momento exato. Para relatórios diários, uma consulta por canal e por dia é suficiente.

A primeira consulta de um canal novo demora bem mais do que uma guardada, então defina um tempo limite generoso na sua requisição.

Por que subscriber_count é 0?

Os donos de canais podem ocultar o número de inscritos no YouTube. Nesse caso o YouTube não fornece o número e o FlowData informa 0. Em canais pequenos ou novos, 0 também pode estar certo.

Existem estatísticas de vídeos individuais?

Não. A área YouTube retorna apenas os indicadores de canais inteiros. Visualizações, curtidas ou comentários de vídeos individuais não estão disponíveis por ela.

Quanto custa uma consulta?

As consultas são cobradas a cada 1.000 requisições bem-sucedidas, mesmo que a resposta venha do armazenamento com cached: true. Um 404 para um canal não encontrado e os erros de servidor são gratuitos. Os valores estão na página de preços, e os preços válidos para sua equipe ficam no painel, em Cobrança. Se o saldo não for suficiente, a API responde com HTTP 402. Saiba mais em Entender os preços do FlowData.

Bom saber

  • Cada consulta aparece no Registro em Áreas › YouTube. As consultas com falha aparecem ali com status 404 ou 500.
  • Codifique o identificador para a URL se ele tiver caracteres especiais. O @ pode ser escrito como %40.
  • A referência completa está na documentação da API.

Este artigo foi útil?

Voltar para YouTube