Основатели и руководители все чаще выступают в видео на LinkedIn вместо того, чтобы писать длинные публикации. Демонстрации продуктов, выступления и обзоры финансовых результатов превращаются в видео, и конвейер, который читает только текст публикаций, упускает то, что в них было сказано.
2026-11-17 SocQ добавил LinkedIn Video Transcript API. Передайте ссылку на публикацию, и транскрипт вернется из субтитров, прикрепленных к видео, в виде простого текста, который можно цитировать, кратко пересказывать или искать по нему. В этом руководстве разобраны запрос, ответ, цена и то, как встроить эндпоинт в существующий процесс работы с LinkedIn.
Коротко: отправьте URL публикаций LinkedIn с видео в
urlsнаPOST /v1/linkedin/post-transcript. ОпрашивайтеGET /v1/tasks/{task_id}и читайте по одной строке на каждое видео с субтитрами изdata.results.items, текст субтитров находится вtext. Каждый возвращенный транскрипт стоит 0.7 кредита ($0.0035).
Что возвращает эндпоинт
1 кредит SocQ = $0.005.
| Эндпоинт | Что возвращает | Цена |
|---|---|---|
| LinkedIn Video Transcript API | Одна строка на каждое видео LinkedIn с субтитрами: текст субтитров в простом формате, URL публикации, а также язык, формат и длительность транскрипта, если они доступны | 0.7 кредита ($0.0035) за возвращенный транскрипт |
Оплата зависит от числа возвращенных транскриптов, поэтому вы платите за видео с субтитрами, которые дали строку.
Аутентификация и асинхронные задачи
Все запросы к SocQ аутентифицируются API-ключом, и один и тот же заголовок используется для отправки задачи, проверки статуса и получения результатов:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Каждый сбор данных выполняется как фоновая задача:
submit -> task_id -> queued -> running -> succeeded
\-> failed
Ответ на отправку содержит data.task_id и data.status. Опрашивайте задачу по этому ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Когда status равен succeeded, ответ содержит первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500; если has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. Пока задача находится в состоянии queued, running или failed, эндпоинт возвращает метаданные задачи без results.
Необязательный callback_url в теле запроса заставляет SocQ отправить один POST со сводкой задачи после ее завершения; сами записи читайте через GET /v1/tasks/{task_id}. Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же ID задачи, а не платите за дубликат. 402 означает недостаточно кредитов; 429 означает, что ключ достиг лимита запросов или кредитов.
Запрос транскрипта видео LinkedIn
Укажите URL публикаций LinkedIn с видео в urls. Подходят обе формы URL: /posts/... и /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 может зарезервировать кредиты исходя из числа отправленных URL и после завершения задачи рассчитывает итоговое списание по фактическому result_count, возвращая неиспользованные кредиты.
Структура записи транскрипта
Пример из документации возвращает такую строку (текст сокращен):
{
"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
}
Поля:
idиurl: публикация, к которой относится транскрипт. Используйте URL как ключ для связи с вашими данными о публикациях.text: транскрипт звуковой дорожки видео, взятый из его субтитров.language: язык транскрипта, если он доступен. Он может бытьnull, как в примере, поэтому определяйте язык самостоятельно, если маршрутизируете данные по нему.format: представление транскрипта. В примере этоplaintext.duration_seconds: длительность видео, если она доступна.collected_at: когда SocQ собрал строку.
Текст берется из субтитров, прикрепленных к видео, поэтому относитесь к нему так же осторожно, как к любым субтитрам: в нем могут быть ошибки распознавания, особенно в именах людей и названиях компаний. Цитируйте его со ссылкой на публикацию. Полная схема: документация LinkedIn Video Transcript.
Встраивание в процесс работы с LinkedIn
Эндпоинт транскриптов работает с URL публикаций, которые у вас уже есть. Типичный конвейер:
- Найдите публикации. Соберите публикации людей или компаний, за которыми вы следите, через LinkedIn Profile Posts API или LinkedIn Company Posts API.
- Отберите публикации с видео. Оставьте публикации, которые содержат видео.
- Получите транскрипты. Отправьте эти URL в LinkedIn Video Transcript API.
- Свяжите и проиндексируйте. Свяжите каждый транскрипт с его публикацией по URL и индексируйте текст публикации и транскрипт вместе для поиска, кратких пересказов или генерации с дополненной выборкой (RAG).
Более широкий обзор данных о профилях, компаниях, публикациях и вакансиях — в статьях как парсить LinkedIn через API и сравнение API для парсинга LinkedIn. Если вы строите такой же конвейер для YouTube, в руководстве по транскриптам YouTube подробнее разобраны обработка языков и отсутствующие субтитры.
Сценарии использования
- Мониторинг руководителей и конкурентов. Превращайте то, что лидеры говорят в видео, в текст, по которому можно искать вместе с их письменными публикациями.
- Переработка контента. Получайте транскрипт выступления или демо как черновик для статьи в блоге, рассылки или карточки с цитатой, с прикрепленной ссылкой на источник.
- Продажи и исследование рынка. Кратко пересказывайте анонсы продуктов и истории клиентов, которые существуют только в виде видео.
- Архивы и RAG. Храните транскрипты вместе с URL публикации и
collected_at, чтобы каждый сгенерированный ответ мог сослаться на источник.
Советы для продакшена
- Удаляйте дубликаты URL. Публикация, которой поделились как ссылкой
/posts/...и как ссылкой/feed/update/urn:li:activity:..., имеет один и тот же ID активности. Нормализуйте URL перед отправкой, чтобы не платить дважды. - Рассчитывайте на меньшее число строк, чем URL. Строку возвращают только видео с субтитрами. Отмечайте остальные как не имеющие транскрипта, а не повторяйте запрос.
- Храните текст в исходном виде. Сохраняйте оригинальный
text; очистку и разбиение на фрагменты выполняйте в производной копии. - Не придумывайте временные метки. В примере формат —
plaintext. Ссылайтесь на публикацию, а не на позицию во времени.
FAQ
Что такое LinkedIn Video Transcript API?
Это эндпоинт SocQ, который принимает URL публикаций LinkedIn с видео и возвращает произнесенный в видео текст в простом формате на основе прикрепленных к нему субтитров.
Какие URL он принимает?
URL публикаций LinkedIn с видео в форме /posts/... или /feed/update/urn:li:activity:.... Передавайте несколько URL в массиве urls.
Списываются ли кредиты за видео без субтитров?
Оплата зависит от числа возвращенных транскриптов. Каждое видео с субтитрами возвращает одну строку и стоит 0.7 кредита ($0.0035); URL, по которому строка не вернулась, не добавляет оплаты за транскрипт.
Распознает ли он речь самостоятельно?
Транскрипт берется из субтитров, прикрепленных к видео. В документации не описано резервное распознавание речи для видео без субтитров.
Сколько стоят 1,000 транскриптов?
При цене 0.7 кредита за штуку 1,000 транскриптов стоят 700 кредитов, или $3.50.
LINKEDIN API
Проверить сценарий на публичном URL LinkedIn
Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.
API для LinkedIn