LinkedInTranscripciones de videoSubtítulosEscucha socialGuía de API

API de transcripciones de videos de LinkedIn: convierta los subtítulos de videos de LinkedIn en texto

Obtenga como texto plano lo que se dice en los videos de LinkedIn a partir de la URL de la publicación. Envíe URLs en bloque y pague 0.7 créditos por cada video subtitulado devuelto.

SocQActualizado el 19 de noviembre de 20267 min de lectura

Cada vez más fundadores y directivos hablan en videos de LinkedIn en lugar de escribir publicaciones largas. Demostraciones de producto, charlas y resúmenes de resultados terminan publicados como video, y una canalización que solo lee el texto de las publicaciones se pierde lo que se dijo en ellos.

El 2026-11-17 SocQ añadió la LinkedIn Video Transcript API. Pase el enlace de la publicación y recibirá la transcripción a partir de los subtítulos asociados al video, como texto plano listo para citar, resumir o buscar. Esta guía cubre la solicitud, la respuesta, el precio y cómo integrarla en un flujo de trabajo de LinkedIn ya existente.

Respuesta rápida: envíe en urls las URLs de publicaciones de LinkedIn que contengan un video a POST /v1/linkedin/post-transcript. Consulte GET /v1/tasks/{task_id} y lea una fila por cada video subtitulado en data.results.items, con el texto de los subtítulos en text. Cada transcripción devuelta cuesta 0.7 créditos ($0.0035).

Qué devuelve el endpoint

1 crédito de SocQ = $0.005.

EndpointQué devuelvePrecio
LinkedIn Video Transcript APIUna fila por cada video de LinkedIn con subtítulos: el texto de los subtítulos como texto plano, la URL de la publicación y el idioma, formato y duración de la transcripción cuando están disponibles0.7 créditos ($0.0035) por transcripción devuelta

El cobro se basa en las transcripciones devueltas, así que paga por los videos subtitulados que generan una fila.

Autenticación y flujo de tareas asíncronas

Todas las solicitudes a SocQ se autentican con una clave de API, y se usa el mismo encabezado para el envío, el estado de la tarea y las solicitudes de resultados:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Cada recopilación se ejecuta como una tarea en segundo plano:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

La respuesta del envío contiene data.task_id y data.status. Consulte la tarea con ese ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Cuando status es succeeded, la respuesta incluye la primera página de registros normalizados en data.results.items. limit vale 50 por defecto y admite hasta 500; si has_more es verdadero, pase results.next_cursor como cursor para leer la página siguiente. Mientras una tarea está en queued, running o failed, el endpoint devuelve los metadatos de la tarea sin results.

Un callback_url opcional en el cuerpo del envío hace que SocQ envíe un POST con un resumen de la tarea cuando esta termina; lea los registros con GET /v1/tasks/{task_id}. Un tiempo de espera agotado en el cliente no cancela la tarea, así que retome con el mismo ID de tarea en lugar de pagar por un duplicado. 402 significa créditos insuficientes; 429 significa que la clave alcanzó un límite de solicitudes o de créditos.

Solicitar la transcripción de un video de LinkedIn

Indique en urls las URLs de publicaciones de LinkedIn que contengan un video. Funcionan los dos formatos de URL: /posts/... y /feed/update/urn:li:activity:....

curl -X POST "https://api.socq.ai/v1/linkedin/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go"
    ]
  }'

SocQ puede reservar créditos según el número de URLs enviadas y liquida el cargo final a partir del result_count real cuando la tarea termina, devolviendo los créditos no utilizados.

Entender el registro de la transcripción

El ejemplo de la documentación devuelve esta fila (texto acortado):

{
  "id": "https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go",
  "platform": "linkedin",
  "resource": "post-transcript",
  "type": "transcript",
  "url": "https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go",
  "published_at": null,
  "collected_at": "2026-11-17T14:40:24.363764Z",
  "text": "TKL Rate is one of the leading companies in global infrastructure and mobility. ...",
  "language": null,
  "format": "plaintext",
  "duration_seconds": null
}

