TikTok Video Transcript
Los registros de TikTok Video Transcript contienen el habla o los subtítulos disponibles de videos públicos, con idioma, formato de texto sin formato o WebVTT, URL de origen, shortcode y hora de recopilación. Estos registros sirven para buscar contenido hablado, analizar palabras clave y temas, revisar la accesibilidad e investigar citas con enlace a la fuente.
Funcionalidades de la TikTok Video Transcript API
- Consulta de transcripciones de varias URLProcese una o más URL públicas de videos de TikTok en una sola tarea y pase una preferencia de idioma opcional con cada consulta.
- Texto normalizado y procedenciaDevuelve el texto de la transcripción con el idioma, el formato de texto sin formato o WebVTT, la URL de origen, el ID del registro, el shortcode y la hora de recopilación en una estructura uniforme.
- Solo registros disponiblesEmite un resultado únicamente cuando el origen devuelve texto de transcripción no vacío, por lo que la respuesta distingue las transcripciones disponibles sin filas de relleno.
Parámetros de la TikTok Video Transcript API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Una o más URL públicas de videos de TikTok que se puedan resolver, separadas por comas o saltos de línea. |
language | Opcional | Idioma preferido opcional de la transcripción; use un código de dos letras como en, es o fr. |
Cómo usar la TikTok Video Transcript API
Envíe URL públicas conocidas de videos de TikTok como tarea asíncrona, consulte su ID de tarea y concilie los registros de transcripción normalizados con las fuentes solicitadas.
- Prepare una o más URL públicas de videos de TikTok que se puedan resolver y, cuando lo necesite, un código de idioma de dos letras como en.
- Envíe urls y el language opcional por POST a /v1/tiktok/video-transcript y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed; un éxito aún puede contener menos registros que URL enviadas.
- Lea data.results.items, relacione cada url con el conjunto de entrada y siga results.next_cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/tiktok/video-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.tiktok.com/@stoolpresidente/video/7499229683859426602"],"language":"en"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la TikTok Video Transcript API
- Archivos de contenido hablado con búsqueda: Indexe el texto de las transcripciones con las URL de origen, el idioma, el formato, los shortcodes y la hora de recopilación para poder buscar videos públicos seleccionados por los términos hablados.
- Análisis de palabras clave y temas: Analice el texto normalizado de un conjunto conocido de videos para ubicar palabras, frases y temas recurrentes, conservando el enlace de origen para su revisión.
- Revisión de accesibilidad y de citas: Use el texto de transcripción disponible y los metadatos de formato para preparar copias legibles o encontrar pasajes, y luego verifíquelos con el video público enlazado.
Consejos de expertos para la TikTok Video Transcript API
- Valide que cada destino se resuelva en el video público de TikTok previsto antes del envío, porque la solicitud acepta cadenas de URL no vacías sin exigir el host de TikTok ni la ruta /video/{id}.
- Canonice las URL y quite las variantes de seguimiento antes de armar los lotes, porque el recorte de espacios y la deduplicación solo unifican cadenas enviadas idénticas.
- Al elegir un idioma, use un código de dos letras como en y dirija el procesamiento posterior según el campo language devuelto, en lugar de dar por hecho que se cumplió la preferencia.
- Compare los valores de url devueltos con la lista enviada tras el éxito, para que los videos no disponibles, privados, eliminados, restringidos, sin subtítulos o sin habla sigan siendo visibles en su flujo de trabajo.
- Ramifique el análisis según format, conserve las marcas de tiempo de WebVTT cuando existan y use collected_at para el linaje, porque created_at no contiene la hora de publicación del video.
APIs relacionadas
Además de la TikTok Video Transcript API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok.
- TikTok Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, indicadores de cuenta y conteos de audiencia.
- TikTok Comments API — Recolecta comentarios públicos de primer nivel, autores, interacción, menciones e indicadores de interacción del creador.
- TikTok Videos API — Obtiene el creador, la descripción, el contenido multimedia, la música, las etiquetas, las menciones y la interacción desde URLs de videos.
- TikTok User Videos API — Recolecta videos públicos del feed de un perfil por nombre de usuario, con descripciones, creadores, contenido multimedia, marcas de tiempo, interacción y contexto de la cuenta de origen.
- TikTok Trending Feed API — Recolecta el feed actual de videos públicos de una región, con campos de creador, descripción, portada, marca de tiempo e interacción visible.
- TikTok Song API — Obtiene los metadatos de un sonido público por ID de clip o URL de música.
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API