API de Transcripción de TikTok

POST

Salud de la API

Salud 24 h: Normal

Saludable / normal
Disponible
Limitada
Casi sin servicio

Últimas 24 horas

Últimos 30 días

Extrae el texto disponible del video indicado por url, con segmentos cuando existen. No garantiza habla reconocible, traducción ni precisión perfecta.

Envía POST https://api.everyinfra.com/api/v1/social con platform igual a tiktok y action igual a transcript. Precio $0.56 por 1.000 solicitudes ($0.000556 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

TikTok Transcripción extrae el texto disponible de un video de TikTok a partir de su url y lo devuelve completo en text, con segments que lo dividen en fragmentos con marca de tiempo cuando existen. has_transcript indica si el video tenía subtítulos de los que sacar el texto. Sirve a investigadores de contenido, equipos de marca y analistas que necesitan lo que se dice en un video y no solo su descripción: comprobar cómo presenta un creador un producto, encontrar menciones de una marca o analizar los temas de los que se habla.

El texto llega en el idioma del video, sin traducir; revisa nombres propios y cifras antes de citarlo. Un video sin habla reconocible, por ejemplo solo con música, puede quedarse sin texto. Con el mismo enlace, TikTok Detalles del video aporta la descripción y las interacciones, y TikTok Comentarios lo que responde el público.

Prompt para IA

Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra TikTok: Transcripción (tiktok/transcript).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en tiktok y action en transcript, y los parámetros dentro de params.
- Parámetros obligatorios:
  - url: Enlace específico de un vídeo de TikTok para video, comments o transcript. comments obtiene los comentarios por vídeo.
- Devuelve un objeto. Campos principales: id, url, text, segments, has_transcript.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "tiktok",
  "action": "transcript",
  "params": {
    "url": "https://www.tiktok.com/@stoolpresidente/video/7488736374602927402"
  }
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

Nombre	Ubicación	Tipo	Obligatorio	Por defecto	Descripción
`Authorization`	header	`string`	Sí	-	Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
`platform`	body	`string`	Sí	`tiktok`	Identificador de la plataforma, valor fijo.
`action`	body	`string`	Sí	`transcript`	Identificador de la capacidad, valor fijo.
`url`	body.params	`string`	Sí	-	Enlace específico de un vídeo de TikTok para `video`, `comments` o `transcript`. `comments` obtiene los comentarios por vídeo; cada comentario de nivel superior incluye como máximo dos respuestas, pero no se garantiza el hilo de conversación completo.

Ejemplos de código

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "tiktok",
  "action": "transcript",
  "params": {
    "url": "https://www.tiktok.com/@stoolpresidente/video/7488736374602927402"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Ejemplo de respuesta

json

{  "id": "req_…",  "platform": "tiktok",  "action": "transcript",  "results": {    "id": "7488736374602927402",    "url": "https://www.tiktok.com/@stoolpresidente/video/7488736374602927402",    "text": "Bagels to make him dance. Bagels to make him dance. Bagels to make him dance. Bagels to make him dance. Bagels to make him dance.",    "segments": [      {        "start": "00:00:00.380",        "end": "00:00:03.600",        "text": "Bagels to make him dance. Bagels to make him dance."      },      {        "start": "00:00:03.700",        "end": "00:00:06.760",        "text": "Bagels to make him dance. Bagels to make him dance."      },      {        "start": "00:00:06.900",        "end": "00:00:08.400",        "text": "Bagels to make him dance."      }    ],    "has_transcript": true,    "platform": "tiktok"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campos de la respuesta

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

Campo	Significado
`id`	Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
`url`	Enlace al registro en la plataforma.
`text`	Texto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma).
`segments`	Conserva el significado de la plataforma
`has_transcript`	Conserva el significado de la plataforma
`platform`	Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Preguntas frecuentes

¿Qué enlace paso en `url`?

El enlace de un video concreto, con la forma https://www.tiktok.com/@usuario/video/<ID del video>. Un perfil, un hashtag o una búsqueda no identifican un video, así que no sirven. El mismo enlace funciona en TikTok Detalles del video y en TikTok Comentarios, lo que te permite reunir el texto, los datos y las reacciones de cada video en una sola pasada.

¿Qué significa que `has_transcript` sea false?

Que el video no tenía subtítulos de los que extraer texto, algo que puede pasar, por ejemplo, en videos solo con música o sin voz. En ese caso no cuentes con contenido en text ni en segments. Si procesas una lista de videos, guarda has_transcript con cada uno para separar los que tienen texto de los que no.

¿Para qué sirven los `segments`?

Cada segmento es un fragmento del texto con su marca de tiempo, así que te dice en qué momento del video se pronuncia cada frase. Úsalos para localizar una mención concreta, recortar el pasaje que te interesa o preparar subtítulos propios; si solo necesitas el texto corrido, text lo trae entero en un bloque.

Errores y facturación

401: Falta la clave o no es válida.
402: Saldo insuficiente. Recarga primero.
422: Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429: Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503: No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío: Sin datos. Sin cargo.

Errores