Loading...
Loading...
Conecte-se à API externa autenticada ou use o transporte MCP para agentes e desenvolvedores com base no contrato de análise do YouTube.
Experimente um endpoint ativo. Substitua channel_id e YOUR_API_KEY pelos seus valores:
curl -X GET "https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<channel_id>&range=28d" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Accept: application/json"JavaScript
const res = await fetch("https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<id>&range=28d", {
headers: { Authorization: "Bearer <api_key>" }
});
const data = await res.json();Python
import httpx
res = httpx.get(
f"{apiBase}/analytics",
params={"channel_id": "<id>", "range": "28d"},
headers={"Authorization": "Bearer <api_key>"}
)
data = res.json()Crie e revogue chaves de API em Painel → Configurações → Chaves de API ou por meio das rotas autenticadas GET /api/v1/keys e POST /api/v1/keys.
Professional+ planChame a API externa em https://www.tubeanalytics.net/api/external/v1 com um token de portador no cabeçalho de autorização.
JSON responsesConecte agentes a https://www.tubeanalytics.net/api/mcp ou execute npm run mcp:stdio localmente para um transporte stdio.
Agent readyUse /openapi.json, /mcp.json e /ai.txt como fonte de verdade legível por máquina para integrações e agentes.
Machine-readableFaça login, conclua o fluxo de inscrição e conecte um canal no painel. A rota de gerenciamento autenticado é GET /api/v1/channels/connect para a conta atual e POST /api/v1/channels/connect para conectar ou atualizar um canal.
Vá para Dashboard → Configurações → Chaves de API e crie uma chave ou use a rota POST /api/v1/keys autenticada. As chaves de API estão disponíveis nos planos Professional e Enterprise.
Use a chave do portador em https://www.tubeanalytics.net/api/external/v1. Exemplo: GET /analytics?channel_id=<id>&range=28d ou GET /videos?channel_id=<id>&limit=20.
Para clientes MCP, aponte para https://www.tubeanalytics.net/api/mcp por HTTP ou execute npm run mcp:stdio para transporte stdio local.
/api/external/v1/channels/api/external/v1/channels/:channelId/api/external/v1/analytics?channel_id=.../api/external/v1/videos?channel_id=.../api/external/v1/audience?channel_id=.../api/external/v1/competitors/api/v1/keys/api/mcpAs solicitações de API externas devem incluir uma chave de API válida no cabeçalho de autorização usando o esquema de token do portador. Mantenha a chave no lado do servidor e nunca a exponha no código do lado do cliente ou envie-a para o controle de versão.
Para gerar ou alternar uma chave de API, vá para Painel → Configurações → Chaves de API. Você também pode gerenciar chaves de uma sessão autenticada com GET /api/v1/keys, POST /api/v1/keys e DELETE /api/v1/keys/:keyId.
Starter
1 channel · Creators validating one channel before spending more.
Professional
3 channels · Creators and small teams growing more than one channel.
Enterprise
Unlimited channels · Agencies and multi-channel teams with reporting overhead.
curl -X GET https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<channel_id>&range=28d \
-H "Authorization: Bearer YOUR_API_KEY"Exemplo de solicitação de API externa. channel_id pode ser o ID interno do banco de dados ou o ID do canal do YouTube.
O acesso externo à API está disponível nos planos Professional e Enterprise. As solicitações têm taxa limitada por nível do plano e retornam 429 com cabeçalhos de limite de taxa quando você ultrapassa o limite.
Cabeçalhos de resposta com limite de taxa
Cada resposta da API externa inclui estes cabeçalhos para que os clientes possam gerenciar a retirada de forma proativa:
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-ResetRetry-AfterSolicitações externas autenticadas usam o fluxo de chave da API Bearer. Rotas de gerenciamento somente de sessão, como /api/v1/keys e /api/v1/channels/connect, são para a sessão de painel conectada, não para chamadas de chave de API de servidor para servidor.
A API externa retorna erros JSON estruturados com error.code e error.message. As rotas do painel conectado ainda podem retornar uma string de erro simples, portanto, verifique a rota ou a especificação OpenAPI para obter o formato exato.
Exemplo de resposta de erro
{
"error": {
"code": "BAD_REQUEST",
"message": "channel_id query parameter is required"
}
}400401403404429500A maioria dos endpoints externos da API aceita parâmetros de consulta comuns para filtragem, paginação e classificação.
channel_idrangelimitoffsetsortColoque métricas de canal em suas próprias ferramentas: incorpore gráficos em portais internos, relatórios de clientes ou plataformas de BI como Metabase ou Grafana.
Agende sincronizações noturnas no Planilhas Google, Notion ou em seu warehouse chamando a API externa de seu back-end ou trabalhador de automação.
Use o transporte MCP ou o transporte stdio local para fornecer aos agentes acesso ao mesmo contrato de produto, análises e dados de conta.
Combine dados de API com anúncios, CRM ou sistemas financeiros para manter o desempenho do canal alinhado com o restante da sua pilha.
Use estas páginas para passar da descoberta de endpoints para a integração de produção e implantação de fluxo de trabalho.
Documentos centrais do desenvolvedor: arquivos de autenticação, endpoints, MCP e descoberta.
Guia de início rápido para primeira chamada de API, configuração de autenticação e lista de verificação de implementação.
Cargas de eventos e comportamento de repetição para eventos de assinatura e dados.
Limites de solicitação com reconhecimento de plano e estratégia de repetição para integrações estáveis.
Referência de implementação específica de integração e escopo de sincronização de dados.
O acesso à API está disponível nos planos Professional e Enterprise. Cadastre-se, conecte um canal, crie uma chave de API e comece a chamar a API externa ou o transporte MCP.