API de transcrição do YouTube em Python: início em 5 minutos

Uma requisição, uma transcrição

O caminho mais curto é um GET para /v1/transcripts/{videoId} com sua chave no cabeçalho Authorization. A resposta é JSON: id do vídeo, idioma, duração e lista de segmentos. Não precisa de SDK — requests ou httpx basta.

Escolher idioma e formato

Chame primeiro /v1/transcripts/{videoId}/languages se o vídeo puder ser multilíngue, escolha a faixa e passe ?lang= e ?format=. Pedir srt ou vtt devolve legendas prontas para salvar; json mantém os segmentos estruturados.

Lotes e tentativas

Para listas, envie até 50 ids para /v1/transcripts em uma chamada e leia os resultados por item. Adicione timeout e um pequeno backoff exponencial: falhas transitórias e 429 passam rápido, e cada resposta traz um X-Request-ID para registrar.

Tratar os casos difíceis

Alguns vídeos não têm legendas, outros são privados ou bloqueados por região. A API responde com código tipado e mensagem legível, então seu código ramifica pelo código, não pela prosa. Registre o request id: é o caminho mais rápido para a correção.