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

# YouTube Transcripts

> Extract a YouTube video's full transcript with timestamps, plus title, description, views, and channel info

`$4.5 / 1k results`

Extract a YouTube video's full transcript with timestamps, plus title, description, views, and channel info

## Endpoint

`POST /api/v1/agents/youtube/video-transcript/run`

## Parameters

<ParamField body="videoUrl" type="string" required>
  **Text** · Any YouTube video URL — full, short link, or shorts.
</ParamField>

<ParamField body="language" type="string">
  **Dropdown** · Pick a transcript language. Leave blank for the video's default.

  <Accordion title="Show all 15 options">
    `en`, `es`, `fr`, `de`, `pt`, `it`, `hi`, `ar`, `ja`, `ko`, `zh`, `ru`, `tr`, `id`, `vi`

    *Legend: `en` = English, `es` = Spanish, `fr` = French, `de` = German, `pt` = Portuguese, `it` = Italian, `hi` = Hindi, `ar` = Arabic, `ja` = Japanese, `ko` = Korean, `zh` = Chinese, `ru` = Russian, `tr` = Turkish, `id` = Indonesian, `vi` = Vietnamese*

    [View all 15 as a structured list →](/agents/youtube/video-transcript/values#language)
  </Accordion>
</ParamField>

## Response columns

| Field                | Display name        | Type    |
| -------------------- | ------------------- | ------- |
| `videoUrl`           | Video URL           | url     |
| `title`              | Title               | text    |
| `transcript`         | Transcript          | text    |
| `description`        | Description         | text    |
| `durationS`          | Duration (s)        | number  |
| `views`              | Views               | number  |
| `likes`              | Likes               | number  |
| `comments`           | Comments            | number  |
| `published`          | Published           | text    |
| `channel`            | Channel             | text    |
| `channelHandle`      | Channel Handle      | text    |
| `subscribers`        | Subscribers         | number  |
| `language`           | Language            | text    |
| `languageCode`       | Language Code       | text    |
| `availableLanguages` | Available Languages | array   |
| `autoGenerated`      | Auto-Generated      | boolean |
| `segments`           | Segments            | object  |
| `thumbnail`          | Thumbnail           | url     |
| `channelThumbnail`   | Channel Thumbnail   | url     |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/youtube/video-transcript/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "channelUrl": "https://www.youtube.com/@MrBeast",
      "language": "en",
      "maxVideos": 10,
      "includeTranscriptText": true
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/youtube/video-transcript/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "channelUrl": "https://www.youtube.com/@MrBeast",
      "language": "en",
      "maxVideos": 10,
      "includeTranscriptText": true
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "videoUrl": "https://www.youtube.com/watch?v=VEGq2Du_HCw",
      "title": "Subscribe for $10,000",
      "transcript": "Whatever subscriber I shoot wins 10 grand. Who did I hit? Right over here. Antonio Safari, you just won $10,000 and you need to hit the subscribe button because in a month I'm going to do this again and your name could end up on that wall. Hit subscribe.",
      "description": "New subscribers will receive an entry for a chance to win by subscribing to the MrBeast YouTube channel between May 1 - May 28, 2026. YouTube account must be set to public and include a valid email address. No purchase necessary. Must be 18+. Full rules at https://bit.ly/mrbeastbowandarrow",
      "durationS": 14,
      "views": 35739180,
      "likes": 615464,
      "comments": 18068,
      "published": "2026-05-01T16:00:01Z",
      "channel": "MrBeast",
      "channelHandle": "mrbeast",
      "subscribers": 481000000,
      "language": "English (auto-generated)",
      "languageCode": "en",
      "availableLanguages": [
        "English (auto-generated)"
      ],
      "autoGenerated": true,
      "segments": [
        {
          "duration": 3.48,
          "end": 3.48,
          "start": 0,
          "text": "Whatever subscriber I shoot wins 10"
        },
        {
          "duration": 3.84,
          "end": 5.84,
          "start": 2,
          "text": "grand."
        },
        {
          "duration": 4.8,
          "end": 8.28,
          "start": 3.48,
          "text": "Who did I hit? Right over here. Antonio"
        },
        {
          "duration": 3.68,
          "end": 9.52,
          "start": 5.84,
          "text": "Safari, you just won $10,000 and you"
        },
        {
          "duration": 2.52,
          "end": 10.8,
          "start": 8.28,
          "text": "need to hit the subscribe button because"
        },
        {
          "duration": 3.12,
          "end": 12.64,
          "start": 9.52,
          "text": "in a month I'm going to do this again"
        },
        {
          "duration": 4.56,
          "end": 15.36,
          "start": 10.8,
          "text": "and your name could end up on that wall."
        },
        {
          "duration": 2.72,
          "end": 15.36,
          "start": 12.64,
          "text": "Hit subscribe."
        }
      ],
      "thumbnail": "https://i.ytimg.com/vi/VEGq2Du_HCw/hqdefault.jpg",
      "channelThumbnail": "https://yt3.ggpht.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s800-c-k-c0x00ffffff-no-rj"
    }
  ]
}
```