Estude ganchos de abertura do TikTok com legendas temporizadas

O que você pode coletar

Use o TikTok Transcript Actor. A build pública atual é 0.1.36. Ele aceita de 1 a 100 alvos públicos conhecidos. Um alvo pode ser um URL de vídeo, um link curto ou um ID numérico de vídeo. Ele não pesquisa perfis. Ele não pesquisa palavras-chave. Ele não abre páginas de som. Ele não marca anúncios pagos.

preferredLanguages é a sua lista ordenada de idiomas públicos de legenda. Uma faixa de legenda é uma versão pública, em um idioma, das palavras. O Actor escolhe uma faixa pública existente na ordem da lista. Uma lista vazia usa a primeira faixa pública. O Actor não traduz. Ele não escreve palavras para som sem faixa pública. Ele não coleta comentários. Ele não atribui rótulos de gancho.

languageCode pode ser regional, como eng-US. Leia o código na linha. Não suponha que um nome curto de idioma e um código regional sejam a mesma faixa.

Uma entrada enviada devolve uma linha do conjunto de dados, mesmo quando a linha não é uma transcrição bem-sucedida. Mantenha videoId como texto. Um ID longo pode mudar se você o armazenar como número.

Uma linha tem estes campos:

• inputIndex
• inputUrl
• videoId
• videoUrl
• authorHandle
• durationSeconds
• languageCode
• text
• segments
• status
• statusReason
• isBillable
• scrapedAt

Um segmento é um trecho temporizado do texto da legenda. Cada segmento tem startSeconds, endSeconds e text. Use os tempos do segmento como foram dados. durationSeconds é a duração do vídeo. Não é a janela do gancho.

status é a palavra de resultado dessa entrada. Pode ser succeeded, no_public_captions, language_unavailable, duplicate_input, not_tiktok, invalid_input, unsupported_url, video_unavailable, not_public ou blocked_or_challenged. Uma falha ao ler a faixa também é um status. succeeded exige texto que não esteja vazio. Texto vazio com um status de falha não é silêncio falado.

isBillable é true somente para um resultado bem-sucedido de legenda pública. As outras linhas ainda são evidência. O uso da plataforma é separado dessa marcação. Não chame a execução inteira de gratuita. Uma execução é um trabalho do Actor.

O trabalho também devolve estes totais de OUTPUT:

• inputsReceived
• resultRows
• billableTranscriptRows
• nonBillableResultRows
• duplicateVideosSkipped
• statusCounts

Esses totais descrevem o trabalho. Eles não mostram que os seus vídeos representam todos os vídeos. duplicateVideosSkipped conta vídeos repetidos que foram ignorados no trabalho. Não é um achado do estudo.

A data da verificação pública é 2026-10-13. A verificação usou a build 0.1.36 e a entrada salva de um vídeo. A linha tinha o mesmo ID de vídeo que foi solicitado. O texto não estava vazio. A linha tinha 12 segmentos com startSeconds, endSeconds e text. A verificação não guardou as palavras da legenda. Isso mostra um caminho de legenda pública para essa única origem. Não mostra legendas em todos os vídeos. Não mostra precisão perfeita das palavras. Não mostra que um rótulo de gancho é válido.

A Task salva é a Task de pesquisa de ganchos do TikTok. A entrada atual é:

{
  "startUrls": ["https://www.tiktok.com/@hankgreen1/video/7047596209028074758"],
  "preferredLanguages": []
}

Substitua essa amostra por um vídeo público conhecido que você pretende estudar. Não mantenha a amostra, a menos que esse vídeo exato esteja no seu estudo. Uma Task é apenas uma entrada inicial. Ela não faz a rotulagem por você.

Para um estudo em inglês, use este piloto de um vídeo:

{
  "startUrls": ["PASTE_ONE_KNOWN_PUBLIC_VIDEO_URL"],
  "preferredLanguages": ["en"]
}

Use ["en"] somente quando o inglês for o idioma declarado do estudo. Se você estudar outro idioma, escreva essa regra de idioma. Não copie ["en"]. Uma lista vazia mantém a primeira faixa pública. Essa faixa pode ser o idioma errado.

Oito ações

1. Escreva a pergunta e a lista de vídeos antes de comparar ganchos.

Declare a pergunta sobre o criativo em uma frase. Liste apenas vídeos públicos conhecidos que você escolheu. Escolha uma janela e mantenha-a em todos os vídeos. A mesma janela impede que você rotule palavras iniciais em um vídeo e palavras posteriores em outro. O Actor não pode pesquisar todas as publicações de concorrentes. Ele não pode inferir o status de anúncio pago. A sua lista é a amostra que você declarou. Não é a plataforma inteira.

1. Obtenha uma faixa de legenda e, em seguida, verifique identidade, idioma, status e texto.

Comece com um vídeo pretendido. Confira videoId em relação ao seu alvo. Confira authorHandle. Confira languageCode em relação à sua regra de idioma. Confira se status é succeeded. Confira se text não está vazio. Mantenha os tempos originais dos segmentos. Leia statusReason quando estiver presente.