Los campos:

  • id y url: la publicación a la que pertenece la transcripción. Use la URL como clave para unirla con sus datos de publicaciones.
  • text: la transcripción del audio del video, tomada de sus subtítulos.
  • language: el idioma de la transcripción cuando está disponible. Puede ser null, como en el ejemplo, así que detecte el idioma por su cuenta si enruta según él.
  • format: cómo se representa la transcripción. En el ejemplo es plaintext.
  • duration_seconds: la duración del video cuando está disponible.
  • collected_at: cuándo recopiló SocQ la fila.

El texto procede de los subtítulos asociados al video, así que trátelo con el mismo cuidado que cualquier subtítulo: puede contener errores de reconocimiento, sobre todo en nombres de personas y empresas. Cítelo con un enlace a la publicación. Esquema completo: documentación de LinkedIn Video Transcript.

Integrarla en un flujo de trabajo de LinkedIn

El endpoint de transcripciones trabaja con URLs de publicaciones que usted ya tiene. Una canalización típica:

  1. Encontrar publicaciones. Recopile las publicaciones de las personas o empresas que sigue con la LinkedIn Profile Posts API o la LinkedIn Company Posts API.
  2. Seleccionar las publicaciones con video. Conserve las publicaciones que contienen un video.
  3. Obtener las transcripciones. Envíe esas URLs a la LinkedIn Video Transcript API.
  4. Unir e indexar. Una cada transcripción con su publicación por URL e indexe juntos el texto de la publicación y la transcripción para búsqueda, resúmenes o generación aumentada por recuperación.

Para un recorrido más amplio por los datos de perfiles, empresas, publicaciones y empleos, consulte cómo hacer scraping de LinkedIn con una API y la comparativa de APIs de scraping de LinkedIn. Si ejecuta la misma canalización para YouTube, la guía de transcripciones de YouTube trata con más detalle el manejo de idiomas y los subtítulos ausentes.

Casos de uso

  • Seguimiento de directivos y competidores. Convierta lo que dicen los líderes en video en texto buscable junto a sus publicaciones escritas.
  • Reutilización de contenido. Obtenga la transcripción de una charla o demostración como borrador para un artículo de blog, un boletín o una tarjeta de cita, con el enlace de origen adjunto.
  • Ventas e investigación de mercado. Resuma anuncios de producto e historias de clientes que solo existen en video.
  • Archivos y RAG. Guarde las transcripciones con la URL de la publicación y collected_at para que cada respuesta generada pueda citar su fuente.

Consejos para producción

  1. Elimine URLs duplicadas. Una publicación compartida como enlace /posts/... y como enlace /feed/update/urn:li:activity:... tiene el mismo ID de actividad. Normalice antes de enviar para no pagar dos veces.
  2. Espere menos filas que URLs. Solo los videos con subtítulos devuelven una fila. Marque los demás como sin transcripción en lugar de reintentarlos.
  3. Conserve el texto tal como se devuelve. Guarde el text original; haga la limpieza y la división en fragmentos sobre una copia derivada.
  4. No invente marcas de tiempo. El formato del ejemplo es plaintext. Cite la publicación, no una posición temporal.

Preguntas frecuentes

¿Qué es la LinkedIn Video Transcript API?

Un endpoint de SocQ que recibe URLs de publicaciones de LinkedIn que contienen un video y devuelve como texto plano lo que se dice en el video, a partir de los subtítulos asociados.

¿Qué URLs acepta?

URLs de publicaciones de LinkedIn que contengan un video, con el formato /posts/... o /feed/update/urn:li:activity:.... Envíe varias en el array urls.

¿Se me cobra por los videos sin subtítulos?

El cobro se basa en las transcripciones devueltas. Cada video con subtítulos devuelve una fila y cuesta 0.7 créditos ($0.0035); una URL que no devuelve ninguna fila no añade cargo por transcripción.

¿Transcribe el audio por sí misma?

La transcripción procede de los subtítulos asociados al video. La documentación no describe una alternativa de voz a texto para videos sin subtítulos.

¿Cuánto cuestan 1,000 transcripciones?

A 0.7 créditos cada una, 1,000 transcripciones cuestan 700 créditos, es decir, $3.50.

LINKEDIN API

Probar el flujo de trabajo con una URL pública de LinkedIn

Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.

Ver las API de LinkedIn