Estudiar ganchos de apertura de TikTok con subtítulos temporizados

Qué puede recopilar

Use el TikTok Transcript Actor. La compilación pública actual es 0.1.36. Acepta de 1 a 100 destinos públicos conocidos. Un destino puede ser una URL de video, un enlace corto o un ID numérico de video. No busca perfiles. No busca palabras clave. No abre páginas de sonido. No marca anuncios pagos.

preferredLanguages es su lista ordenada de idiomas públicos de subtítulos. Una pista de subtítulos es una versión pública, en un idioma, de las palabras. El Actor elige una pista pública existente según el orden de la lista. Una lista vacía usa la primera pista pública. El Actor no traduce. No escribe palabras para un sonido que no tiene pista pública. No recopila comentarios. No asigna etiquetas de gancho.

languageCode puede ser regional, como eng-US. Lea el código en la fila. No suponga que un nombre corto de idioma y un código regional son la misma pista.

Una entrada enviada devuelve una fila del conjunto de datos, aunque la fila no sea una transcripción correcta. Conserve videoId como texto. Un ID largo puede cambiar si lo guarda como número.

Una fila tiene estos campos:

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

Un segmento es un fragmento temporizado del texto de subtítulos. Cada segmento tiene startSeconds, endSeconds y text. Use esos tiempos de segmento tal como vienen dados. durationSeconds es la duración del video. No es la ventana del gancho.

status es la palabra de resultado para esa entrada. Puede ser succeeded, no_public_captions, language_unavailable, duplicate_input, not_tiktok, invalid_input, unsupported_url, video_unavailable, not_public o blocked_or_challenged. Un fallo al leer la pista también es un status. succeeded exige un text que no esté vacío. Un text vacío con un status de fallo no es silencio hablado.

isBillable es true solo para un resultado correcto de subtítulos públicos. Las otras filas siguen siendo evidencia. El uso de la plataforma es aparte de esa marca. No llame gratuita a toda la ejecución. Una ejecución es un trabajo del Actor.

El trabajo también devuelve estos totales de OUTPUT:

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

Estos totales describen el trabajo. No muestran que sus videos representen a todos los videos. duplicateVideosSkipped cuenta los videos repetidos omitidos en el trabajo. No es un hallazgo del estudio.

La fecha de la comprobación pública es 2026-10-13. La comprobación usó la compilación 0.1.36 y la entrada guardada de un video. La fila tenía el mismo ID de video que se solicitó. El text no estaba vacío. La fila tenía 12 segmentos con startSeconds, endSeconds y text. La comprobación no conservó las palabras de los subtítulos. Eso muestra una ruta de subtítulos públicos para esa única fuente. No muestra subtítulos en cada video. No muestra una exactitud perfecta de las palabras. No muestra que una etiqueta de gancho sea válida.

La Task guardada es la Task de investigación de ganchos de TikTok. Su entrada actual es:

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

Reemplace esa muestra por un video público conocido que quiera estudiar. No conserve la muestra, salvo que ese video exacto esté en su estudio. Una Task es solo una entrada de partida. No hace el etiquetado por usted.

Para un estudio en inglés, use esta prueba piloto de un video:

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

Use ["en"] solo cuando el inglés sea el idioma declarado de su estudio. Si estudia otro idioma, escriba esa regla de idioma. No copie ["en"]. Una lista vacía conserva la primera pista pública. Esa pista puede ser el idioma incorrecto.

Ocho acciones

1. Escriba la pregunta y la lista de videos antes de comparar ganchos.

Enuncie en una oración la pregunta sobre las opciones de la apertura. Liste solo videos públicos conocidos que usted eligió. Elija una ventana y consérvela para cada video. La misma ventana evita que etiquete palabras tempranas en un video y palabras posteriores en otro. El Actor no puede buscar todas las publicaciones de la competencia. No puede inferir si un anuncio es pago. Su lista es la muestra que usted declaró. No es toda la plataforma.

1. Obtenga una pista de subtítulos y después compruebe la identidad, el idioma, el status y el text.

Empiece con un video previsto. Compare videoId con su destino. Compruebe authorHandle. Compare languageCode con su regla de idioma. Compruebe que status sea succeeded. Compruebe que text no esté vacío. Conserve los tiempos originales de los segmentos. Lea statusReason cuando esté presente.

Estos status dejan desconocida la apertura hablada: no_public_captions, video_unavailable, not_public, blocked_or_challenged y language_unavailable. Un fallo al leer los subtítulos también es desconocido. Desconocido significa que falta la evidencia hablada. No significa "sin gancho". No significa cero.

Si el status es language_unavailable, no etiquete otro idioma como el idioma de su estudio. Un status de entrada incorrecta no es un resultado de gancho. not_tiktok, invalid_input y unsupported_url significan que debe corregir la entrada. duplicate_input no es un segundo video. Cuente ese video una sola vez.

