Como obter a transcrição de um vídeo do YouTube

Resposta curta: se o vídeo tiver legendas, o YouTube pode mostrar a transcrição abaixo da descrição (clique em ...more e depois em Show transcript). Para obter um arquivo ou para muitos vídeos, use o yt-dlp ou a biblioteca Python youtube-transcript-api na sua própria máquina, ou uma única requisição a uma API hospedada, como a do Transcript Dock, quando você roda na nuvem ou também precisa de TikTok. Vídeos sem legendas precisam de transcrição por IA do áudio.

Qual caminho escolher#

1. No YouTube#

1. Abra o vídeo em um computador.
2. Clique em ...more abaixo do título para expandir a descrição.
3. Role até o final da descrição e clique em Show transcript.
4. A transcrição abre ao lado do vídeo. Use o menu no topo dela para ocultar os horários, depois selecione e copie.

O botão só aparece quando o vídeo tem legendas, enviadas pelo criador ou geradas pelo YouTube. Serve para um vídeo; copiar à mão perde os horários e não escala.

2. Com o yt-dlp#

O yt-dlp é uma ferramenta de linha de comando gratuita. O comando abaixo salva as legendas em inglês como um arquivo SRT, sem baixar o vídeo:

yt-dlp --skip-download --write-subs --write-auto-subs --sub-langs en --convert-subs srt \
  "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

--write-auto-subs inclui as legendas automáticas do YouTube quando o criador não enviou nenhuma. Funciona bem de uma conexão doméstica; em um servidor, o YouTube costuma pedir login.

3. Em Python#

A biblioteca de código aberto youtube-transcript-api lê as mesmas legendas, sem chave de API:

# pip install youtube-transcript-api
from youtube_transcript_api import YouTubeTranscriptApi
 
transcript = YouTubeTranscriptApi().fetch("dQw4w9WgXcQ", languages=["en"])
for snippet in transcript:
    print(round(snippet.start, 1), snippet.text)

O README dela alerta que o YouTube bloqueia a maioria dos endereços IP de provedores de nuvem, então, na AWS, no Google Cloud ou em uma VPS, ela precisa de um proxy residencial rotativo. Veja Transcript Dock versus youtube-transcript-api.

4. Com a API do Transcript Dock#

São três requisições: envie o link, aguarde e exporte. Funciona em qualquer lugar (sem proxy para gerenciar), devolve segmentos com tempo, exporta TXT, SRT, VTT ou JSON e funciona do mesmo jeito para TikTok. Uma transcrição de legendas custa 1 crédito, e toda conta recebe 50 créditos grátis por mês.

# 1. submit the link (1 credit)
curl -X POST https://www.transcriptdock.com/v1/jobs \
  -H "Authorization: Bearer td_live_YOUR_KEY" \
  -H "Idempotency-Key: yt-dQw4w9WgXcQ" \
  -H "Content-Type: application/json" \
  -d '{ "source": { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }, "mode": "captions_only" }'
 
# 2. wait for it (returns as soon as the job finishes)
curl "https://www.transcriptdock.com/v1/jobs/JOB_ID?wait=25" -H "Authorization: Bearer td_live_YOUR_KEY"
 
# 3. export the transcript (free)
curl "https://www.transcriptdock.com/v1/transcripts/RESULT_ID/export?format=txt" -H "Authorization: Bearer td_live_YOUR_KEY"

O passo a passo completo está no guia de início rápido. Para um canal inteiro, uma playlist ou uma busca, primeiro liste os vídeos com a descoberta de vídeos e depois envie-os como um lote.

5. Pergunte ao Claude ou ao Cursor#

Adicione o Transcript Dock como conector e faça a pergunta em linguagem simples, por exemplo “O que este vídeo diz?”, com o link. O Claude busca a transcrição e responde com base nela. A configuração leva um minuto: Claude, Claude Code, Cursor.

Quando um vídeo não tem legendas#

Todos os métodos acima leem legendas que já existem. Quando não há nenhuma, o áudio precisa ser transcrito. No Transcript Dock, envie mode: "auto": ele usa as legendas quando existem e a transcrição por IA caso contrário, a 2 créditos por minuto iniciado nos planos pagos. O resultado inclui tempos por palavra.

Perguntas frequentes#

• É permitido? Ler legendas para pesquisa própria, acessibilidade ou análise é prática comum; republicar as palavras de outra pessoa é uma questão de direitos autorais. Confira os termos do YouTube para o seu caso.
• Outros idiomas? Envie caption_languages, como ["es", "en"], para dar preferência a uma faixa. Liste as faixas de um vídeo com a descoberta de idiomas.
• Shorts? Sim. Links de Shorts, de watch e de youtu.be funcionam todos.