# YouTube Transcript Scraper — Bulk & Captions (`vanborn_labs/youtube-transcript-scraper-bulk`) Actor

Get YouTube transcripts (captions/subtitles) in bulk from videos, Shorts, channels, playlists or search results. Plain text + timestamps + optional SRT, any language, manual or auto-generated. Ideal for AI/LLM, RAG, SEO and repurposing. $2.50 per 1,000 transcripts.

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

## Pricing

from $2.50 / 1,000 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

## YouTube Transcript Scraper — Bulk & Captions

**YouTube Transcript Scraper** downloads YouTube captions in bulk: single videos, Shorts, whole channels, playlists or search results. Each result has the full transcript as plain text, timestamped segments, the caption language, whether captions are human-made or auto-generated, and optional SRT subtitles.

It is built for AI and LLM pipelines (RAG, summaries, fine-tuning data), SEO content, and repurposing videos into blogs and posts. No API key, no browser, and videos without captions are never charged.

### Website

Product page, pricing and docs: https://arkadiuszvanborn.com/labs

Part of Van Born Labs by Arkadiusz Van Born. Independent software. Support: arkadiuszvanborn@gmail.com

### What is YouTube Transcript Scraper?

YouTube Transcript Scraper is an Apify Actor by Van Born Labs. It runs in the cloud, so you can start it from the Apify Console, call it through the Apify API, schedule it, or plug it into Make, n8n, Zapier, Google Sheets and AI agents through the Apify MCP server. Results can be exported as JSON, CSV, Excel, XML or HTML.

#### Key features

- 📝 Full transcript as plain text plus word count, ready for ChatGPT, Claude, RAG pipelines or summaries.
- ⏱️ Timestamped segments (start, duration, text) and optional **SRT** subtitles.
- 🌍 Choose preferred languages (e.g. `en`, `es`, `pl`, `pt-BR`), prefer human-made captions, and fall back to the video's original language automatically.
- 📺 Bulk input: video links/IDs, channels / @handles, playlists, search terms. Transcribe a creator's last 500 videos in one run.
- 💸 Pay only for transcripts you get: videos without captions are **never charged** (optionally listed for free).
- 🧾 Basic metadata included: title, channel, duration, views, upload date, available caption languages.

### What data can YouTube Transcript Scraper extract?

| Field | What it means |
|---|---|
| `videoId` | Video ID |
| `url` | Video URL |
| `title` | Title |
| `channelName` | Channel name |
| `channelId` | Channel ID |
| `durationSeconds` | Duration (seconds) |
| `viewCount` | Views |
| `uploadDate` | Upload date — YouTube upload date, typically YYYYMMDD. |
| `availableManualLanguages` | Available manual caption languages |
| `language` | Transcript language — Language code of the returned transcript, e.g. en or es. |
| `isAutoGenerated` | Auto-generated captions |
| `transcript` | Transcript — Full transcript as plain text. |
| `wordCount` | Word count |
| `segmentCount` | Segment count |
| `segments` | Timestamped segments — Present when includeTimestamps is enabled (default). |
| `srt` | SRT — Present only when includeSrt is enabled. |
| `error` | Error — Set on free rows when includeVideosWithoutTranscript is enabled and the video has no captions (e.g. NO_TRANSCRIPT). |
| `scrapedAt` | Scraped at — ISO-8601 UTC timestamp when the row was scraped. |

### How to use YouTube Transcript Scraper

1. Open the Actor and click **Try for free** (an Apify account is free and includes monthly platform credit).
2. Paste video URLs or IDs, a channel or playlist, or a search term, and pick your preferred caption languages.
3. Click **Start** and wait for the run to finish. Small runs finish in seconds.
4. Download the results as JSON, CSV or Excel, or connect them to your app with the Apify API, a webhook or an integration.
5. To monitor changes, save your input as a task and add a **schedule** (hourly, daily or weekly).

### How much does it cost to use YouTube Transcript Scraper?

This Actor uses **pay-per-event** pricing: **$2.50 per 1,000 transcripts** plus a tiny $0.00005 start fee per run. You only pay for transcripts actually returned; failed lookups are not charged. Platform usage is included in the price.