1. Conserve cada segmento que comparta tiempo con la ventana. No corte letras según la proporción de tiempo.

Dos tramos de tiempo se superponen cuando comparten cualquier tiempo. Para una ventana de 0-3 segundos, conserve un segmento cuando startSeconds sea menor que 3. Exija también que endSeconds sea mayor que 0. Se conserva un segmento que está por completo dentro de la ventana. Se conserva un segmento que cruza los 3 segundos. No se conserva un segmento que empieza a los 3 segundos o después. No se conserva un segmento que termina en 0 o antes. Si elige otra ventana, use el nuevo tiempo final en la misma prueba para cada video.

Un segmento que cruza puede contener habla posterior a la ventana. Conserve su texto crudo completo. Mire el clip y marque qué palabras caen dentro de la ventana. No corte las letras en proporción al tiempo. El habla puede hacer una pausa. Una palabra corta puede caer después del corte. Una palabra larga puede caer antes del corte.

1. Escriba un libro de códigos pequeño para clasificar el habla antes de comparar resultados.

Un libro de códigos es la lista escrita de etiquetas habladas y de reglas. Escríbalo antes de buscar un patrón. Codificar una apertura es darle una etiqueta hablada de esa lista. Estas etiquetas son etiquetas manuales de estudio. No son campos del Actor. No son formatos ganadores demostrados.

Use una etiqueta primaria por video, salvo que primero escriba una regla para más de una. Una etiqueta primaria es la única etiqueta del habla para ese video. Combine una pregunta y un problema en question_problem. Si los separa, una pregunta sobre un problema puede parecer dos ganchos. Mantenga aparte promise y result-first. Una promesa apunta hacia adelante. Result-first pone lo ya terminado en la apertura. La lista de etiquetas es question_problem, promise, result-first, spoken_demonstration_cue, other y no_clear_device. Los subtítulos faltantes siguen como unknown. Unknown no está en esta lista escrita de etiquetas del habla.

1. Mire y escuche la misma ventana. Mantenga campos separados.

Un campo es un lugar con nombre en su hoja. Reproduzca los mismos 0-3 segundos. Registre lo que ve en un campo visual. Registre las palabras impresas en la pantalla en su propio campo. Registre a quien habla y los otros sonidos en un campo de audio. Registre la acción significativa más temprana y su tiempo. Esa acción es la primera cosa importante que ocurre en la ventana.

Una demostración silenciosa puede ser un gancho visual aunque el texto de subtítulos esté vacío. Ningún campo de transcripción reconoce una escena. No pegue una nota visual en la etiqueta hablada. Las palabras en pantalla no son palabras habladas. Si no registró un campo, déjelo en blanco. En blanco no es lo mismo que ninguno.

1. Guarde la evidencia, quien codifica y la incertidumbre.

Conserve el texto crudo de los subtítulos. Conserve una nota manual aparte para cualquier corrección. Registre el rango de tiempo, la etiqueta hablada, quien codifica y la incertidumbre. Quien codifica es la persona que asigna la etiqueta. Revise una prueba piloto pequeña con una segunda persona que codifique, o haga una segunda pasada declarada. Si las dos comprobaciones no coinciden, cambie la regla o la nota. No invente una puntuación de exactitud. No reemplace el texto crudo por la copia manual. Necesita ambos.

1. Compare la presencia de etiquetas en la muestra declarada.

Cuente videos únicos. No cuente segmentos de subtítulos. Dos segmentos en una ventana siguen siendo un video. Informe los subtítulos unknown aparte de las aperturas habladas comprobadas. Una proporción usa solo el denominador que usted nombra. El denominador es la cantidad por la que usted divide. Diga ese denominador en el resultado.

Si más adelante compara contadores públicos, empareje la antigüedad del video, el tema y el tiempo. Diga que el emparejamiento solo describe el conjunto. No muestra que una etiqueta haya causado los recuentos. No conserve solo los videos con muchas vistas y llame ganadoras a sus etiquetas. La pregunta sobre retención no prueba una causa, y los me gusta de ahí no muestran la retención.

1. Use la hoja para planear una prueba nueva, no una ganancia garantizada.

Use los códigos y las notas para diseñar una apertura nueva que pueda probar. Una hipótesis sobre las opciones de la apertura es esa idea de prueba. No es una mejora prometida. Este método estudia una apertura que ya está en la fuente. No elige puntos de edición nuevos. No corta un clip nuevo. No predice un éxito viral. No mide la retención. No lee la imagen por usted.

Libro de códigos escrito del habla

Las frases de muestra de este libro de códigos son ficción original. No son palabras del control público. No son un resultado de producto. Cada video recibe una etiqueta hablada primaria.

question_problem es la etiqueta primaria combinada para una pregunta o un problema nombrado. No agregue también una segunda etiqueta hablada para el mismo video. Una frase ficticia es "¿Se vuelca su bandeja?"

