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

# YouTube transcript

> Full transcript of a YouTube video as timestamped lines and optionally as one plain text block, alongside the video's title, channel, duration, view and like co

Full transcript of a YouTube video as timestamped lines and optionally as one plain text block, alongside the video's title, channel, duration, view and like counts. Can also walk a channel and transcribe its recent videos.

<Note>Use when you need what was actually said in a video: summarising, quoting, fact checking, or turning talks and tutorials into text. Give exactly one of youtube\_url or channel\_url. Each transcribed video is billed as one result.</Note>

## Price

**\$0.0150 per result.** That is the rate you pay for each result the call returns, so the total depends on how many it produces.

Billing follows actual usage, so a call that returns fewer results costs less. `discover` and `inspect` also return a ceiling for your specific request, which is a maximum you will never be charged above.

## Input

| Field                     | Type      | Required | Notes                                                                                                        |
| ------------------------- | --------- | -------- | ------------------------------------------------------------------------------------------------------------ |
| `end_date`                | `string`  |          | Only channel videos uploaded on or before this date (YYYY-MM-DD). channel\_url only                          |
| `language`                | `string`  |          | Transcript language as ISO 639-1, e.g. en or fr. Leave blank for the video's own default                     |
| `max_videos`              | `integer` |          | Maximum videos to transcribe from channel\_url. Ignored for youtube\_url. Billed per video Defaults to `10`. |
| `start_date`              | `string`  |          | Only channel videos uploaded on or after this date (YYYY-MM-DD). channel\_url only                           |
| `channel_url`             | `string`  |          | A YouTube channel URL. Transcribes up to max\_videos of its videos, each billed as its own result            |
| `youtube_url`             | `string`  |          | A single YouTube video URL (watch, youtu.be or shorts). Give this OR channel\_url, never both                |
| `include_transcript_text` | `boolean` |          | Also return the whole transcript as one plain string in transcript\_text Defaults to `false`.                |

<Note>
  Goro forwards your input to the underlying tool unchanged, so any field the
  tool accepts works here even if it is not listed above.
</Note>

## Example

```bash theme={null}
curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"youtube.transcript","input":{"max_videos":3}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "url": "https://www.youtube.com/watch?v=xObhZ0Ga7EQ",
  "title": "How to extract data from YouTube with YouTube Scraper",
  "status": "success",
  "message": "Successfully fetched the transcript for the video with ID 'xObhZ0Ga7EQ'",
  "language": "en",
  "video_id": "xObhZ0Ga7EQ",
  "channel_id": "UCTgwcoeGGKmZ3zzCXN2qo_A",
  "like_count": 78,
  "transcript": [
    {
      "end": 5.44,
      "text": "Hi, welcome to Apify, your one-stop-shop for web scraping and automation.",
      "start": 0.149,
      "duration": 5.291
    }
  ],
  "view_count": 10035,
  "channel_name": "Apify",
  "published_at": "2022-03-15T10:46:41Z",
  "comment_count": 14,
  "transcript_text": "Hi, welcome to Apify, your one-stop-shop for web scraping and automation.",
  "channel_username": "apify",
  "duration_seconds": 175,
  "subscriber_count": 16200,
  "is_auto_generated": false,
  "selected_language": "English",
  "available_languages": [
    "English",
    "English (auto-generated)"
  ]
}
```