> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn 视频转文字

> 获取 LinkedIn 帖子视频的字幕文字。

# LinkedIn 视频转文字

把 LinkedIn 视频里说的话拿成纯文本。传入帖子链接，返回视频自带字幕整理出的文字稿，可以直接引用、总结或检索。越来越多的创始人和高管用视频代替长文发声，用这个接口就能把他们的演讲、产品演示和财报解读，和文字帖子放进同一套分析流程。

```json theme={"dark"}
{
  "urls": [
    "https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go"
  ]
}
```

通过 urls 提供带视频的 LinkedIn 帖子链接，路径格式为 /posts/... 或 /feed/update/urn:li:activity:...。每个带字幕的视频返回一行字幕文字，计 0.7 积分，按实际返回的字幕计费。

## 标准结果字段

任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式，但不会推断或补充来源未提供的数据。如需缩小返回字段集合，MCP 查询使用 `fields`，Typed 工具使用 `_result_fields`，CLI 使用 `--result-fields`。声明字段的值为 `null` 时仍会保留。

| 字段 | 类型 | 可空 | 说明 |
| - | - | - | - |
| `id` | `string` | 是 | 当前结果项的唯一标识。 |
| `platform` | `string` | 否 | 结果所属的平台，例如 `instagram` 或 `linkedin`。 |
| `resource` | `string` | 否 | 该结果对应的 SocQ 资源，例如 `videos` 或 `comments`。 |
| `type` | `string` | 否 | 结果项的类别，例如 `video`、`post` 或 `comment`。 |
| `url` | `string` | 是 | 结果项的公开访问地址（如可获得）。 |
| `published_at` | `string` | 是 | 源内容的发布时间（如可获得），使用 ISO 8601 格式。 |
| `collected_at` | `string` | 否 | SocQ 采集或处理该结果的时间，使用 ISO 8601 格式。 |
| `text` | `string` | 是 | 音频或视频内容的转录文本。 |
| `language` | `string` | 是 | 转录文本的语言（如可获得）。 |
| `format` | `string` | 是 | 转录结果的表示格式，例如纯文本或带时间片段。 |
| `duration_seconds` | `number` | 是 | 时长，单位为秒。 |

以下示例展示任务完成后的响应格式，具体数据以实际查询结果为准。

## 任务完成响应

```json theme={"dark"}
{
  "code": 200,
  "data": {
    "task_id": "example-linkedin-post-transcript",
    "status": "succeeded",
    "public_id": "linkedin/post-transcript",
    "result_count": 1,
    "credits_amount": 0.7,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "transcript",
      "schema_version": "1.0",
      "items": [
        {
          "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. It's very important that the elevators and escalators are available and accessible. What technicians face a mixed portfolio and different technology behind different controllers, different door machines. I have many sources I have to call colleagues, maybe I know a little bit about the unit and we have only a few handwritten notes located at a job site and this is very difficult to work only with that information. My goal is to find out the best information in the best time. Now with the power of AI, it's much better. He gets a briefing via the AI app and that exactly tells the technician or strong recommendation what to do. Based on a strong data from information collected around the world. We created a semantic model that actually is the foundation for Agenti …",
          "language": null,
          "format": "plaintext",
          "duration_seconds": null
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml zh/api-manual/agent-api/agent-api.json POST /v1/linkedin/post-transcript
openapi: 3.1.0
info:
  title: SocQ Agent API 中文版
  version: v1-87892a6484c2
  description: 根据 SocQ 能力目录生成的异步社交数据 API。
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/linkedin/post-transcript:
    post:
      tags:
        - linkedin
      summary: LinkedIn 视频转文字
      description: 获取 LinkedIn 帖子视频的字幕文字。
      operationId: socq_linkedin_post_transcript
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              additionalProperties: false
              properties:
                callback_url:
                  type: string
                  format: uri
                  description: 可选的任务完成回调 URL。
                urls:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 1
                  description: 公开内容、主页或商品 URL 列表。每个 URL 分别应用结果数量上限，至少提供 1 项。
              required:
                - urls
              description: >-
                通过 urls 提供带视频的 LinkedIn 帖子链接，路径格式为 /posts/... 或
                /feed/update/urn:li:activity:...。每个带字幕的视频返回一行字幕文字，计 0.7
                积分，按实际返回的字幕计费。
      responses:
        '200':
          description: 任务已受理
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSubmitResponse'
        '422':
          description: Input validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentValidationErrorResponse'
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    AgentSubmitResponse:
      type: object
      properties:
        code:
          type: integer
          const: 200
          description: HTTP 业务状态码。
        data:
          type: object
          properties:
            task_id:
              type: string
              description: 任务 ID，用于查询任务状态和结果。
            status:
              type: string
              description: 任务当前状态。
            created_time:
              type:
                - string
                - 'null'
              description: 任务创建时间。
          required:
            - task_id
            - status
    AgentValidationErrorResponse:
      type: object
      properties:
        code:
          type: integer
          const: 422
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            details:
              type: object
          required:
            - message
            - type
      required:
        - code
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: '使用 `Authorization: Bearer <token>` 请求头进行身份验证。'
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: 也可以通过 `x-api-key` 请求头提供 API Key。

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.