# YouTube Transcript & Subtitles Scraper: Text, SRT, Metadata (`tablewise/youtube-transcript-scraper`) Actor

Get the transcript of any YouTube video, Short or whole channel as text, timestamped segments, SRT or VTT, with title, channel, views, likes and publish date. Creator or auto-generated subtitles, any language. Videos without a transcript are free.

- **URL**: https://apify.com/tablewise/youtube-transcript-scraper.md
- **Developed by:** [table wise](https://apify.com/tablewise) (community)
- **Categories:** Videos, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 video with transcripts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What is YouTube Transcript & Subtitles Scraper?

YouTube Transcript & Subtitles Scraper downloads the transcript of any public
YouTube video, as plain text, timestamped segments, SRT or WebVTT, together
with the video's title, channel, views, likes, duration and publish date.
In our test on Apify it returned the transcript of 298 of 300 videos from six
channels (English and Spanish, creator-written and auto-generated subtitles)
in 7 minutes, for USD 0.005 per video.

Paste video URLs (watch, youtu.be, Shorts, embed or live links), video IDs or
whole channels (`@TED`): for a channel it takes its newest videos. You get
one row per video, and videos without a transcript come back with the reason
and are free. No YouTube account and no API key; export as JSON, CSV or
Excel, or read the results through the API.

### What you can do with it

- **Feed videos to an LLM or a RAG pipeline:** clean text of talks,
  tutorials, podcasts and news, with the source URL and channel.
- **Research and content analysis:** every video of a channel, with views,
  likes and publish date next to what was said.
- **Subtitles for editing or translation work:** SRT and WebVTT files with
  the original timing.
- **Find what a video says without watching it:** quotes, mentions of a
  brand or a product, and the exact second they were said.

### Use cases

Ready-to-run examples, with the input already filled in:

- [Get YouTube video transcripts as plain text](https://apify.com/tablewise/youtube-transcript-scraper/examples/youtube-video-transcripts-as-text):
  the English transcript of a TED talk as plain text and timestamped segments, with the video details.
- [Download YouTube subtitles as SRT and VTT files](https://apify.com/tablewise/youtube-transcript-scraper/examples/download-youtube-subtitles-as-srt):
  the same talk as SRT and WebVTT subtitle files, ready for video editors and players.

### Example output

Two real rows from our test run (shortened: `transcript`, `segments`,
`description` and `available_languages` come complete).

```json
[
  {
    "video_id": "Pba4OZjn3cY",
    "url": "https://www.youtube.com/watch?v=Pba4OZjn3cY",
    "title": "Why It’s So Hard to Listen When You Disagree | Emily Kasriel | TED",
    "channel_name": "TED",
    "channel_id": "UCAuUUnT6oDeKwE6v1NGQxug",
    "channel_url": "https://www.youtube.com/channel/UCAuUUnT6oDeKwE6v1NGQxug",
    "published_date": "2026-10-26",
    "duration_seconds": 651,
    "view_count": 128272,
    "like_count": 1172,
    "channel_subscribers": 28000000,
    "keywords": ["TEDTalk", "TEDTalks", "TED Talk"],
    "is_live": false,
    "thumbnail_url": "https://i.ytimg.com/vi/Pba4OZjn3cY/hqdefault.jpg",
    "language": "en",
    "language_name": "English",
    "is_auto_generated": false,
    "is_translated": false,
    "available_languages": [
      {"language": "ar", "name": "Arabic", "auto_generated": false, "original": false},
      {"language": "en", "name": "English", "auto_generated": false, "original": true}
    ],
    "transcript": "You know, there's something quite strange going on, because most of us believe we should be better listeners, but, as I found in my research, we find it so hard...",
    "segments": [
      {"start": 4.502, "duration": 3.803, "text": "You know, there's something\nquite strange going on,"},
      {"start": 8.339, "duration": 3.37, "text": "because most of us believe\nwe should be better listeners,"}
    ],
    "segment_count": 194,
    "source": "@TED",
    "status": "ok",
    "status_message": null,
    "scraped_at": "2026-11-16T15:47:17Z"
  },
  {
    "video_id": "gSCglYuoTCs",
    "title": "Barateando en el mercado de oro más grande del mundo | DUBAI 🇦🇪",
    "channel_name": "Luisito Comunica",
    "published_date": "2026-01-13",
    "duration_seconds": 1336,
    "view_count": 7805974,
    "like_count": 88840,
    "language": "es",
    "language_name": "Spanish (auto-generated)",
    "is_auto_generated": true,
    "transcript": "En este mercado se vende más oro que en cualquier otra parte del mundo y nuestra misión será conseguir el mejor precio posible...",
    "segment_count": 618,
    "status": "ok"
  }
]
```

| Field | What it is |
| --- | --- |
| `video_id`, `url` | YouTube video ID and link |
| `title`, `description`, `keywords` | As published by the creator |
| `channel_name`, `channel_id`, `channel_url` | The channel that published the video |
| `published_date` | Publish date (`YYYY-MM-DD`) |
| `duration_seconds`, `view_count`, `like_count` | Length, views and likes when the row was produced |
| `channel_subscribers` | Subscribers of the channel, as a number (YouTube rounds it) |
| `is_live`, `thumbnail_url` | Live stream or not; thumbnail image |
| `language`, `language_name` | Language of the transcript, as YouTube labels the track |
| `is_auto_generated` | `true` for YouTube's automatic captions, `false` when the creator wrote the subtitles |
| `is_translated`, `translated_from` | When you ask for a translation: whether YouTube translated it and from which language |
| `available_languages` | Every subtitle track of the video (language, name, auto-generated, original language) |
| `transcript` | The whole transcript as plain text |
| `segments` | Each caption line with `start` and `duration` in seconds |
| `srt`, `vtt` | Subtitle files as text, if you choose those formats |
| `segment_count` | Number of caption lines |
| `source` | The input line the video came from (the video URL or the channel) |
| `status`, `status_message` | `ok` or why there is no transcript (table below) |
| `scraped_at` | When the row was produced (UTC) |

You get one row per video. Only `ok` rows are charged:

| `status` | What it means | Charged? |
| --- | --- | --- |
| `ok` | Transcript delivered | Yes |
| `no_captions` | The video has no subtitles (often music or videos without speech), or none in the languages or type you asked for; the message lists the ones it has | No |
| `age_restricted` | YouTube requires signing in to watch it | No |
| `unavailable` | Private, removed or not available in the proxy's country | No |
| `blocked` | YouTube refused our requests for this video, also from other IP addresses | No |
| `tracks_listed` | With **Only list available subtitles**: the message lists them | No |
| `not_found` | The channel does not exist | No |
| `invalid_input` | Not a YouTube video URL, video ID or channel | No |
| `error` | YouTube did not answer or answered with an error | No |

### What it costs

| Event | Price |
| --- | --- |
| Actor start | USD 0.0005 per run |
| Video with transcript | USD 0.005 per video |

**Example:** 1,000 videos with transcripts = 0.0005 + 1,000 × 0.005 = USD 5.00.

The video data (title, views, likes, date...) and all four formats are
included at the same price. Videos without a transcript, private, removed,
age-restricted or blocked cost nothing, and so does listing the available
subtitles. Use **Max videos in total** to cap the spend.

#### How many transcripts can I get with the free plan?

Apify's free plan includes USD 5 of credit every month. Used only for this
Actor, that is about 990 transcripts: for example, one run of 990 videos =
0.0005 + 990 × 0.005 = USD 4.95.

### How to use it

1. Paste video URLs, video IDs or channels into **YouTube videos or
   channels**, one per line.
2. Optional: **Preferred languages** (for example `en`, then `es`),
   **Transcript type** (manual, auto-generated or any), **Transcript
   formats**, **Max videos per channel**.
3. Click **Start** and download the results as JSON, CSV or Excel.

#### Input

| Field | Type | Default | What it does |
| --- | --- | --- | --- |
| `urls` | array | — | Video URLs (watch, youtu.be, Shorts, embed, live), video IDs or channels (`@TED`, `https://www.youtube.com/@TED`) |
| `languages` | array | — | Language codes in order of preference; `es` also matches `es-419` and `es-ES`. Empty: the video's original language |
| `transcriptType` | string | `any` | `any` (creator subtitles first), `manual` or `auto` |
| `translateTo` | string | — | Language code for YouTube's machine translation (see the limits below) |
| `outputFormats` | array | `["text", "segments"]` | Any of `text`, `segments`, `srt`, `vtt` |
| `includeVideoDetails` | boolean | `true` | Adds publish date, likes and the channel's subscribers |
| `listTracksOnly` | boolean | `false` | Only list the subtitles each video has, for free |
| `maxVideosPerChannel` | integer | 20 | Newest videos taken from each channel |
| `maxVideos` | integer | 1000 | Videos in the whole run |
| `proxyConfiguration` | object | residential, United States | Proxy for the subtitle requests (its cost is included in the price) |

### Speed and reliability

Four videos are processed at a time. In our tests on Apify: 300 videos
from six channels in 7 minutes (298 with transcript, one without subtitles,
one age-restricted); the 200 newest videos of a channel in under 8 minutes
(199 with transcript); 150 videos in 2.5 minutes. The original language is
picked even when YouTube adds automatic dubbing tracks in 20 other
languages. An aborted and resumed run continues where it stopped, without
duplicate rows or double charges.

YouTube asks cloud servers to "confirm you're not a bot". The subtitle
requests go through the residential proxy, and when YouTube still asks, the
request is repeated from another IP address: in our tests that was enough
for every video but the age-restricted ones.

### Limits and known issues

- **Only existing subtitles.** It does not transcribe audio and does not
  download videos. Videos without subtitles come back as `no_captions`,
  free.
- **Translation is unreliable.** YouTube refuses most machine-translation
  requests from servers: in our tests 1 of every 3 videos was translated;
  the others came back as `blocked`, free. If you need the original
  language, leave **Translate to** empty.
- **The language is the one YouTube gives the track.** In 1 of 300 videos
  YouTube labeled the automatic captions of an English talk as Swedish.
- **Age-restricted and private videos** need a signed-in account: they come
  back as `age_restricted` or `unavailable`.
- Availability depends on the proxy's country (United States by default):
  some videos are blocked in some countries.
- Likes and subscribers are what YouTube shows (subscribers are rounded:
  "4.56 million").

### FAQ

#### Do I need a YouTube account or an API key?

No. It reads public videos without signing in, through the same requests
YouTube's own Android app makes.

#### Is it legal to scrape YouTube transcripts?

This Actor reads public videos without logging in. A transcript is the
creator's work: you are responsible for how you use it (quoting, research
and analysis are common uses; republishing a whole transcript may need the
creator's permission). YouTube's robots.txt disallows automated access to
the subtitle files, which in the EU can reserve them from commercial text
and data mining. YouTube's terms do not allow automated access; they apply
to the people who accepted them. If you are not sure, ask a lawyer.

#### Can I get all the transcripts of a channel?

Yes. Put the channel (`@handle` or its URL) and set **Max videos per
channel**. Its newest videos come first.

#### Can I run it from the API or from Python?

Yes: with the Apify API or the official Apify clients for Python and
JavaScript. This call runs the Actor and returns the rows when it finishes
(it waits up to 5 minutes; for longer runs, start the run and read its
dataset when it ends):

```bash
curl -X POST "https://api.apify.com/v2/acts/tablewise~youtube-transcript-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://www.youtube.com/watch?v=Pba4OZjn3cY"], "outputFormats": ["text"]}'
```

#### Can AI agents use it?

Yes. AI agents can find and run it through Apify's MCP server
(`https://mcp.apify.com`). Every output field has a description, so an agent
knows what each value means.

### Support

Found a problem? Open an issue on the Actor's **Issues** tab with the run ID
and we'll look into it.

### More Actors from the same developer

- [Google Trends Scraper](https://apify.com/tablewise/google-trends-scraper): interest over time, interest by region and related queries for any keyword.
- [Semrush Domain Metrics Scraper](https://apify.com/tablewise/semrush-domain-metrics-scraper): Authority Score, backlinks, referring domains and traffic for any list of domains.
- [Website Email & Contact Scraper](https://apify.com/tablewise/website-email-contact-scraper): emails, phones and social profiles from any list of websites.
- [LinkedIn Company Scraper](https://apify.com/tablewise/linkedin-company-scraper): size, industry, employees, website and offices of any LinkedIn company page.
- [LinkedIn Jobs Scraper](https://apify.com/tablewise/linkedin-jobs-scraper): LinkedIn job postings with full description, salary, seniority and applicants, without login.
- [Company Jobs Scraper: Workday, Greenhouse, Lever & Ashby](https://apify.com/tablewise/workday-greenhouse-lever-jobs-scraper): every open job from company careers sites on those four platforms.
- [Google Hotels Scraper](https://apify.com/tablewise/google-hotels-scraper): hotel prices for your dates, ratings and prices by booking site.
- [AliExpress Search Scraper](https://apify.com/tablewise/aliexpress-search-scraper): prices, discounts, ratings and units sold from any AliExpress search.
- [Amazon Best Sellers Scraper](https://apify.com/tablewise/amazon-bestsellers-scraper): the top 100 of any Amazon.com Best Sellers or Hot New Releases list.
- [Amazon Product Details Scraper](https://apify.com/tablewise/amazon-product-details-scraper): price, Best Sellers Rank, specs and images for any list of ASINs.
- [Tennis Results & Odds Scraper](https://apify.com/tablewise/tennis-results-scraper): ATP, WTA, Challenger and ITF results and fixtures with set scores and betting odds.

# Actor input Schema

## `urls` (type: `array`):

One per line: video URLs (watch, youtu.be, Shorts, embed, live), video IDs (dQw4w9WgXcQ), or channels (https://www.youtube.com/@TED or @TED). For a channel, its newest videos are taken (see Max videos per channel). Duplicates are removed.

## `languages` (type: `array`):

Language codes in order of preference (en, es, pt-BR...). The first one the video has is used; es also matches es-419 and es-ES. Leave empty for the video's original language.

## `transcriptType` (type: `string`):

Any: subtitles written by the creator first, auto-generated if there are none. Manual: only creator subtitles. Auto-generated: only YouTube's automatic captions.

## `translateTo` (type: `string`):

Language code (es, fr, de...) to get the transcript translated by YouTube's own machine translation. Unreliable: YouTube refuses many translation requests from servers (2 of 3 in our tests); those videos come back with status blocked and are not charged. Empty: no translation.

## `outputFormats` (type: `array`):

Formats added to each row. text: the whole transcript as one string. segments: each caption line with start and duration in seconds. srt and vtt: subtitle files as text.

## `includeVideoDetails` (type: `boolean`):

Reads the video page for publish date, like count and the channel's subscribers. Title, channel, views, duration, description and keywords come always. Same price.

## `listTracksOnly` (type: `boolean`):

Returns the subtitle languages each video has, without downloading any transcript. Not charged.

## `maxVideosPerChannel` (type: `integer`):

For each channel, take this many of its newest videos.

## `maxVideos` (type: `integer`):

Stops after this many videos in the whole run. Use it to cap the spend.

## `proxyConfiguration` (type: `object`):

Proxy for the subtitle requests. YouTube asks cloud servers to sign in ('confirm you're not a bot'); residential proxy avoids it. The country decides which videos are available (some are blocked by country): United States by default. The proxy cost is included in the price per video.

## Actor input object example

```json
{
  "urls": [
    "https://www.youtube.com/watch?v=4qxROUatTzk",
    "https://www.youtube.com/shorts/7YGhK7K-Udw"
  ],
  "transcriptType": "any",
  "outputFormats": [
    "text",
    "segments"
  ],
  "includeVideoDetails": true,
  "listTracksOnly": false,
  "maxVideosPerChannel": 20,
  "maxVideos": 1000,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One row per video: the transcript with the video data, or why there is no transcript (free).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.youtube.com/watch?v=4qxROUatTzk",
        "https://www.youtube.com/shorts/7YGhK7K-Udw"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tablewise/youtube-transcript-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": [
        "https://www.youtube.com/watch?v=4qxROUatTzk",
        "https://www.youtube.com/shorts/7YGhK7K-Udw",
    ],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("tablewise/youtube-transcript-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.youtube.com/watch?v=4qxROUatTzk",
    "https://www.youtube.com/shorts/7YGhK7K-Udw"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call tablewise/youtube-transcript-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tablewise/youtube-transcript-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/kfP9LEuG2I6B30ApK/builds/dXEaOeKWZ1csuWvHN/openapi.json
