YouTube Transcripts in n8n: HTTP Request Workflow Guide

How to fetch YouTube transcripts inside an n8n workflow using the HTTP Request node - a downloadable workflow JSON, batch processing multiple videos, handling rate limits, and feeding results into an AI summarizer.

00:09:00 · SEP 13, 2026

Resposta rápida

Importe o workflow abaixo, defina sua chave de API como uma variável de ambiente, e o nó nativo HTTP Request busca a transcrição - sem necessidade de instalar um nó personalizado do n8n. Para lotes de vídeos, controle o ritmo das requisições usando as opções de Batching ou retentativa do nó para ficar dentro do limite de requisições por minuto do seu plano.

Baixe o workflow

Importe isto diretamente pela opção Import from File do n8n (ou cole em Import from URL):

Baixar workflow (.json)

Configure sua chave de API

Obtenha uma chave no painel (100 créditos grátis, sem cartão necessário), depois defina-a como uma variável de ambiente disponível para sua instância do n8n:

GETYOUTUBETRANSCRIPT_API_KEY=sk_live_...

Blog.Posts.n8nYoutubeTranscriptWorkflow.step2.body2

Como o nó de requisição é configurado

O nó HTTP Request chama o endpoint de transcrição com o ID do vídeo como parâmetro de consulta:

GET https://getyoutubetranscript.com/api/v1/transcript?v={{ $json.videoId }}
Authorization: Bearer {{ $env.GETYOUTUBETRANSCRIPT_API_KEY }}

Envie um ID de vídeo na entrada do workflow (ou na saída de um nó anterior), e o nó retorna a transcrição, título, autor e miniatura como JSON em $json.data.transcript.

Processando vários vídeos sem estourar o limite de taxa

Enviar uma lista de IDs de vídeo direto para o nó HTTP Request dispara todas as requisições o mais rápido que o n8n conseguir - ótimo para 5 vídeos, arriscado para 500 contra um limite de 60 req/min no plano gratuito. O n8n oferece duas formas nativas de controlar o ritmo:

Nó HTTP Request → Add Option → Batching. Defina Items per Batch (quantas requisições disparam juntas) e Batch Interval (ms) (o intervalo entre lotes). Para o limite de 60 req/min do plano gratuito, um tamanho de lote de 5 com um intervalo de 5.000ms te mantém confortavelmente dentro do orçamento.
Split In Batches + nó Wait. O nó Split In Batches divide sua lista de vídeos em blocos; um nó Wait pausa entre os blocos antes de o loop continuar para o próximo. Isso é estritamente sequencial (sem nenhuma explosão paralela), o que é a escolha mais segura se você estiver perto do limite ou se a API à qual você está encadeando adiante (por exemplo, um resumidor via LLM) também tiver seu próprio teto de vazão.

Também defina Wait Between Tries (ms) nas configurações de retentativa do nó com um valor maior que seu orçamento por requisição - para um plano de 60 req/min isso é aproximadamente uma requisição por segundo em média, então 1.000ms+ entre retentativas evita reativar imediatamente o mesmo limite em um 429.

Lidando com falhas em um lote

Ao processar muitos vídeos, alguns vão falhar (vídeo privado, sem legendas, um 429 passageiro). Habilite Continue On Fail no nó HTTP Request para que uma falha não interrompa toda a execução, depois adicione um nó IF a seguir para ramificar com base na resposta - encaminhando sucessos para seu resumidor e falhas para um log ou fila de retentativa, em vez de perder o lote inteiro por causa de um ID de vídeo com problema.

Encadeie a um resumidor

Blog.Posts.n8nYoutubeTranscriptWorkflow.step6.body

A referência completa de endpoints, créditos e limites de taxa está na documentação da API. Está construindo um agente de IA em vez de uma automação n8n? Veja o guia de configuração do servidor MCP.

Perguntas frequentes sobre o workflow n8n

Q01

Preciso de um nó personalizado do n8n para isso?

Não. A API é um endpoint REST simples, então o nó nativo HTTP Request do n8n lida com isso diretamente - sem necessidade de instalar um nó da comunidade.

Q02

Como passo a chave de API de forma segura?

Defina-a como uma variável de ambiente do n8n (por exemplo, GETYOUTUBETRANSCRIPT_API_KEY) e referencie-a no campo de cabeçalho do nó HTTP Request, em vez de fixar a chave no JSON do workflow.

Q03

Qual é a diferença entre a opção Batching do nó HTTP Request e um nó Split In Batches?

O Batching do nó HTTP Request (Items per Batch + Batch Interval) envia várias requisições em paralelo por lote, espaçadas pelo intervalo - mais rápido, mas arrisca estourar um limite de taxa se o tamanho do lote for grande demais. Split In Batches + um nó Wait processa um lote inteiro, pausa, depois retoma para o próximo - mais lento, mas estritamente sequencial, o que é mais seguro contra limites por minuto apertados.

Q04

Como evito atingir o limite de taxa ao processar muitos vídeos?

Defina a opção de retentativa "Wait Between Tries" do nó HTTP Request com um valor maior que o orçamento por requisição do seu plano - para o limite de 60 req/min do plano gratuito (1 requisição/segundo em média), ritmo as requisições em aproximadamente 1.000ms+ de distância, ou menos se você estiver em um plano pago de maior vazão.

Q05

Posso encadear isso a uma etapa de resumo com IA?

Sim - adicione um nó de IA/LLM (OpenAI, Anthropic, etc.) depois do nó HTTP Request e referencie {{ $json.data.transcript }} como sua entrada para resumir ou extrair informações da transcrição retornada.

Q06

O que acontece se um vídeo não tiver legendas ou a requisição falhar?

Habilite "Continue On Fail" no nó HTTP Request se estiver processando um lote de vídeos, para que um vídeo com problema não pare toda a execução - depois ramifique com base no status da resposta a seguir (por exemplo, um nó IF verificando o sucesso) em vez de deixar o workflow parar.

Q07

Quanto custa cada execução?

1 crédito por busca de transcrição bem-sucedida, a mesma contabilidade de chamar a API REST diretamente. Obtenha 100 créditos grátis sem cartão necessário no painel.

Relacionados