Chave de API do YouTube: como obter e o que a cota diária paga
Uma chave de API do YouTube leva quatro passos no console do Google Cloud: criar um projeto, ativar a YouTube Data API v3, abrir Credentials e criar a chave. Ela só lê dados públicos. Subir um vídeo, ler as suas próprias analytics ou responder a um comentário exige OAuth 2.0, e quem limita de verdade é a cota diária.
Tudo o que vem abaixo foi lido na documentação da YouTube Data API em 10 de novembro de 2026.
Como obter uma chave de API do YouTube
Você precisa de uma conta Google. Abrir o console é grátis; a YouTube Data API em si não tem preço por chamada, só cota.
- Abra o console do Google Cloud e crie um projeto, ou selecione um que você já tenha.
- Abra a API Library e ative a YouTube Data API v3. Se ela não estiver ativada, toda requisição responde 403 independentemente das suas credenciais.
- Abra a página Credentials.
- Selecione Create credentials > API key. A chave aparece na hora.
- Selecione Restrict key antes de colocar qualquer coisa no ar.
As palavras do próprio Google sobre esse último ponto: «Restrict the key before using it in production.» Duas restrições importam. Uma restrição de API limita a chave à YouTube Data API, então uma chave vazada não pode ser gasta em outros serviços do Google. Uma restrição de aplicação a limita aos IPs do seu servidor, aos seus referenciadores HTTP ou à assinatura do seu app.
A chave vai na requisição como parâmetro de URL:
curl "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics&id=VIDEO_ID&key=YOUR_API_KEY"
O que significa que ela viaja em URLs, em logs de servidor e no histórico do navegador. Trate-a como pública assim que estiver em código do lado do cliente, e deixe tudo que custa cota de verdade atrás do seu próprio backend.
Chave de API ou OAuth: as credenciais do YouTube que você realmente precisa
É aqui que a maioria perde uma tarde. A chave não é um login. Ela identifica o seu projeto para cobrança e cota, não um usuário.
O Google enuncia a regra com clareza: «Use an API key for requests that only retrieve public data, such as public video metadata or search results.» Para todo o resto, a sua aplicação «must use the OAuth 2.0 protocol».
| O que você quer fazer | Método | Credencial |
|---|---|---|
| Ler as visualizações e o título de um vídeo público | videos.list |
Chave de API |
| Buscar vídeos públicos | search.list |
Chave de API |
| Ler o número de inscritos de um canal público | channels.list |
Chave de API |
| Subir um vídeo | videos.insert |
OAuth 2.0 |
| Atualizar ou excluir o seu próprio vídeo | videos.update, videos.delete |
OAuth 2.0 |
| Responder a um comentário | comments.insert |
OAuth 2.0 |
| Definir uma miniatura | thumbnails.set |
OAuth 2.0 |
Ler o seu próprio canal com mine=true |
channels.list |
OAuth 2.0 |
Ou seja: se você procurou uma chave de API do YouTube porque quer um bot que suba os seus vídeos, a chave não é o que você precisa. Você precisa de um ID de cliente OAuth, de uma tela de consentimento, de um refresh token e, assim que passar dos usuários de teste, da revisão de verificação do Google. O ID de cliente é criado na mesma página Credentials: Create credentials > OAuth client ID, e então escolha o tipo de aplicação.
A metade desse trabalho que são os tokens é igual em toda rede, e é a parte que continua quebrando meses depois. Os access tokens das redes sociais cobre o refresh, a expiração e as desconexões silenciosas em cada plataforma.
O que a cota diária paga
O YouTube não conta chamadas, conta unidades. A documentação descreve a alocação padrão em três pools:
- 100 chamadas a
search.listpor dia. - 100 chamadas a
videos.insertpor dia. - 10 000 unidades por dia para todos os outros endpoints.
Os custos em unidades que importam, direto da tabela de cota:
| Método | Custo em unidades | O que faz |
|---|---|---|
videos.list |
1 | Ler metadados e estatísticas de um vídeo |
channels.list |
1 | Ler dados do canal |
playlists.list |
1 | Ler playlists |
commentThreads.list |
1 | Ler comentários de primeiro nível |
comments.list |
1 | Ler respostas |
playlistItems.insert |
50 | Adicionar um vídeo a uma playlist |
comments.insert |
50 | Publicar um comentário ou uma resposta |
thumbnails.set |
50 | Definir uma miniatura personalizada |
captions.insert |
400 | Enviar uma faixa de legendas |
Leituras são baratas, escritas não. Subir uma legenda custa 400 unidades, então 25 delas esgotam o pool principal sozinhas. E toda requisição conta, inclusive as que falham: uma requisição inválida custa pelo menos uma unidade, então um loop de retry contra um parâmetro errado queima cota tão rápido quanto trabalho de verdade.
Os números de cota que surpreendem
Três coisas pegam os times de surpresa.
A busca tem o próprio pool, e ele é pequeno. Cem chamadas a search.list por dia não é nada para uma função de busca. Se você está construindo busca em cima do YouTube, guarda os resultados em cache ou pede mais cota pelo formulário de extensão. Paginar custa uma chamada por página, então um usuário que rola quatro páginas gasta quatro das suas cem.
Os uploads são limitados por quantidade, não por unidades. Cem chamadas a videos.insert por dia parece generoso até você operar vários canais. O limite é por projeto, não por canal, então dez canais dividem as mesmas cem.
A cota zera no horário do Pacífico, não no seu. O contador diário vira à meia-noite do Pacífico. Se o seu scheduler dispara à meia-noite em São Paulo, você está gastando a cota do dia anterior.
Quando você precisa de mais, a página Quotas do console mostra o consumo e o Google oferece um formulário de extensão de cota. Conte com descrever o seu caso de uso e com esperar. A documentação ainda avisa que a alocação padrão está «subject to change», motivo suficiente para registrar o seu gasto em unidades em vez de supor que os números de hoje valem para sempre.
Publicar no YouTube e em outras sete redes
Se o YouTube é a única plataforma que você toca, construa por conta própria: um cliente OAuth, um refresh token, pronto. A conta muda quando o YouTube é uma rede entre várias, porque cada plataforma traz o próprio fluxo OAuth, a própria revisão e o próprio modelo de cota. O guia das APIs de redes sociais coloca essas diferenças lado a lado, e a API de analytics de redes sociais explica por que a mesma métrica aparece diferente em cada rede.
É essa a lacuna que o PlugKit preenche. Ele conecta Instagram, Facebook, LinkedIn, TikTok, YouTube, X, WhatsApp e Telegram atrás de uma única API REST e de um único servidor MCP hospedado em https://api.plugkit.co/mcp, cuida do OAuth e do refresh dos tokens, e custa US$ 49 por mês para 5 contas conectadas, cancela quando quiser. Sete dias grátis, com cartão no cadastro e nada cobrado antes do 7º dia.
Isso não elimina a cota do YouTube, e nada elimina: a cota pertence a quem é dono do projeto de API. O que isso elimina é o trabalho de credenciais por plataforma. Se tudo o que você precisava eram os metadados públicos dos vídeos, uma chave de API simples e 30 linhas de código continuam sendo a resposta certa, e é essa que você deve escolher.
Perguntas frequentes
A chave de API do YouTube é grátis?
Sim. A YouTube Data API não tem preço por chamada. O que você tem no lugar é uma cota diária, por padrão 10 000 unidades para os endpoints gerais mais pools separados de 100 chamadas de busca e 100 uploads. Passar disso significa pedir uma extensão, não pagar uma fatura.
Dá para subir um vídeo só com uma chave de API do YouTube?
Não. Os uploads passam por videos.insert, e o Google exige OAuth 2.0 para cada inserção, atualização e exclusão. A chave de API identifica o seu projeto, ela não autoriza uma ação em um canal. Você precisa de um ID de cliente OAuth, do consentimento do usuário e de um refresh token.
Como conseguir uma chave de API do YouTube de graça?
Crie um projeto no Google Cloud, ative a YouTube Data API v3 na API Library, abra Credentials e escolha Create credentials, depois API key. Não é pedido cartão para a cota da Data API. Restrinja a chave à YouTube Data API antes de colocá-la em produção.
O que acontece quando eu bato na cota da API do YouTube?
As requisições respondem 403 com o motivo quotaExceeded até o contador zerar à meia-noite do Pacífico. Nada é cobrado e nada é freado aos poucos: você simplesmente para até o reset, e é por isso que agrupar leituras e guardar buscas em cache importa mais do que otimizar chamadas isoladas.
Qual é a diferença entre uma chave de API do YouTube e credenciais OAuth?
Uma chave identifica o seu projeto e só lê dados públicos. As credenciais OAuth identificam um usuário que deu acesso ao seu app, e é isso que permite publicar, editar, comentar ou ler dados privados do canal. Muitos projetos precisam dos dois: a chave para leituras públicas e OAuth para tudo que toca o canal do usuário.
Um plug para cada plataforma que seu agente usa
$49 por mês para 5 contas conectadas, cancele quando quiser. Todos os recursos em todos os planos.
Pegue sua chave de API →