promise significa que quien habla dice que un resultado va a llegar, pero el resultado terminado no está en la apertura. Una frase ficticia es "Le voy a mostrar una bandeja nivelada." Eso apunta hacia adelante. No es result-first.

result-first significa que la apertura enuncia ahora el resultado terminado. Una frase ficticia es "Aquí está el cantero terminado." Las palabras ponen el cantero terminado en la apertura. Eso es distinto de una promesa de un resultado posterior.

spoken_demonstration_cue significa que las palabras habladas indican a quien mira que observe una acción. Una frase ficticia es "Mire cómo encaja esta tapa." Una acción silenciosa no recibe esta etiqueta hablada. Ponga esa acción en el campo visual.

other significa que una comprobación válida encontró un recurso hablado claro en la ventana, y ese recurso queda fuera de las categorías nombradas. El recurso es distinto. Agregue una nota breve que nombre el recurso.

no_clear_device significa que una comprobación válida de subtítulos o una comprobación manual válida no encontró ningún recurso hablado en la ventana. Úselo para habla comprobada sin recurso hablado. Úselo también para un silencio confirmado. No lo use cuando falta la evidencia o cuando falló la comprobación de subtítulos. La evidencia faltante o fallida sigue como unknown.

unknown significa que usted no tiene evidencia hablada utilizable. Es una marca de evidencia faltante, no una etiqueta de gancho. Una fila no_public_captions sigue como unknown. No cambie el nombre de unknown a no_clear_device. No cambie el nombre de unknown a "sin gancho". No trate unknown como cero.

Ejemplo resuelto ficticio

Los cuatro videos de abajo son ficción original. No son el control público y no son el resultado de un creador real. La ventana es de 0-3 segundos para cada video. El libro de códigos de arriba es el único libro de códigos escrito del habla. Un video recibe una etiqueta primaria del habla, o unknown.

Conserve un segmento cuando startSeconds sea menor que 3 y endSeconds sea mayor que 0.

V1 tiene dos segmentos, y ambos cumplen la prueba de la ventana. El primero va de 0.0 a 1.5 segundos. Su texto completo es "¿Se vuelca su bandeja?" Ese segmento queda dentro de la ventana. El segundo va de 1.5 a 3.5 segundos. Su texto crudo completo es "Esta asa simple la mantiene nivelada." Conserve esa oración completa en el campo crudo. La oración termina a los 3.5 segundos, así que solo su primer tramo está dentro de la ventana. La nota manual guarda esa comprobación del límite. No corte una parte de las letras y llame a esa parte el habla dentro de la ventana. La etiqueta hablada primaria es question_problem. Los dos segmentos siguen contando como un video. No agregan una segunda etiqueta primaria.

V2 tiene un segmento de 0.0 a 2.0 segundos. El segmento entero está dentro de la ventana. Las palabras enuncian ahora el cantero terminado, así que la etiqueta hablada es result-first. No es promise, porque la apertura no posterga el resultado. El campo visual muestra el cantero terminado como una nota aparte. Esa nota no es una segunda etiqueta hablada.

V3 tiene el status no_public_captions, así que no hay texto de subtítulos para etiquetar. Una revisión manual muestra una demostración silenciosa. Registre eso solo en el campo visual. La marca hablada sigue como unknown. El subtítulo faltante no es silencio hablado, no es no_clear_device y no es un "sin gancho" hablado.

V4 tiene subtítulos con status succeeded, pero el primer subtítulo empieza a los 4.0 segundos. Ningún segmento tiene startSeconds menor que 3, así que ningún texto de subtítulos entra en la ventana. Un primer subtítulo tardío no es una prueba por sí solo. La revisión manual confirma que no hay habla de 0 a 3 segundos. La etiqueta hablada es no_clear_device. Una acción con una regla ocurre a los 1.0 segundos. Eso es una demostración visual. No es spoken_demonstration_cue, porque la ventana no tiene una indicación hablada.

El conjunto tiene 4 videos seleccionados. Los 4 tienen una nota visual manual. Los resultados hablados comprobados son 3: V1, V2 y V4. Los resultados hablados unknown son 1: V3. Uno de los tres videos comprobados es question_problem. La proporción comprobada es 1 de 3, que es el 33.3 por ciento. No informe 1 de 4 por costumbre. Use 4 solo cuando se refiera a todos los videos seleccionados. Aun así debe mostrar el 1 video unknown. V3 no agrega un "sin gancho" hablado. V1 cuenta una vez, aunque tenga dos segmentos. La etiqueta other no se usa en estas cuatro filas. Esta ficción no usa recuentos de vistas y no nombra ninguna etiqueta ganadora.

El texto crudo y la nota manual quedan en campos separados. Este ejemplo no inventa una puntuación de acuerdo. Un segundo codificador, o una segunda pasada, revisaría estas cuatro filas. Un desacuerdo cambiaría la nota o la regla.