YouTube Transcript

Dê ao seu agente as palavras de um vídeo do YouTube

Q: Quais idiomas?

Qualquer idioma em que o vídeo tenha legendas; defina lang (padrão en) e o actor recorre ao idioma original. Quando o vídeo não tem uma faixa manual no idioma pedido, pode ser devolvida no lugar a tradução automática do YouTube das legendas; o campo lang de cada item diz qual idioma você recebeu.

Q: Por que não a API oficial do YouTube Data?

O método de download de legendas, captions.download, exige permissão para editar o vídeo, um escopo OAuth e 200 unidades de cota por chamada, então serve ao dono de um vídeo, não a um terceiro. Este actor lê as legendas de vídeos públicos e as devolve como JSON: 17 de 20 vídeos públicos entregues em nossa última medição (85%), e um vídeo que não pode ser lido é informado e não é cobrado.

A API de transcrição do YouTube da Frameskim devolve a transcrição com timestamps de cada vídeo público por $0.01 por transcrição, até 100 vídeos por execução. Envie até 100 URLs públicas do YouTube por execução. Receba cada transcrição com timestamps por segmento e o texto completo, pronta para colar em um LLM.

Execute na Apify Ver exemplo de API

US$0.01 por transcrição. Vídeos que falham não são cobrados.

Cada vídeo: sua transcrição, um segmento com timestamp por linha, mais o texto completo.

Saída, um item por vídeo

{
  "videoId": "4czjS9h4Fpg",
  "title": "Perseverance Rover's Descent and Touchdown on Mars",
  "lang": "en",
  "segments": [
    { "start": 0.0, "end": 4.2, "text": "..." }
  ],
  "text": "...",
  "frameskimUrl": "https://apify.com/emttn/frameskim"
}

Valores encurtados. segments trazem start e end em segundos; text é a transcrição inteira em um só texto; frameskimUrl aponta para o Frameskim, para os frames do mesmo vídeo.

Casos de uso

Resumir um vídeo ou perguntar sobre ele

Cole text em qualquer modelo e peça um resumo, os passos de um tutorial ou uma resposta.

Indexar um lote de vídeos

Envie uma lista de até 100 URLs de vídeo em uma execução e carregue as transcrições na sua busca ou pipeline de RAG.

Citar o segundo exato

Cada segmento tem seu início e seu fim, então uma resposta pode apontar de volta ao momento de onde saiu.

Entrada e saída

Entrada

{
  "urls": ["https://youtu.be/4czjS9h4Fpg"],
  "lang": "en"
}

lang é en por padrão e, se o vídeo não tiver, usa o idioma original do vídeo.

Um vídeo que falhou

{
  "videoId": "abc123def45",
  "error": "..."
}

Sem legendas ou bloqueado pelo YouTube: o item diz o motivo.

Preço

US$0.01 por transcrição

Pagamento por evento na Apify. Sem assinatura. Um lote de 100 vídeos com legendas custa US$1.00, e nunca mais que o limite de gasto que você define para a execução.

Limites

Vídeos, canais e playlists públicos, até 100 vídeos por execução; cada canal ou playlist soma até maxVideos dos seus vídeos (20 por padrão). Buscas são recusadas antes de executar qualquer coisa, sem cobrar nada.
O que falha não é cobrado: sem legendas, bloqueado pelo YouTube ou mais de 120 s para um vídeo.
Os vídeos precisam de legendas: não transcreve áudio.
Exemplo: as transcrições de um canal inteiro em uma execução

Use por API ou pelo Claude

API

curl -X POST "https://api.apify.com/v2/acts/emttn~youtube-transcript/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://youtu.be/4czjS9h4Fpg"]}'

MCP

{ "mcpServers": { "apify": {
  "url": "https://mcp.apify.com/?actors=emttn/youtube-transcript"
} } }

Depois peça: "Use o YouTube Transcript para ler este vídeo e resumi-lo."

Perguntas frequentes

Quais idiomas?

Qualquer idioma em que o vídeo tenha legendas; defina lang (padrão en) e o actor recorre ao idioma original. Quando o vídeo não tem uma faixa manual no idioma pedido, pode ser devolvida no lugar a tradução automática do YouTube das legendas; o campo lang de cada item diz qual idioma você recebeu.

E se uma execução falhar?

A mensagem de status diz o motivo. Uma execução que não consegue começar diz "Nothing was charged."; uma que para de forma inesperada diz "Only delivered transcripts were charged." e cobra só as transcrições que entregou, se houver alguma. Tente de novo mais tarde se o YouTube bloqueou a requisição. Se parecer um erro nosso, compartilhe a execução conosco pelo Apify Console ou abra uma issue na aba Issues com o ID da execução: só vemos as execuções que você compartilha.

Vocês guardam minhas transcrições?

Não. Elas ficam apenas no armazenamento da Apify da sua própria execução, com a retenção do seu plano.

Por que não a API oficial do YouTube Data?

O método de download de legendas, captions.download, exige permissão para editar o vídeo, um escopo OAuth e 200 unidades de cota por chamada, então serve ao dono de um vídeo, não a um terceiro. Este actor lê as legendas de vídeos públicos e as devolve como JSON: 17 de 20 vídeos públicos entregues em nossa última medição (85%), e um vídeo que não pode ser lido é informado e não é cobrado.

Alternativas para transcrições do YouTube?

Você pode copiar as legendas à mão na página do vídeo, ou escrever seu próprio extrator e mantê-lo funcionando conforme o YouTube muda. Este actor é a versão com pagamento por transcrição disso; para frames e momentos dos mesmos vídeos use o Frameskim, e para Reels e TikToks o Instagram & TikTok Transcripts, Frames & Posts.