---

🎥 YouTube Transcript Scraper (Youtube-Transcript-Ninja) All in One

• Extract accurate, structured, and flexible transcripts from YouTube videos and Shorts with ease. This actor helps you convert spoken content into usable text for research, analysis, AI workflows, and content reuse 🚀

• Get any type of formats Transcript , Extract full transcripts from public videos with ease ⚡ Quickly get spoken content for research, summaries & accessibility Just enter a video URL – no login or API key needed Fast, clean & structured text for pros ✨

---

Get this type of Transcripts :

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

✨ Overview

YouTube Transcript Scraper allows you to collect transcripts from one or multiple YouTube video URLs in different formats. You can choose how detailed the transcript should be — from simple one-line text to word-level timestamps.

It automatically selects the best available captions and returns clean, ready-to-use output.

---

📦 What Data This Actor Provides

For every valid YouTube video URL, the actor can provide:

• 📄 Full transcript content
• ⏱️ Time-aligned text (optional)
• 🧩 Sentence-wise or word-level breakdown
• 🎬 Video metadata (title, duration, thumbnail)
• ⚠️ Clear error messages when transcripts are unavailable

---

📤 Output Data Structure

Each processed video produces one output record.

🧾 Output Fields Explained

Field	Description
url	Original YouTube video or Shorts URL
title	Title of the YouTube video
thumbnailUrl	Video thumbnail image URL
id	Unique YouTube video ID
duration	Video duration in hh:mm:ss format
format	Transcript format selected by the user
transcript	Transcript content (structure depends on selected format)
error	Error message (only present if transcript extraction fails)

---

🧠 Transcript Format Options

You can choose one of the following transcript formats:

⏱️ Timestamp

Best for subtitles, syncing text with video, or analysis.

[
  {
    "start": "00h, 00m, 05s",
    "duration": "00h, 00m, 03s",
    "text": "Welcome to the channel"
  }
]

---

📝 One-line Text

Perfect for summaries, AI prompts, or full-text analysis.

Welcome to the channel today we will discuss...

---

📚 Sentence-wise

Great for readability, NLP tasks, or text classification.

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

---

🔠 Word-level Transcript

Ideal for precise timing, speech analysis, or advanced AI use cases.

[
  {
    "word": "Welcome",
    "timestamp": "00h, 00m, 05s"
  }
]

---

📥 Input Configuration

Required Input

Field	Type	Description
startUrls	Array	One or more YouTube video or Shorts URLs

---

Optional Input

Field	Type	Description
transcriptFormat	String	Choose how the transcript should be returned

Available options:

• Timestamp
• One-line text
• Sentence-wise
• Word-level transcript

---

📌 Input Example

{
    "startUrls": [
        {
            "url": "https://www.youtube.com/watch?v=Ma1x7ikpid8",
            "method": "GET"
        },
        {
            "url": "https://www.youtube.com/watch?v=WTOm65IZneg",
            "method": "GET"
        }
    ],
    "transcriptFormat": "One-line text"
}

---

📊 Output Example

[
  {
    "url": "https://www.youtube.com/watch?v=Ma1x7ikpid8",
    "title": "Avatar: Fire and Ash | New Trailer",
    "thumbnailUrl": "https://i.ytimg.com/vi_webp/Ma1x7ikpid8/maxresdefault.webp",
    "id": "Ma1x7ikpid8",
    "duration": "00h, 02m, 35s",
    "format": "One-line text",
    "transcript": "This... is the only pure thing in this wor.......................... "
  },
  {
    "url": "https://www.youtube.com/watch?v=WTOm65IZneg",
    "title": "1,000 Deaf People Hear For The First Time",
    "thumbnailUrl": "https://i.ytimg.com/vi_webp/WTOm65IZneg/maxresdefault.webp",
    "id": "WTOm65IZneg",
    "duration": "00h, 06m, 13s",
    "format": "One-line text",
    "transcript": "- [Jimmy] This is the first out of 1,000 deaf people we're gonna hel..................... "
  }
]

---

🚀 Features & Highlights

• ✅ Supports multiple videos in one run
• ✅ Works with YouTube videos & Shorts
• ✅ Automatic fallback when preferred captions are unavailable
• ✅ Multiple transcript formats for different use cases
• ✅ Clean, structured, and consistent output
• ✅ Designed for automation & scaling

---

🎯 Benefits & Advantages

• 📚 Save hours of manual transcription
• 🤖 Perfect for AI, NLP, and LLM pipelines
• 🧠 Great for research, education, and content analysis
• 🧩 Flexible formats for different workflows
• 🔄 Reliable results across multiple URLs

---

🧑‍💻 Best Practices

• ✔ Use videos that already have captions available
• ✔ Choose One-line text for AI prompts
• ✔ Use Timestamp for subtitle or syncing needs
• ✔ Use Word-level only when precision is required
• ✔ Process videos in batches for better efficiency

---

⚠️ Common Errors & How to Avoid Them

“No subtitles found”

Cause: The video does not provide captions Solution: Use videos with enabled subtitles

---

Partial or empty transcript

Cause: Video captions are limited or restricted Solution: Try another video or check availability

---

Invalid URL

Cause: Incorrect or unsupported YouTube link Solution: Ensure the URL opens correctly in a browser

---

Some videos succeed, others fail

Cause: Caption availability varies by video Solution: This is expected — results are returned per video

---

📩 Support & Contact

If you need help, feature requests, or improvements:

📧 Contact: alphascraper69@gmail.com

---

⭐ Final Notes

This actor is designed to be:

• Simple to use
• Powerful in output
• Flexible for many real-world use cases

If transcripts matter to your workflow — this actor has you covered 💪

Happy scraping & analyzing! 🎉