tiktok/
video-transcript

Extraiga transcripciones de URL públicas de videos de TikTok con un idioma opcional, y obtenga texto, idioma, formato, enlaces de origen y hora de recopilación como registros normalizados.

TikTok Video Transcript API

Transcripción de video
Idioma opcional
Texto sin formato o WebVTT
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioUna o más URL públicas de videos de TikTok que se puedan resolver, separadas por comas o saltos de línea.
languageOpcionalIdioma 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.

  1. 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.
  2. Envíe urls y el language opcional por POST a /v1/tiktok/video-transcript y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed; un éxito aún puede contener menos registros que URL enviadas.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de TikTok con datos públicos de otras plataformas sociales compatibles.

TikTok Video Transcript API — FAQ

TikTok Video Transcript API es una interfaz para extraer el texto de transcripción disponible de una o más URL públicas de videos de TikTok, con una preferencia de idioma opcional. Devuelve texto normalizado, idioma, formato de texto sin formato o WebVTT, URL de origen, shortcode y hora de recopilación cuando hay texto de transcripción no vacío.

Envíe una lista urls no vacía y, de forma opcional, una cadena language. El endpoint no acepta results_limit, usernames, consultas de búsqueda, ajustes de descarga de medios ni un interruptor de alternativa con IA.

Cada registro incluye id, platform, resource, type, url, text, language (que puede ser nulo), format, created_at, collected_at y extra.shortcode. No conserva descripciones de videos, autores, métricas de interacción, imágenes de portada, URL de descarga ni objetos de segmentos con tiempos.

Solo se crea un registro cuando el origen devuelve texto de transcripción no vacío. Por eso, los videos sin habla ni subtítulos accesibles, y los destinos privados, eliminados, restringidos o no disponibles, pueden no dejar ninguna fila de relleno.

No. Use una preferencia de dos letras como en, es o fr y luego revise el campo language devuelto; la disponibilidad de idiomas y la precisión de la transcripción dependen del origen accesible.

El uso cuesta 0.5 créditos por cada registro de transcripción normalizado devuelto, sin cargo base. Una URL de entrada que no produce ningún registro no genera cargo por resultado según la política vigente de resultados vacíos.