> ## 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.

# Twitter Video Transcript

> Turn the speech in X videos into text.

# Twitter Video Transcript

Turn the speech in an X video into text. Pass the link of a post that contains a video and get back the transcript as plain text together with the video's length in seconds. Transcripts make video content searchable and quotable: pull the exact wording of an interview clip, summarize a product demo, translate a speech, or feed spoken content into the same analysis you already run on written posts.

```json theme={"dark"}
{
  "urls": [
    "https://x.com/NASA/status/2119833829389041896"
  ]
}
```

Provide X post URLs that contain a video in urls, using /{username}/status/{post_id}. Each video returns its spoken text and duration. A video up to 2 minutes costs 0.7 credits; a longer video costs 4 credits for every started minute of its full length, so a 3-minute video costs 12 credits. Posts without a video return no row and are not charged.

## Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use `fields` for MCP queries, `_result_fields` for typed tools, or `--result-fields` in the CLI. Declared fields remain present when their value is `null`.

| Field | Type | Nullable | Description |
| - | - | - | - |
| `id` | `string` | Yes | Unique identifier for this result item. |
| `platform` | `string` | No | Platform the result belongs to, such as `instagram` or `linkedin`. |
| `resource` | `string` | No | SocQ resource represented by the result, such as `videos` or `comments`. |
| `type` | `string` | No | Category of the result item, such as `video`, `post`, or `comment`. |
| `url` | `string` | Yes | Public URL of the result item when available. |
| `published_at` | `string` | Yes | Time the source item was published, in ISO 8601 format when available. |
| `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. |
| `text` | `string` | Yes | Transcript text for the audio or video content. |
| `language` | `string` | Yes | Language of the transcript when available. |
| `format` | `string` | Yes | Transcript representation, such as plain text or timed segments. |
| `duration_seconds` | `number` | Yes | Duration in seconds. |

The following example shows the response format for a completed task. Actual data depends on your query.

## Completed Task Response

```json theme={"dark"}
{
  "code": 200,
  "data": {
    "task_id": "example-x-post-transcript",
    "status": "succeeded",
    "public_id": "x/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": "2119833829389041896",
          "platform": "x",
          "resource": "post-transcript",
          "type": "transcript",
          "url": "https://x.com/NASA/status/2119833829389041896",
          "published_at": null,
          "collected_at": "2026-11-13T10:15:28Z",
          "text": "Welcome to Max Power. NASA lit the fires and hosted a four-day showcase of American excellence in air and space right here at Kennedy Space Center. At Up Summit, government and industry came together to align around the technology that will ensure American leadership across the most demanding and exciting domains: from cars that do not require roads, drones that deliver packages, and spacecraft that bring us closer to the stars. Then, AirDot Show took over the skies, bringing some serious American air power and inspiration to thousands of visitors across the Space Coast. And throughout it all, young people, the next generation, met astronauts, pilots, engineers. They saw the machines shaping our future and got a glimpse of the near-limitless world they will inherit. Max Power was only the beginning. With President Trump, we announced Cape Week: what will become the grandest exposition of aerospace technology the world has ever seen. And it begins in March 2028. America is building a new golden age of exploration and discovery, and now every child will have a front-row seat to the greatest adventure in human history.",
          "language": null,
          "format": "text",
          "duration_seconds": 86.709
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/x/post-transcript
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-1fa58609f514
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/x/post-transcript:
    post:
      tags:
        - x
      summary: Twitter Video Transcript API
      description: Turn the speech in X videos into text.
      operationId: socq_x_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
                urls:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 1
                  description: Public profile or content URLs.
              required:
                - urls
              description: >-
                Provide X post URLs that contain a video in urls, using
                /{username}/status/{post_id}. Each video returns its spoken text
                and duration.
      responses:
        '200':
          description: Task accepted
          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
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type:
                - string
                - 'null'
          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
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

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