~/social/tiktok-transcript-scraper

Scraper de transcrições e legendas do TikTok — JSON, SRT, VTT, LLM

Extrai legendas e transcrições do TikTok a partir de URLs de vídeo, links curtos ou um perfil @ inteiro, em JSON, SRT, VTT, texto simples ou texto pronto para LLM. Legendas nativas — sem Whisper, sem chave de API, cerca de dois segundos por vídeo.

mídia TypeScript Global
proooxy/tiktok-transcript-scraper — especificações
categoriasocial / mídia
linguagemTypeScript
stackTypeScript
mercadosGlobal
saídaJSON limpo e pronto para RAG

principais recursos

Lê as legendas do próprio TikTok em vez de transcrever o áudio de novo — cerca de 2 segundos por vídeo contra 10 a 30 de uma ferramenta com Whisper

O texto exato que aparece na tela: nada é ouvido errado nem inventado

Cinco formatos de saída — JSON com marcação de tempo, SRT, VTT, texto simples e texto pronto para LLM, sem [Music] nem rótulos de locutor

Um único campo aceita URLs de vídeo, links curtos vm./vt., perfis @ e IDs brutos, misturados à vontade

Um perfil na entrada enumera os vídeos do criador; maxVideos funciona como orçamento da execução inteira

Métricas por vídeo — reproduções, curtidas, comentários, compartilhamentos, duração, contagem de palavras e de segmentos

Lista de idiomas por prioridade com correspondência por prefixo (eng corresponde a eng-US) e controle de legendas automáticas

Extrações que falham, resolução de links curtos e enumeração de perfis nunca são cobradas

casos de uso

  • Montar corpora de RAG ou fine-tuning a partir de vídeo curto
  • Reaproveitar conteúdo falado em posts, newsletters e textos para redes sociais
  • Análise competitiva de conteúdo em todos os criadores de um nicho
  • Gerar arquivos de legenda SRT/VTT para repostagem e localização
  • Pesquisa de ganchos — ler os primeiros segundos dos vídeos de topo de uma categoria
  • Revisão de brand safety e de sinalização em publicações patrocinadas, em escala

parâmetros de entrada

ParâmetroTipoObrigatórioDescrição
urlsarrayobrigatórioURLs de vídeos do TikTok, links curtos, perfis @ ou IDs brutos
outputFormatstringopcionaljson, srt, vtt, text ou llm
languagesarrayopcionalIdiomas de legenda por prioridade; correspondência por prefixo, eng corresponde a eng-US
includeAutoGeneratedbooleanopcionalIncluir as legendas automáticas do TikTok quando não houver manuais
maxVideosintegeropcionalLimite de vídeos para toda a execução; 0 significa ilimitado
maxConcurrencyintegeropcionalWorkers paralelos, 1–10; valores baixos são mais seguros contra limites de taxa
proxyConfigurationobjectopcionalProxy residencial é fortemente recomendado — o TikTok bloqueia IPs de datacenter

Exemplo de saída

 1{
 2  "videoId": "7627209981670001950",
 3  "url": "https://www.tiktok.com/@tiktok/video/7627209981670001950",
 4  "title": "your TikTok grandpa @writers cramp is proud of you",
 5  "authorName": "TikTok",
 6  "authorId": "tiktok",
 7  "createTime": "2026-04-10T19:10:35.000Z",
 8  "playCount": 54600,
 9  "likeCount": 3656,
10  "commentCount": 837,
11  "shareCount": 291,
12  "availableLanguages": ["eng-US"],
13  "language": "eng-US",
14  "isAutoGenerated": true,
15  "segments": [
16    { "text": "I'm 81 years old and I'm known as the TikTok Grandpa", "start": 0.04, "end": 3.64 },
17    { "text": "my name is Ian Smith", "start": 3.641, "end": 4.721 }
18  ],
19  "text": "I'm 81 years old and I'm known as the TikTok Grandpa my name is Ian Smith...",
20  "duration": 77,
21  "wordCount": 243,
22  "segmentCount": 29,
23  "extractedAt": "2026-04-12T02:45:36.000Z",
24  "error": null
25}

Dicas

Comece com um vídeo. Uma URL confirma o esquema e o idioma retornado antes de você apontar para um perfil. Defina maxVideos em execuções com perfis. É um orçamento da execução inteira, não por perfil, então entradas mistas nunca estouram. Mantenha a concorrência em 3. O TikTok limita com rigor; subir troca confiabilidade por pouca velocidade. Escolha llm para pipelines de IA. Esse formato remove [Music], rótulos de locutor e anotações que viram ruído nos embeddings.

faq

Este Actor usa Whisper ou reconhecimento de fala?
Não. Ele busca os arquivos de legenda que o próprio TikTok gera e serve pelo CDN, então o texto é exatamente o que os espectadores veem e cada vídeo leva cerca de dois segundos em vez de meio minuto.
O que acontece com um vídeo sem legendas?
Ele volta com o campo error preenchido e não custa nada. A cobrança é por transcrição extraída com sucesso, não por URL enviada.
Posso percorrer uma conta inteira?
Pode — passe a URL do perfil ou o @usuário e o Actor enumera os vídeos do criador. Use maxVideos para limitar: os vídeos indicados explicitamente vêm primeiro e os perfis preenchem o restante.

relacionados em ~/social

Execute Scraper de transcrições e legendas do TikTok — JSON, SRT, VTT, LLM ou solicite um projeto personalizado

Comece a extrair dados no Apify em minutos, ou me contrate para desenvolver um scraper sob medida e um pipeline de RAG para sua fonte e esquema exatos.

executar no Apify obter dados personalizados