YouTube Transcrição e Legendas (português)

Pegue a transcrição completa de qualquer vídeo do YouTube em português, ou de um canal, uma playlist ou uma busca inteira: texto limpo, trechos com marcação de tempo, legendas SRT ou VTT, e ainda a data de publicação, as visualizações, a duração, a descrição e a miniatura. Pronto para resumo com IA, RAG, fluxos no n8n, legendas ou pesquisa de conteúdo.

Por padrão procura primeiro a legenda em português (pt, pt-BR, pt-PT) e, se não houver, em inglês.

Por que este

• Vídeos, canais, playlists e buscas no mesmo campo. Cole um canal (/@usuario), uma playlist ou uma URL de busca do YouTube e receba as transcrições dos vídeos, com limite por fonte, data "publicado depois de" e Shorts ligados ou não.
• Só vídeos novos desde a última execução. Ligue onlyNewVideos, agende o Actor todo dia e cada execução transcreve só os vídeos que você ainda não tinha.
• Vídeo sem legenda nunca derruba a execução. Ele volta como um resultado com errorCode (por exemplo NO_CAPTIONS) e não é cobrado, então uma chamada de um vídeo só pelo n8n, Make ou Zapier não quebra o seu fluxo.
• Confere duas vezes antes de dizer "sem legenda". As legendas são lidas direto do player do YouTube com dois clientes diferentes, e um segundo método é tentado antes de declarar que o vídeo não tem legenda.
• Dados do vídeo inclusos: publishedAt, viewCount, lengthSeconds, description, thumbnailUrl, channelId, título e canal, sem custo extra.
• Escolha a legenda: idiomas em ordem de preferência, só manual ou só automática, e tradução opcional.
• SRT e VTT inclusos pelo mesmo preço, junto com o texto e os trechos.
• Troca direta: aceita os nomes de campo de outros scrapers de transcrição (videoUrl, urls, startUrls, youtube_url, targetLanguage).

Casos de uso

• Mandar a transcrição de vídeos para o ChatGPT, o Claude ou o seu RAG para resumir ou responder perguntas sobre vídeos em português.
• Monitorar um canal: uma execução diária com onlyNewVideos manda a transcrição de cada vídeo novo para o seu fluxo.
• Transformar um curso, um canal de podcast ou os primeiros resultados de uma busca em texto para SEO, anotações ou posts de blog.
• Baixar legendas em SRT ou VTT para editar ou subir de novo.

Entrada

{
  "videoUrls": [
    "https://www.youtube.com/watch?v=nAWHwvnO5SY",
    "https://www.youtube.com/@amopaocaseiro",
    "https://www.youtube.com/results?search_query=como+fazer+pao+caseiro"
  ],
  "searchQueries": ["aula de excel para iniciantes"],
  "maxVideosPerSource": 10,
  "publishedAfter": "2026-01-01",
  "includeShorts": false,
  "onlyNewVideos": false,
  "languages": ["pt", "pt-BR", "pt-PT", "en"],
  "captionType": "any",
  "includeSegments": true,
  "subtitleFormats": ["srt"],
  "maxItems": 50
}

• Vídeos: URLs watch, youtu.be, shorts, embed e live, ou IDs de 11 caracteres. Duplicados são removidos.
• Canais: /@usuario, /channel/UC..., /c/nome e /user/nome, do mais novo para o mais antigo. Com includeShorts desligado vêm os vídeos normais e as lives encerradas; ligado, os Shorts também.
• Playlists: qualquer URL com list= que não seja de um vídeo só, ou o ID da playlist.
• Buscas: URLs de busca do YouTube (/results?search_query=..., os filtros da URL são mantidos) ou termos em searchQueries. Só vídeos entram.
• maxVideosPerSource limita cada canal, playlist ou busca; maxItems limita a execução inteira.
• Os vídeos são processados em paralelo, então chegam ao dataset na ordem em que terminam; ordene por publishedAt se precisar de linha do tempo.
• publishedAfter pula vídeos mais antigos em todas as entradas; vídeo pulado não gera resultado nem custo.

Vindo de outro scraper de transcrição? Funciona do jeito que está: {"videoUrl": "https://www.youtube.com/watch?v=...", "targetLanguage": "pt"}, {"urls": ["..."]}, {"startUrls": [{"url": "..."}]}, {"youtube_url": "..."}.

Saída

Um resultado por vídeo. Os nomes dos campos ficam em inglês, iguais aos da versão em inglês deste Actor, para a sua integração funcionar com as duas:

{
  "videoId": "nAWHwvnO5SY",
  "url": "https://www.youtube.com/watch?v=nAWHwvnO5SY",
  "title": "PÃO CASEIRO PARA INICIANTES: Receita fácil para quem nunca fez pão",
  "channel": "Amo Pão Caseiro",
  "channelId": "UCrpLBn22arVETOO5alUbW7A",
  "publishedAt": "2020-01-23T21:34:42+00:00",
  "viewCount": 10331650,
  "lengthSeconds": 643,
  "thumbnailUrl": "https://i.ytimg.com/vi_webp/nAWHwvnO5SY/sddefault.webp",
  "category": "Howto & Style",
  "language": "pt",
  "languageName": "Portuguese",
  "isAutoGenerated": false,
  "availableLanguages": ["en", "pt"],
  "text": "Essa é uma receita para quem nunca fez pão ou já tentou fazer e não deu certo. ...",
  "wordCount": 1713,
  "durationSeconds": 639.8,
  "segments": [{ "text": "Essa é uma receita para quem nunca fez pão ou já tentou fazer e não deu certo.", "start": 0.14, "duration": 4.22 }],
  "srt": "1\n00:00:00,140 --> 00:00:04,360\nEssa é uma receita para quem nunca fez pão ou já tentou fazer e não deu certo.\n...",
  "error": null,
  "errorCode": null,
  "sourceUrl": "https://www.youtube.com/watch?v=nAWHwvnO5SY",
  "scrapedAt": "2026-09-13T03:27:06+00:00"
}

