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@YouTubeouYouTube. - ID do canal, que começa com
UCe tem 24 caracteres, por exemploUC7hD4tWk2nQmL9xRb3sYp0E.
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.