Estes status deixam a abertura falada desconhecida: no_public_captions, video_unavailable, not_public, blocked_or_challenged e language_unavailable. Uma falha na leitura da legenda também é desconhecida. Desconhecido significa que a evidência falada está ausente. Não significa "sem gancho". Não significa zero.

Se o status for language_unavailable, não rotule um idioma diferente como o idioma do seu estudo. Um status de entrada incorreta não é um resultado de gancho. not_tiktok, invalid_input e unsupported_url significam que você deve corrigir a entrada. duplicate_input não é um segundo vídeo. Conte esse vídeo uma vez.

1. Mantenha todo segmento que compartilha tempo com a janela. Não corte letras pela parcela de tempo.

Dois intervalos de tempo se sobrepõem quando compartilham qualquer tempo. Para uma janela de 0-3 segundos, mantenha um segmento quando startSeconds for menor que 3. Exija também que endSeconds seja maior que 0. Um segmento totalmente dentro da janela é mantido. Um segmento que cruza 3 segundos é mantido. Um segmento que começa em 3 segundos ou depois não é mantido. Um segmento que termina em 0 ou antes não é mantido. Se você escolher outra janela, use o novo tempo final no mesmo teste para todos os vídeos.

Um segmento que cruza pode conter fala de depois da janela. Mantenha o texto bruto completo. Assista ao clipe e marque quais palavras caem dentro da janela. Não fatie as letras em proporção ao tempo. A fala pode pausar. Uma palavra curta pode cair depois do corte. Uma palavra longa pode cair antes do corte.

1. Escreva um livro de códigos pequeno da fala antes de comparar resultados.

Um livro de códigos é a lista escrita de rótulos falados e regras. Escreva-o antes de procurar um padrão. Codificar uma abertura é dar a ela um rótulo falado dessa lista. Esses rótulos são rótulos manuais de estudo. Não são campos do Actor. Não são formatos vencedores comprovados.

Use um rótulo primário por vídeo, a menos que você escreva antes uma regra para mais de um. Um rótulo primário é o único rótulo falado daquele vídeo. Combine uma pergunta e um problema em question_problem. Se você os separar, uma pergunta sobre um problema pode parecer dois ganchos. Mantenha promise e result-first separados. Uma promessa aponta para a frente. Result-first coloca a coisa concluída na abertura. A lista de rótulos é question_problem, promise, result-first, spoken_demonstration_cue, other e no_clear_device. Legendas ausentes permanecem unknown. Unknown não está nesta lista falada.

1. Assista e ouça a mesma janela. Mantenha campos separados.

Um campo é um lugar nomeado na sua planilha. Reproduza os mesmos 0-3 segundos. Registre o que você vê em um campo visual. Registre as palavras impressas na tela no campo delas. Registre quem fala e os outros sons em um campo de áudio. Registre a primeira ação significativa no tempo e o momento em que ela ocorre. Essa ação é a primeira coisa importante que acontece na janela.

Uma demonstração silenciosa pode ser um gancho visual mesmo quando o texto da legenda está vazio. Nenhum campo de transcrição reconhece uma cena. Não cole uma nota visual no rótulo falado. Palavras na tela não são palavras faladas. Se você não registrou um campo, deixe-o em branco. Em branco não é o mesmo que nenhum.

1. Salve a evidência, o codificador e a incerteza.

Mantenha o texto bruto da legenda. Mantenha uma nota manual separada para qualquer correção. Registre o intervalo de tempo, o rótulo falado, o codificador e a incerteza. Um codificador é a pessoa que atribui o rótulo. Revise um piloto pequeno com um segundo codificador, ou faça uma segunda passagem declarada. Se as duas verificações discordarem, mude a regra ou a nota. Não invente uma pontuação de precisão. Não substitua o texto bruto pela cópia manual. Você precisa dos dois.

1. Compare a presença dos rótulos na amostra declarada.

Conte vídeos únicos. Não conte segmentos de legenda. Dois segmentos em uma janela ainda são um vídeo. Informe legendas unknown à parte das aberturas faladas verificadas. Uma parcela usa apenas o denominador que você nomeia. O denominador é a contagem pela qual você divide. Diga esse denominador no resultado.

Se depois você comparar contadores públicos, os vídeos comparados devem corresponder em idade, tema e tempo. Diga que essa correspondência apenas descreve o conjunto. Ela não mostra que um rótulo causou as contagens. Não mantenha apenas vídeos com muitas visualizações e chame os rótulos deles de vencedores. A pergunta sobre retenção não prova uma causa, e as curtidas ali não mostram retenção.

1. Use a planilha para planejar um teste novo, não um ganho garantido.

Use os códigos e as notas para desenhar uma abertura nova que você possa testar. Uma hipótese de criativo é essa ideia de teste. Não é uma melhora prometida. Este método estuda uma abertura que já está na origem. Ele não escolhe novos pontos de edição. Ele não corta um clipe novo. Ele não prevê um sucesso viral. Ele não mede a retenção. Ele não lê a imagem por você.