Saída real de um teste em 13/09/2026, com o texto cortado. lengthSeconds é a duração real do vídeo; durationSeconds é onde termina a última legenda.

Vídeos que não puderam ser transcritos trazem error e errorCode (e os dados do vídeo quando o YouTube devolveu) e não são cobrados:

errorCode	Significado
NO_CAPTIONS	O vídeo não tem legenda
NO_CAPTIONS_IN_LANGUAGE	Não há legenda do tipo pedido
VIDEO_UNAVAILABLE / VIDEO_UNPLAYABLE	Vídeo privado, removido ou bloqueado por região
AGE_RESTRICTED	Vídeo com restrição de idade
LIVE_NOT_ENDED	Live em andamento, agendada ou sem gravação disponível
INVALID_VIDEO_ID	Não é um vídeo válido
BLOCKED	O YouTube bloqueou todas as tentativas; tente de novo

A execução só falha quando nada foi entregue e o YouTube bloqueou as requisições, ou quando nenhum canal, playlist ou busca pôde ser listado.

Preços

A partir de US$ 3,50 por 1.000 transcrições entregues, sem mensalidade. US$ 5,00 no plano Free e menos nos planos pagos da Apify:

Plano da Apify	Por 1.000 transcrições
Free	US$ 5,00
Starter (Bronze)	US$ 4,50
Scale (Silver)	US$ 4,00
Business (Gold) ou acima	US$ 3,50

Uma cobrança = um vídeo com transcrição entregue, qualquer que seja a duração ou o formato. Listar canais, playlists e buscas é grátis, assim como vídeos sem legenda, indisponíveis ou bloqueados.

Como usar

• Console: cole as URLs, clique em Start e baixe JSON, CSV ou Excel.
• API: POST https://api.apify.com/v2/acts/scrapewise~youtube-transcricao-portugues/run-sync-get-dataset-items?token=SEU_TOKEN com a entrada acima no corpo.
• Agendamento: rode todo dia nos seus canais com onlyNewVideos ligado, pelo Apify Schedules.
• Integrações: n8n, Make, Zapier e Google Sheets pelas integrações da Apify.

Perguntas frequentes

Preciso configurar alguma coisa? Não. Cole URLs de vídeos, canais, playlists ou buscas e clique em Start. O resto já vem configurado.

Só funciona com vídeo em português? Não. Prefere legenda em português, mas transcreve vídeo em qualquer idioma. Mude languages (por exemplo ["en", "pt"]) se quiser outra ordem.

Sou cobrado por vídeo sem legenda? Não. A cobrança é uma por vídeo com transcrição entregue. Vídeos com falha, listagem de canais e playlists e vídeos pulados são grátis.

O que quer dizer "por 1.000 transcrições"? Cada transcrição entregue é uma cobrança, qualquer que seja a duração do vídeo ou o formato. 1.000 vídeos com transcrição = o preço da tabela.

Dá para receber só os vídeos que o canal publicou desde a última execução? Sim. Ligue onlyNewVideos e agende o Actor.

Qual a diferença para a versão em inglês? Nenhuma no resultado: mesmo motor, mesmos campos e mesmo preço. Esta versão tem a interface, a documentação e os idiomas padrão em português.

Como uso no n8n, Make ou Zapier? Pela integração da Apify, chamando scrapewise/youtube-transcricao-portugues com a entrada acima. Um vídeo por chamada funciona bem, e vídeo sem legenda devolve um resultado com errorCode em vez de quebrar o fluxo.

Dá para usar com agente de IA (MCP)? Sim, pelo servidor MCP da Apify, como qualquer Actor.

Deu NO_CAPTIONS mas o vídeo tem legenda. Abra uma issue com a URL do vídeo. Conferimos dois clientes do YouTube e um segundo método antes de dizer que não há legenda, e corrigimos rápido os casos reportados.

Transcreve o áudio? Não. Lê as legendas que o YouTube já tem (manuais ou automáticas), que cobrem a maioria dos vídeos em português.

Changelog

• 2026-09-14: preço menor, a partir de US$ 3,50 por 1.000 nos planos pagos (US$ 5,00 no Free).
• 2026-09-13: primeira versão em português, com o motor da versão em inglês (canais, playlists, buscas, só vídeos novos, SRT/VTT, dados do vídeo).

Limitações

• Só vídeos com legenda (manual ou automática) podem ser transcritos. Este Actor não transcreve áudio.
• A tradução usa a do próprio YouTube, que recusa a maioria dos pedidos. Quando recusa, o idioma original é entregue e o motivo fica em translationError.
• Vídeos com restrição de idade e lives em andamento não podem ser transcritos.
• O YouTube bloqueia a maioria dos IPs de datacenter, por isso o proxy residencial é o padrão. Deixe ligado.
• Deu algum problema? Abra uma issue na página do Actor. Respondemos em até 12 horas.

Este Actor coleta só dados públicos e respeita os termos do site.

Palavras-chave: transcrição do YouTube, transcrever vídeo do YouTube, legendas do YouTube, baixar legenda do YouTube, vídeo para texto, transcrição automática, legenda SRT.