2outube
Para desenvolvedores e criadores de agentes

Por que a sua chamada à API de transcrição do YouTube está falhando.

Se um script no lado do servidor — o youtube-transcript-api, um scraper, a sua própria chamada ao endpoint timedtext do YouTube — está retornando resultados vazios ou bloqueados, não é um bug no seu código. O YouTube bloqueia requisições de transcrição vindas de faixas de IP de nuvem e datacenter, incluindo AWS, GCP, Azure e Cloudflare Workers.

Transcrição completa em segundos — pesquisável, com marcações de tempo e sua para guardar.

Esse bloqueio é baseado em IP, não em conta: a mesma requisição exata que funciona a partir de uma conexão residencial não retorna nada (ou retorna 429/403) a partir de um servidor. É por isso que bibliotecas da comunidade que fazem scraping direto dos endpoints de legendas do YouTube ficaram cada vez menos confiáveis quando rodadas na nuvem.

O 2outube contorna isso pagando por um provedor gerenciado com uma frota de proxies residenciais, de modo que a requisição parece um navegador comum em vez de um datacenter. Isso é um detalhe interno de implementação — veja a nota honesta abaixo para o que isso significa (e não significa) para você.

O que o 2outube realmente é (e o que não é)

É uma ferramenta de navegador, não uma API para desenvolvedores. Não há endpoint público, não há chave de API e não há compromisso de disponibilidade hoje. Se o seu caso de uso é acesso programático a transcrições, você precisa do seu próprio provedor gerenciado com suporte a proxies residenciais (pago) — rodar o youtube-transcript-api ou um scraper puro a partir de um servidor de nuvem vai continuar falhando pelo motivo de bloqueio de IP acima, não porque o seu código está errado.

Perguntas, respondidas.

Por que o youtube-transcript-api (ou o meu próprio scraper) não retorna nada quando eu rodo em um servidor?

O YouTube bloqueia requisições de legendas/transcrição que se originam de faixas de IP de datacenter e de nuvem. O mesmo código muitas vezes funciona bem a partir de uma conexão de internet doméstica, e é por isso que parece um bug intermitente em vez do que realmente é: um bloqueio baseado em IP.

O 2outube tem uma API pública que eu possa chamar?

Hoje não. O 2outube é uma ferramenta web — cole uma URL, obtenha uma transcrição no navegador. Não há endpoint documentado, não há chave de API e não há disponibilidade garantida para uso programático.

O que devo usar em vez de fazer scraping direto do YouTube?

Um provedor de transcrição gerenciado que roda as requisições por proxies residenciais (pago) — a mesma categoria de serviço em que o próprio 2outube se apoia internamente.

Existe uma alternativa gratuita que seja confiável?

Nenhuma rodando a partir de um servidor de nuvem. O bloqueio baseado em IP é exatamente o que torna as abordagens de scraping gratuito inconsistentes — elas podem funcionar hoje e falhar amanhã conforme o YouTube ajusta.

O 2outube vai adicionar uma API pública?

Sem planos firmes a anunciar. Se isso mudar, vai aparecer em 2outube.com/llms.txt, que lista o que realmente existe hoje.