TubeAnalytics

Acesso à API para integrações em nível de produto

Entenda as capacidades da API e os pontos de integração na arquitetura mais ampla do produto.

Explore páginas relacionadas

O que a API do TubeAnalytics oferece

A API pública do TubeAnalytics expõe métricas de canais, dados de desempenho de vídeos e benchmarks de concorrentes por meio de uma interface REST padrão autenticada com chaves de API. Os desenvolvedores a utilizam para puxar dados analíticos do YouTube para dashboards personalizados, ferramentas de BI, automações do Google Sheets ou pipelines internos de relatórios — sem precisar construir uma integração direta com a API do YouTube.

A API espelha os mesmos dados disponíveis no dashboard do TubeAnalytics — RPM, CPM, visualizações, tempo de exibição, mudanças de inscritos, fontes de tráfego e dados demográficos do público — em um formato legível por máquina, com paginação consistente e esquemas de resposta previsíveis. Todos os endpoints retornam JSON e suportam parâmetros de intervalo para consultas históricas.

Autenticação e limites de taxa

As chaves de API são emitidas no nível da organização e transmitidas por meio do cabeçalho Authorization como um token Bearer. As chaves podem ser criadas, rotacionadas e revogadas no painel de configurações do desenvolvedor, sem afetar as credenciais do canal do YouTube conectado ou outros usuários no espaço de trabalho.

Se você está nos planos Pro ou Enterprise, pode ir direto para Dashboard > Configurações > Chaves de API para criar e gerenciar chaves. A aba de chaves de API fica oculta para contas Starter, e a interface mostrará um aviso de upgrade no lugar.

O acesso à API atualmente acompanha o plano Enterprise. As cotas mensais de chamadas à API escalam conforme o contrato do plano, e a superfície pública de preços agora exibe esses limites de uso junto aos níveis de assinatura. A API retorna respostas padrão 429 com cabeçalhos Retry-After quando um limite é atingido.

• API REST com respostas JSON e códigos de erro consistentes
• Autenticação por token Bearer via chave de API
• Endpoints para métricas de canal, estatísticas de vídeo, fontes de tráfego e dados demográficos
• Consultas históricas por intervalo com janelas de datas configuráveis
• Endpoints em massa de canais no nível Enterprise
• Descoberta legível por máquina via /openapi.json e /mcp.json

Casos de uso comuns de integração com a API

Agências frequentemente usam a API para alimentar dashboards do Looker Studio ou Tableau voltados ao cliente com dados de desempenho de canais. Ao puxar dados diariamente ou sob demanda por meio da API, elas mantêm uma fonte única de verdade sem exportar relatórios manualmente para cada conta de cliente.

Equipes de produto incorporam a API em ferramentas internas que exibem o desempenho no YouTube junto a outras métricas de negócio — combinando tendências de RPM do canal com dados de investimento em anúncios ou vinculando cronogramas de lançamento de vídeos a curvas de crescimento de público. O esquema consistente da API torna essas junções diretas, independentemente da plataforma de BI subjacente.

Descoberta legível por máquina

Os arquivos públicos de descoberta estão disponíveis em /openapi.json, /mcp.json, /ai-pricing.json, /agents.txt e /ai.txt. Esses endpoints facilitam a indexação da superfície da API por agentes, a validação com ferramentas e a reutilização em geradores de documentação, sem a necessidade de extrair dados das páginas voltadas a humanos.

• OpenAPI para contratos de endpoints e formatos de solicitação/resposta
• MCP para descoberta por agentes e metadados do produto
• Preços de IA para níveis de assinatura e pontos de entrada de checkout
• agents.txt para o índice de descoberta
• ai.txt para orientação de rastreadores e recuperação