| Transcripts | Price |
|---|---|
| 100 | $0.25 |
| 1,000 | $2.50 |
| 10,000 | $25.00 |

Apify's free plan includes $5 of monthly credit, which covers about **2,000 transcripts** with this Actor. Set **Max cost per run** in the run options if you want a hard spending cap.

### Use cases

- **AI & LLM**: build RAG knowledge bases or fine-tuning datasets from expert channels; summarize long videos.
- **Content repurposing**: turn videos into blog posts, newsletters, X threads, LinkedIn posts or Shorts scripts.
- **SEO**: find the exact words top-ranking videos use; create keyword-rich descriptions and chapters.
- **Research & monitoring**: track what's said about a brand, product or topic across hundreds of videos.
- **Accessibility & subtitles**: export SRT for editing or translation.

### Notes

- Transcripts exist only if the video has captions (most videos have auto-generated ones). Videos without captions are returned as free error items (`error: "NO_TRANSCRIPT"`) and are not charged.
- Make sure your use complies with YouTube's terms and copyright law; transcripts are the creators' content.

### Input

Full field descriptions are on the **Input** tab. Example input (this is also the default run, which finishes in under a minute):

```json
{
  "videos": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "https://youtu.be/jNQXAC9IVRw"
  ],
  "languages": [
    "en"
  ],
  "includeTimestamps": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "residentialFallback": true
}
```

### Output

Each result is one row in the dataset. Example output item from a real run:

```json
{
  "videoId": "dQw4w9WgXcQ",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "channelName": "Rick Astley",
  "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
  "durationSeconds": 213,
  "viewCount": 1838357755,
  "availableManualLanguages": [
    "de-DE",
    "en",
    "es-419"
  ],
  "language": "en",
  "isAutoGenerated": false,
  "transcript": "[♪♪♪] ♪ We're no strangers to love ♪ ♪ You know the rules and so do I ♪ ♪ A full commitment's what I'm thinking of ♪ ♪ You wouldn't get this from any other guy ♪ ♪ I just wanna tell you how I'm feeling ♪ ♪ Gotta make you understand ♪ ♪ N...",
  "wordCount": 487,
  "segmentCount": 61,
  "segments": [
    {
      "start": 1.36,
      "duration": 1.68,
      "text": "[♪♪♪]"
    },
    {
      "start": 18.64,
      "duration": 3.24,
      "text": "♪ We're no strangers to love ♪"
    },
    {
      "start": 22.64,
      "duration": 4.32,
      "text": "♪ You know the rules and so do I ♪"
    }
  ],
  "scrapedAt": "2026-11-18T05:54:57.380298+00:00"
}
```

You can view results as a table in the Console, or get them from the API in JSON, CSV, Excel, XML or HTML.

### FAQ

#### Which languages are supported?

Any language YouTube has captions for. List preferred languages in order; with fallback on, the scraper returns another available language if yours is missing.

#### Is a video without captions charged?

No. It is either skipped or listed with an empty transcript for free, depending on the "Output videos without transcript" switch.

#### Can I use it through the API, MCP or integrations?

Yes. Every run is available through the Apify API and the official Python and JavaScript clients, and the Actor can be called by AI agents through the Apify MCP server. Integrations include Make, n8n, Zapier, Google Sheets, Slack and webhooks.

#### Is it legal to scrape this data?

The Actor only collects publicly available data and does not log in or bypass access controls. You are responsible for how you use the results: respect the source site's terms, copyright and privacy laws such as GDPR, and do not collect personal data without a legal basis. If in doubt, ask a lawyer.

#### Something did not work. What should I do?

Open an issue on the **Issues** tab with your run link. We usually answer within a day and fix breakages quickly.

### Other Van Born Labs Actors

