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
urlslas URLs de publicaciones de LinkedIn que contengan un video aPOST /v1/linkedin/post-transcript. ConsulteGET /v1/tasks/{task_id}y lea una fila por cada video subtitulado endata.results.items, con el texto de los subtítulos entext. Cada transcripción devuelta cuesta 0.7 créditos ($0.0035).
Qué devuelve el endpoint
1 crédito de SocQ = $0.005.
| Endpoint | Qué devuelve | Precio |
|---|---|---|
| LinkedIn Video Transcript API | Una 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 disponibles | 0.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:
idyurl: 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 sernull, 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 esplaintext.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:
- Encontrar publicaciones. Recopile las publicaciones de las personas o empresas que sigue con la LinkedIn Profile Posts API o la LinkedIn Company Posts API.
- Seleccionar las publicaciones con video. Conserve las publicaciones que contienen un video.
- Obtener las transcripciones. Envíe esas URLs a la LinkedIn Video Transcript API.
- 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_atpara que cada respuesta generada pueda citar su fuente.
Consejos para producción
- 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. - 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.
- Conserve el texto tal como se devuelve. Guarde el
textoriginal; haga la limpieza y la división en fragmentos sobre una copia derivada. - 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