越来越多的创始人和高管在 LinkedIn 上用视频发言,而不是写长帖。产品演示、演讲和财报解读最终都成了视频,只读取帖子文字的数据流程会漏掉其中说的内容。
SocQ 于 2026-11-17 上线了 LinkedIn Video Transcript API。传入帖子链接,就会从视频附带的字幕中取回文字稿,以纯文本返回,可直接引用、摘要或检索。本文介绍请求方式、返回结果、价格,以及如何把它接入已有的 LinkedIn 数据流程。
快速回答: 把带视频的 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 视频转文字) | 每个带字幕的 LinkedIn 视频一行:纯文本字幕文字、帖子链接,以及可用时的文字稿语言、格式和时长 | 每返回一份文字稿 0.7 积分($0.0035) |
按实际返回的文字稿计费,因此你只为产生结果行的带字幕视频付费。
鉴权与异步任务流程
所有 SocQ 请求都使用 API Key 鉴权,提交、任务状态和结果请求使用同一个请求头:
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 表示 API Key 触发了频率或积分限制。
请求 LinkedIn 视频文字稿
通过 urls 提供带视频的 LinkedIn 帖子链接。两种链接格式都可以:/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 可能会按提交的链接数预留积分,任务结束后按实际 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 视频转文字文档。
接入 LinkedIn 数据流程
文字稿接口处理的是你已有的帖子链接。典型流程如下:
- 找到帖子。 用 LinkedIn Profile Posts API 或 LinkedIn Company Posts API 采集你关注的人或公司的帖子。
- 筛选视频帖。 保留包含视频的帖子。
- 获取文字稿。 把这些链接发送给 LinkedIn Video Transcript API。
- 关联并建索引。 按 URL 把每份文字稿和对应帖子关联起来,把帖子正文和文字稿一起建索引,用于检索、摘要或检索增强生成。
更多关于个人主页、公司、帖子和职位数据的介绍,见 如何用 API 采集 LinkedIn 和 LinkedIn 采集 API 对比。如果你对 YouTube 也做同样的流程,YouTube 字幕指南 更深入地讲解了语言处理和缺失字幕的情况。
使用场景
- 高管与竞品监测: 把领导者在视频中说的话变成可检索的文字,和他们的文字帖放在一起。
- 内容再利用: 把演讲或演示的文字稿作为博客、简报或金句卡片的草稿,并附上来源链接。
- 销售与市场调研: 总结只以视频形式存在的产品发布和客户案例。
- 归档与 RAG: 把文字稿连同帖子 URL 和
collected_at一起保存,让每个生成的回答都能注明出处。
生产环境建议
- 链接去重。 以
/posts/...链接和/feed/update/urn:li:activity:...链接分享的同一条帖子带有相同的 activity ID。提交前先统一格式,避免重复付费。 - 结果行会少于链接数。 只有带字幕的视频才返回结果行。把其余链接标记为没有文字稿,不要反复重试。
- 保留原始文字。 保存返回的原始
text,清洗和分块在派生副本上进行。 - 不要编造时间戳。 示例格式是
plaintext。引用时注明帖子即可,不要标注具体时间位置。
常见问题
什么是 LinkedIn Video Transcript API?
SocQ 的一个接口:接收带视频的 LinkedIn 帖子链接,从视频附带的字幕中以纯文本返回视频里说的话。
支持哪些链接?
带视频的 LinkedIn 帖子链接,格式为 /posts/... 或 /feed/update/urn:li:activity:...。可以在 urls 数组中一次提交多个。
没有字幕的视频收费吗?
按实际返回的文字稿计费。每个带字幕的视频返回一行,计 0.7 积分($0.0035);没有返回结果行的链接不产生按文字稿计的费用。
它会自己转写音频吗?
文字稿来自视频附带的字幕。文档没有说明对无字幕视频的语音转文字兜底。
1,000 份文字稿要多少钱?
每份 0.7 积分,1,000 份共 700 积分,即 $3.50。