| Actor | What it does |
|---|---|
| [YouTube Video Details & Outlier Score Scraper](https://apify.com/vanborn_labs/youtube-video-details-outlier-score) | YouTube video details scraper with an outlier score: views, likes, comments, subscribers, tags, chapters, views per day and engagement rate |
| [YouTube Comments Scraper — Replies, No API Key](https://apify.com/vanborn_labs/youtube-comments-scraper-fast) | YouTube comments scraper for comment text, replies, likes, authors, pinned and creator-hearted flags |
| [YouTube Viral Moment Finder — Heatmap, Transcript](https://apify.com/vanborn_labs/youtube-viral-moments-finder) | Find the best clip timestamps in long YouTube videos and podcasts using the Most Replayed heatmap, the transcript and timestamp mentions in comments |
| [YouTube Shorts Outlier Finder — Viral Score](https://apify.com/vanborn_labs/youtube-shorts-outlier-finder) | Find winning YouTube Shorts from URLs, channels, hashtags or search |

More tools: [Van Born Labs on Apify](https://apify.com/vanborn_labs).

# Actor input Schema

## `videos` (type: `array`):

Watch, youtu.be, Shorts, live URLs or bare video IDs. Channel/playlist URLs pasted here are expanded too.

## `channels` (type: `array`):

Channel URLs or @handles (latest videos; add /shorts or /streams) and playlist URLs.

## `searchTerms` (type: `array`):

Get transcripts of the top video results for these YouTube searches.

## `maxVideosPerSource` (type: `integer`):

How many videos to take from each channel, playlist or search term.

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

Hard cap on videos processed (and charged) in this run.

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

Language codes in order of preference, e.g. en, es, de, pl, pt-BR.

## `preferManualCaptions` (type: `boolean`):

Use creator-uploaded captions when available, otherwise auto-generated.

## `fallbackToAnyLanguage` (type: `boolean`):

If none of your languages exist, return the video's original-language transcript.

## `includeTimestamps` (type: `boolean`):

Adds a segments array: start, duration, text.

## `includeSrt` (type: `boolean`):

Adds a ready-to-use .srt string.

## `includeVideosWithoutTranscript` (type: `boolean`):

Adds a free row with an error flag for videos that have no captions (or other non-charged errors). On by default, so no-caption videos show up as error items instead of disappearing from the dataset.

## `maxConcurrency` (type: `integer`):

Parallel videos.

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

Apify Proxy (datacenter) is used by default.

## `residentialFallback` (type: `boolean`):

Retry blocked videos through residential proxy (no extra cost to you).

## Actor input object example

```json
{
  "videos": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "https://youtu.be/jNQXAC9IVRw"
  ],
  "channels": [],
  "searchTerms": [],
  "maxVideosPerSource": 20,
  "languages": [
    "en"
  ],
  "preferManualCaptions": true,
  "fallbackToAnyLanguage": true,
  "includeTimestamps": true,
  "includeSrt": false,
  "includeVideosWithoutTranscript": true,
  "maxConcurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "residentialFallback": true
}
```

# Actor output Schema

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

One dataset item per video with a transcript: plain text, optional timestamped segments and SRT, plus language and video metadata.

## `runSummary` (type: `string`):

JSON counters for this run (successes, failures, residential proxy requests) stored in the default key-value store as RUN_SUMMARY.

# 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 = {
    "videos": [
        "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "https://youtu.be/jNQXAC9IVRw"
    ],
    "channels": [],
    "searchTerms": [],
    "languages": [
        "en"
    ],
    "includeTimestamps": true,
    "proxyConfiguration": {
        "useApifyProxy": true
    },
    "residentialFallback": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("vanborn_labs/youtube-transcript-scraper-bulk").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 = {
    "videos": [
        "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "https://youtu.be/jNQXAC9IVRw",
    ],
    "channels": [],
    "searchTerms": [],
    "languages": ["en"],
    "includeTimestamps": True,
    "proxyConfiguration": { "useApifyProxy": True },
    "residentialFallback": True,
}

# Run the Actor and wait for it to finish
run = client.actor("vanborn_labs/youtube-transcript-scraper-bulk").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 '{
  "videos": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "https://youtu.be/jNQXAC9IVRw"
  ],
  "channels": [],
  "searchTerms": [],
  "languages": [
    "en"
  ],
  "includeTimestamps": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "residentialFallback": true
}' |
apify call vanborn_labs/youtube-transcript-scraper-bulk --silent --output-dataset

```

## MCP server setup

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

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/vnPaF6fC0BClTxKBD/builds/qd5GiZjZFAQAr8eGc/openapi.json