Livro de códigos da fala

As frases de amostra neste livro de códigos são ficção original. Não são palavras do controle público. Não são um resultado de produto. Cada vídeo recebe um rótulo falado primário.

question_problem é o rótulo primário combinado para uma pergunta ou um problema nomeado. Não acrescente também um segundo rótulo falado para o mesmo vídeo. Uma frase fictícia é "A sua bandeja tomba?"

promise significa que quem fala diz que um resultado virá, mas o resultado concluído não está na abertura. Uma frase fictícia é "Vou mostrar uma bandeja nivelada." Isso aponta para a frente. Não é result-first.

result-first significa que a abertura declara o resultado concluído agora. Uma frase fictícia é "Aqui está o canteiro pronto." As palavras colocam o canteiro pronto na abertura. Isso é diferente de uma promessa de um resultado posterior.

spoken_demonstration_cue significa que palavras faladas dizem a quem assiste para observar uma ação. Uma frase fictícia é "Veja esta tampa estalar." Uma ação silenciosa não recebe este rótulo falado. Coloque essa ação no campo visual.

other significa que uma verificação válida encontrou um recurso falado claro na janela, e esse recurso fica fora das categorias nomeadas. O recurso é distinto. Acrescente uma nota curta que nomeia o recurso.

no_clear_device significa que uma verificação válida da legenda ou uma verificação manual válida não encontrou recurso falado na janela. Use-o para fala verificada sem recurso falado. Use-o também para silêncio confirmado. Não o use quando a evidência está ausente ou a verificação da legenda falhou. Evidência ausente ou com falha permanece unknown.

unknown significa que você não tem evidência falada utilizável. É uma marca de evidência ausente, não um rótulo de gancho. Uma linha no_public_captions permanece unknown. Não renomeie unknown como no_clear_device. Não renomeie unknown como "sem gancho". Não trate unknown como zero.

Exemplo resolvido fictício

Os quatro vídeos abaixo são ficção original. Não são o controle público e não são um resultado real de criador. A janela é de 0-3 segundos para todos os vídeos. O livro de códigos acima é o único livro de códigos da fala. Um vídeo recebe um rótulo falado primário, ou unknown.

Mantenha um segmento quando startSeconds for menor que 3 e endSeconds for maior que 0.

V1 tem dois segmentos, e os dois passam no teste da janela. O primeiro vai de 0.0 a 1.5 segundos. O texto completo é "A sua bandeja tomba?". Esse segmento fica dentro da janela. O segundo vai de 1.5 a 3.5 segundos. O texto bruto completo é "Esta alça simples a mantém nivelada.". Mantenha essa frase completa no campo bruto. A frase termina em 3.5 segundos, então apenas o primeiro trecho está dentro da janela. A nota manual guarda essa verificação de limite. Não corte uma fração das letras e chame essa fração de fala dentro da janela. O rótulo falado primário é question_problem. Os dois segmentos ainda contam como um vídeo. Eles não acrescentam um segundo rótulo primário.

V2 tem um segmento de 0.0 a 2.0 segundos. O segmento inteiro está dentro da janela. As palavras declaram o canteiro pronto agora, então o rótulo falado é result-first. Não é promise, porque a abertura não adia o resultado. O campo visual mostra o canteiro pronto como uma nota separada. Essa nota não é um segundo rótulo falado.

V3 tem status no_public_captions, então não há texto de legenda para rotular. Uma observação manual mostra uma demonstração silenciosa. Registre isso apenas no campo visual. A marca falada permanece unknown. A legenda ausente não é silêncio falado, não é no_clear_device e não é um "sem gancho" falado.

V4 tem legendas succeeded, mas a primeira legenda começa em 4.0 segundos. Nenhum segmento tem startSeconds menor que 3, então nenhum texto de legenda entra na janela. Uma primeira legenda tardia não é prova por si só. A observação manual confirma que não há fala de 0 a 3 segundos. O rótulo falado é no_clear_device. Uma ação com régua ocorre em 1.0 segundos. Isso é uma demonstração visual. Não é spoken_demonstration_cue, porque a janela não tem deixa falada.

O conjunto tem 4 vídeos selecionados. Todos os 4 têm uma nota visual manual. Os resultados falados verificados são 3: V1, V2 e V4. Os resultados falados unknown são 1: V3. Um dos três vídeos verificados é question_problem. A parcela verificada é 1 de 3, que é 33,3 por cento. Não informe 1 de 4 por hábito. Use 4 somente quando você quer dizer todos os vídeos selecionados. Você ainda deve mostrar o 1 vídeo unknown. V3 não acrescenta um "sem gancho" falado. V1 conta uma vez, mesmo com dois segmentos. O rótulo other não é usado nestas quatro linhas. Esta ficção não usa contagens de visualizações e não nomeia um rótulo vencedor.

O texto bruto e a nota manual ficam em campos separados. Este exemplo não inventa uma pontuação de concordância. Um segundo codificador, ou uma segunda passagem, revisaria estas quatro linhas. Uma discordância mudaria a nota ou a regra.