# Youtube Transcript /  Subtitles  Ninja (`alpha-scraper/youtube-transcript-subtitles-ninja`) Actor

\[ 🎥  Get any type  of FORMAT AND  LANGUAGE TranscriptS  ]
Extract full transcripts from public videos with ease.Youtube Transcript /  Subtitles  Ninja Quickly get spoken content for research, summaries & accessibility .No login or API key needed
Fast, clean & structured text for pros ✨.

- **URL**: https://apify.com/alpha-scraper/youtube-transcript-subtitles-ninja.md
- **Developed by:** [Alpha Scraper](https://apify.com/alpha-scraper) (community)
- **Categories:** Social media, Videos, Other
- **Stats:** 37 total users, 1 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$6.99/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

***

## 🥷 Youtube Transcript /  Subtitles  Ninja

**Advanced YouTube Transcript Scraper**

Extract clean, structured, and multi-format transcripts from YouTube videos and Shorts with ease. This actor supports multiple languages, flexible transcript formats, and reliable fallback handling — all wrapped in a simple and user-friendly interface 🚀

***

### 📌 Overview

**YouTube Transcript Ninja** allows you to extract transcripts from one or multiple YouTube video URLs in different formats such as:

- Timestamped transcripts
- Clean one-line text
- Sentence-wise transcripts
- Word-level transcripts with timestamps

It is ideal for researchers, content creators, educators, SEO professionals, and automation workflows.

### Get this type of Transcripts :

- ⏱️ Timestamp
- 📝 One-line Text
- 📚 Sentence-wise
- 🔠 Word-level Transcript

### 🌍 Supported Transcript Languages

You can select a preferred transcript language from the input panel:

- English (Default / Auto Detect)
- Spanish
- Portuguese
- French
- German
- Russian
- Chinese
- Japanese
- Korean
- Arabic
- Hindi
- Bengali
- Turkish
- Vietnamese
- Thai
- Tamil
- Indonesian

🔁 **Smart fallback behavior** ensures a usable transcript is returned whenever possible.

***

### 📊 What Data This Actor Provides

For each YouTube video URL, this actor provides:

- Video metadata (title, duration, thumbnail)
- Selected transcript language
- Transcript in the chosen format
- Error feedback (if transcript is unavailable)

All data is returned in a **clean, structured format** ready for analysis or automation.

***

### 📦 Youtube Transcript /  Subtitles  Ninja - Output Data Fields (Explained)

Each successful result contains the following fields:

| Field Name     | Description                               |
| -------------- | ----------------------------------------- |
| `url`          | The YouTube video or Shorts URL           |
| `title`        | Video title                               |
| `thumbnailUrl` | High-quality thumbnail image URL          |
| `id`           | Unique YouTube video ID                   |
| `duration`     | Video duration in `hh:mm:ss` format       |
| `format`       | Transcript format selected by the user    |
| `transcript`   | Extracted transcript data (format varies) |

If an error occurs, the output will include:

| Field   | Description                             |
| ------- | --------------------------------------- |
| `error` | Human-readable explanation of the issue |

***

### 🧾 Transcript Formats (Output Types)

#### 🟢 1. Timestamp

Returns an **array of objects**, each containing:

```json
{
  "start": "00h, 01m, 05s",
  "duration": "00h, 00m, 04s",
  "text": "Welcome to the channel"
}
```

✅ Best for subtitles, captions, and precise syncing.

***

#### 🟢 2. One-line Text

Returns a **single clean text string**:

```text
Welcome to the channel today we will discuss...
```

✅ Best for summaries, SEO, AI prompts, and NLP tasks.

***

#### 🟢 3. Sentence-wise

Returns an **array of full sentences**:

```json
[
  "Welcome to the channel.",
  "Today we will discuss YouTube growth."
]
```

✅ Best for readability, translation, and content reuse.

***

#### 🟢 4. Word-level Transcript

Returns **each word with its timestamp**:

```json
{
  "word": "Welcome",
  "timestamp": "00h, 00m, 02s"
}
```

✅ Best for linguistic analysis, subtitles, and fine-grained alignment.

***

### 🎯 Features & Capabilities

- ✨ Multi-video support
- ✨ Works with standard videos & Shorts
- ✨ Multiple transcript formats
- ✨ Language selection with fallback
- ✨ Clean structured output
- ✨ Handles unavailable transcripts gracefully
- ✨ Designed for automation & scaling

***

### 🚀 Benefits & Advantages

- ✅ No manual work
- ✅ Ready-to-use structured data
- ✅ Ideal for bulk processing
- ✅ Saves hours of manual transcription
- ✅ Consistent output format
- ✅ Easy to integrate with workflows

***

### 🧪 Input Example

```json
{
    "language": "Default (Auto Detect / English)",

     "transcriptFormat": "One-line text"

    "startUrls": [
        {
            "url": "https://www.youtube.com/watch?v=figrl0aOULs",
            "method": "GET"
        },
        {
            "url": "https://www.youtube.com/watch?v=Pv0iVoSZzN8",
            "method": "GET"
        }
    ],

   
}
```

***

### 📤 Output Example

```json
[
  {
    "url": "https://www.youtube.com/watch?v=figrl0aOULs",
    "title": "Click This Video To Feed 1 Person",
    "thumbnailUrl": "https://i.ytimg.com/vi/figrl0aOULs/maxresdefault.jpg",
    "id": "figrl0aOULs",
    "duration": "00h, 10m, 29s",
    "format": "One-line text",
    "transcript": "Every single time someone watches this video, it helps feed som............................."
  },
  {
    "url": "https://www.youtube.com/watch?v=Pv0iVoSZzN8",
    "title": "In 10 Minutes This Room Will Explode!",
    "thumbnailUrl": "https://i.ytimg.com/vi/Pv0iVoSZzN8/maxresdefault.jpg",
    "id": "Pv0iVoSZzN8",
    "duration": "00h, 10m, 00s",
    "format": "One-line text",
    "transcript": "I just started this ten minute timer and when it hit zero that room all the wa................................."
  }
]
```

***

### 🧠 Best Practices for Best Results

- ✔ Use videos that **already have captions available**
- ✔ Provide **valid YouTube URLs only**
- ✔ Choose the correct transcript format for your use case
- ✔ Use batch URLs for bulk extraction
- ✔ Handle error records separately in automation

***

### ⚠️ Possible Errors & How to Avoid Them

#### No captions found

**Cause:** The video has no transcript available
**Solution:** Use videos with captions enabled

***

#### Invalid URL

**Cause:** Broken or unsupported YouTube link
**Solution:** Always verify the URL before running

***

#### Language not available

**Cause:** Selected language does not exist for that video
**Solution:** Use **Default (Auto Detect)** for best compatibility

***

#### Youtube Transcript /  Subtitles  Ninja Temporary failures

**Cause:** Short-term access issues
**Solution:** Re-run the actor or retry the task

***

### 📌 Use Cases

📚 Academic research
📝 Blog & content writing
🎥 Subtitle generation
🌍 Translation workflows
🤖 AI & LLM prompt building
📈 SEO optimization

***

### 📬 Support & Contact

If you need help, feature requests, or have questions:

📧 **Email:** [alphascraper69@gmail.com](https://mail.google.com/mail/u/0/#inbox)

***

### ⭐ Final Notes

**Youtube Transcript /  Subtitles  Ninja** is built to be:

- Reliable
- Flexible
- Automation-friendly
- Beginner-friendly

If you work with YouTube content at scale — this actor is your silent ninja 🥷✨

***

## Here my another actors :

### Youtube Iteams:

- [🎶 Youtube Audio Downloader (Video/Shorts)](https://console.apify.com/actors/lTUPL4gmLTDNXBeWw/source)
- [Youtube Video Downloader Advanced](https://console.apify.com/actors/XOpQsUkgGZLGSCJd0/source)
- [Youtube Video Downloader ( Soundless )](https://console.apify.com/actors/gFsczW1QplIquv9eL/source)
- [Youtube Video Downloader](https://console.apify.com/actors/9kZQcUlHZRKp1ilZA/source)
- [Youtube Video Details Scraper](https://console.apify.com/actors/On4VfiWjGnT79clm1/source)
- [Youtube Transcript Ninja (Subtitles) ](https://console.apify.com/actors/eWrsJHhdeEbVHChpX/source)
- [Youtube Thumbnails Downloader & Scraper](https://console.apify.com/actors/YShot3wkL0HJdRkD0/source)
- [Youtube Tags or Hashtags Scraper](https://console.apify.com/actors/O1FU99ID2ccR5wcS8/source)
- [Youtube Tags Scraper](https://console.apify.com/actors/1wVokAhQLbbeeFVfR/source)
- [Youtube Shorts Scraper lite](https://console.apify.com/actors/bOyWDt1IbXZsadWRp/source)
- [Youtube Shorts Downloader Pro](https://console.apify.com/actors/bN1AjNRMops81rGkg/source)
- [Youtube Shorts Comments Scraper](https://console.apify.com/actors/ON1C4qgHaEQEhhEmI/source)
- [Youtube Community Posts Scraper](https://console.apify.com/actors/X38E51BParHFNaCw1/source)
- [Youtube Channel Id Scraper Pro](https://console.apify.com/actors/2uuIEovgGHcYjEKyN/source)
- [Youtube Video Transcript  Scraper ( Subtitles )](https://console.apify.com/actors/IEmSN6FkNn0tw10BA/source)
- [Youtube Video Comments Scraper](https://console.apify.com/actors/URh4zBT1aesfE8QKc/source)
- [Youtube Shorts Scraper  Pro](https://console.apify.com/actors/G4McyHJJzc2TbUSo6/source)
- [Youtube Shorts Scraper](https://console.apify.com/actors/XP0WgKweF1M83FnmR/source)
- [Youtube Channel Scraper](https://console.apify.com/actors/ufMZfwMgyHeaoDdAd/source)
- [YouTube Video Description Extractor](https://console.apify.com/actors/Xqae3CmxqT3HfHaJ5/source)
- [YouTube Hashtag Scraper](https://console.apify.com/actors/d4bYqQ0LWuczEgumx/source)
- [YouTube Description Scraper pro](https://console.apify.com/actors/OVymx0bku0C8gowB0/source)
- [YouTube Comments Scraper | Pay Per Result](https://console.apify.com/actors/ict6AecoJ85T4RthZ/source)
- [YouTube Channel ID Scraper](https://console.apify.com/actors/P9XlG8ylMGqfoelOg/source)

### Tiktok Iteams:

- [Tiktok Video Downloader](https://console.apify.com/actors/dlyQGIrqOracdqOeb/source)
- [Tiktok Video Details Scraper Pro](https://console.apify.com/actors/kZMMAHBehLOdG2FBb/source)
- [Tiktok Profile Scraper](https://console.apify.com/actors/C9mdCvPs7mDV8AYdd/source)
- [TikTok Video Scraper](https://console.apify.com/actors/7NjipRJbS73X9Io90/source)
- [TikTok Profile Videos Scraper](https://console.apify.com/actors/F6ar6Hu5STLp5mdAf/source)
- [TikTok Profile Scraper pro](https://console.apify.com/actors/3fmkMmoCBQ4SBIIAN/source)
- [TikTok Audio Downloader 🎵](https://console.apify.com/actors/jHipu7fQihSVhBE3x/source)

### Snapchat Iteams:

- [Snapchat Video Downloader (Spotlight )](https://console.apify.com/actors/yKz99HNmn4AgmhPOf/source)
- [Snapchat Video  Details Scraper (Spotlight)](https://console.apify.com/actors/fyV48EkRqcNoeq2kH/source)
- [Snapchat Followers Scraper](https://console.apify.com/actors/PxBiNYw0mgZOagGyD/source)
- [Snapchat Profile     Scraper](https://console.apify.com/actors/siCUsZdm6xmc3g7HF/source)
- [Snapchat Profile Scraper  Mini](https://console.apify.com/actors/qhkQO51Cv6iHJxdAs/source)

### Instagram Iteams:

- [Instagram video Downloader + Scraper](https://console.apify.com/actors/zIpixF6ZjlbelQDrY/source)
- [Instagram Video Downloader (Soundlss)](https://console.apify.com/actors/QQkJuhIQp4pexakls/source)
- [Instagram Thumbnail Scraper Video & Reels](https://console.apify.com/actors/z8JOosBY8hlqiUthl/source)
- [Instagram Reels  Downloader](https://console.apify.com/actors/VRbovYCWXTZXuVaN2/source)
- [Instagram Profile URL to Username Converter & Extractor](https://console.apify.com/actors/FOApkedA1VuG6ncno/source)
- [Instagram Profile Scraper](https://console.apify.com/actors/5dvorBkg7ccX95wAg/source)
- [Instagram Post Videos Downloader](https://console.apify.com/actors/h95ZexZ0ifOX4JEYQ/source)
- [Instagram Followers Scraper](https://console.apify.com/actors/c55pdH9mCE02sj7Dg/source)
- [Instagram Audio Downloader](https://console.apify.com/actors/MQRNuEHUqKreEi8gI/source)
- [Instagram Video Scraper + Downloader](https://console.apify.com/actors/63Z5eSy3IxgdIEYOX/source)
- [Instagram Video  scraper Advanced](https://console.apify.com/actors/79ng2nukXLzUn0aWg/source)
- [Instagram Video Details  scraper](https://console.apify.com/actors/VLyBXSwQpHTFwUcds/source)
- [Instagram Reels Details scraper](https://console.apify.com/actors/oGR3xfeXTuIirhdlZ/source)
- [Instagram Followers Scraper Pro](https://console.apify.com/actors/MqW3EtUZXm6OHdvcI/source)

### Facebook Iteams:

- [Facebook reels Downloader  (Separate audio or video)](https://console.apify.com/actors/nuvIRaMeRIzz3cfxK/source)
- [Facebook Video Downloader advanced](https://console.apify.com/actors/2SU8ZuABbAVFNKMZa/source)
- [Facebook Video Details Scraper Advanced](https://console.apify.com/actors/umYouAXm92472jIdY/source)
- [Facebook Video Details Scraper](https://console.apify.com/actors/cQi4k63arffL6Cn0m/source)
- [Facebook Transcript & Subtitle scraper](https://console.apify.com/actors/hMNe1QYDOtcTc95qI/source)
- [Facebook Thumbnail Downloader Video & Reels](https://console.apify.com/actors/9SmYiqGTUia29Yd1Y/source)
- [Facebook Reels Downloader Advanced](https://console.apify.com/actors/3Zdnp9TnvltdoC44T/source)
- [Facebook Reels Details Scraper  Best and  Affordable](https://console.apify.com/actors/nuzr418MKJltywrCh/source)
- [Facebook Reels Details Scraper](https://console.apify.com/actors/OGBA89e5Ki6Y5amko/source)
- [Facebook Page Details Scraper](https://console.apify.com/actors/PL9nP9BrKDSsKwSZF/source)
- [Facebook Audio Downloader](https://console.apify.com/actors/uVrcf4OJ9VW8iCybQ/source)

### Amazon Iteams:

- [Amazon Search Scraper](https://console.apify.com/actors/YcgJR1WP1cHJhHzvH/source)
- [Amazon Product Details Scraper ](https://console.apify.com/actors/1twpltijc10KFaVeb/source)

# Actor input Schema

## `transcriptFormat` (type: `string`):

Choose how the transcript should be formatted.

## `language` (type: `string`):

Select the preferred language for the transcript. Falls back to English/Default if unavailable.

## `startUrls` (type: `array`):

List of one or more YouTube video URLs or share links to scrape.

## Actor input object example

```json
{
  "transcriptFormat": "One-line text",
  "language": "Default (Auto Detect / English)",
  "startUrls": [
    {
      "url": "https://www.youtube.com/watch?v=figrl0aOULs"
    },
    {
      "url": "https://www.youtube.com/watch?v=Pv0iVoSZzN8"
    }
  ]
}
```

# 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 = {
    "startUrls": [
        {
            "url": "https://www.youtube.com/watch?v=figrl0aOULs"
        },
        {
            "url": "https://www.youtube.com/watch?v=Pv0iVoSZzN8"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("alpha-scraper/youtube-transcript-subtitles-ninja").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 = { "startUrls": [
        { "url": "https://www.youtube.com/watch?v=figrl0aOULs" },
        { "url": "https://www.youtube.com/watch?v=Pv0iVoSZzN8" },
    ] }

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

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

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

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.youtube.com/watch?v=figrl0aOULs"
    },
    {
      "url": "https://www.youtube.com/watch?v=Pv0iVoSZzN8"
    }
  ]
}' |
apify call alpha-scraper/youtube-transcript-subtitles-ninja --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=alpha-scraper/youtube-transcript-subtitles-ninja",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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