Pricing

Rating

Developer

Actor stats

Categories

Share

📜 YouTube Transcript Master

This Actor extracts transcripts from YouTube videos a mix of sources like: channel URLs, or playlist URLs, and video URLs. It fetches video metadata (title, duration, upload date) and transcripts in specified formats and languages.

⭐ Paying users will enjoy recieve quick responses messages, expert support for issues, as well as feature or Actor requests

Why the high price?

This a robust Actor built for high volume and bulk dataset for long term use cases. This way I can support the long term users of this Actor more effectively rather than on a "per result" basis. If you would like you may try the lite version of this Actor here: YouTube Transcript Master [Lite]

🌟 Features

• Retrieve transcripts in bulk with a mix of inputs like: YouTube channels, playlists, or individual video links.
• Extracts video title, duration, and upload date.
• Fetches transcripts in multiple formats (Plain Text, JSON, VTT, TTML, etc.).
• Supports specifying the desired transcript language.
• Uses efficient HTML scraping minimizing CPU usage.
• Includes enhanced retry logic for network requests to improve reliability.
• Optionally uses Apify's residential proxies for consistent results.

📊 Usage & Estimated Costs

Understanding the potential costs associated with running this Actor is important. Below is an example based on a test run processing 500 videos to retrieve plainText transcripts. Please note that actual costs can vary based on several factors.

Test Run Statistics:

• Videos Processed: 500
• Transcript Format Requested: plainText
• Total Combined Video Length: ~380 hours
• Average Video Length: ~45 minutes
• Success Rate: 100% (0 missed results or errors)
  

Estimated Cost Breakdown (according to test run):

Factors Influencing Costs:

• Number of Videos: The primary driver of cost. More videos mean longer compute time and potentially more proxy usage.
• Transcript Formats: Requesting multiple formats per video might slightly increase compute time and proxy usage if different underlying fetches are needed.
• Proxy Usage: Disabling the proxy (useApifyProxy: false) eliminates proxy costs but significantly increases the risk of being blocked by YouTube, leading to failed runs and potentially higher compute costs due to retries or incomplete runs. Using the proxy is highly recommended.
  

Important Considerations:

• The costs shown are estimates based on a specific run and current Apify pricing. Your actual costs may differ.
• While the Actor includes robust error handling and retries, occasional failures for specific videos (due to missing transcripts, YouTube errors, private videos, or persistent proxy issues) can still occur. Check the output dataset's error field and Actor logs for details on any failed items.

⚙️ Input

The actor takes a JSON object as input with the following properties:

Input Example

{
"sources":[
"https://www.youtube.com/watch?v=b_nep8vMnkc",
"https://www.youtube.com/@Apify",
"https://www.youtube.com/playlist?list=PLObrtcm1Kw6PEnu5BpeEFb8XEoQXMw0g7"
],
"formats":{
"plainText":true,// Get one or many formats
"json":true,
"json3":false,
"srv1":false,
"srv2":false,
"srv3":false,
"ttml":false,
"vtt":false
},
"language":"en",// Two letter language codes: 'es', 'fr', 'pl', etc.
"useApifyProxy":true,
"delayBetweenVideos":0// Milliseconds
}

📥 Output

The actor outputs data to the default Apify dataset. Each item in the dataset represents a processed video and has the following structure:

Output Example (Success - plainText & json requested)

{
"url":"https://www.youtube.com/watch?v=b_nep8vMnkc",
"language":"en",
"title":"Example Video Title",
"duration":123,
"videoLink":"https://www.youtube.com/watch?v=b_nep8vMnkc",
"uploadDate":"2023-10-27",
"text":"This is the extracted plain text transcript...",
"json":[
{"text":"Segment 1 text","start":0.5,"dur":3.2},
{"text":"Segment 2 text","start":3.7,"dur":2.8}
],
"json3":null,
"srv1":null,
"srv2":null,
"srv3":null,
"ttml":null,
"vtt":null,
"error":null,
"details":null
}

Output Example (Failure - general processing error)

{
"url":"https://www.youtube.com/watch?v=invalidVideoId",
"language":"en",
"title":"Processing Error",
"duration":-1,
"videoLink":"https://www.youtube.com/watch?v=invalidVideoId",
"uploadDate":null,
"text":null,
"json":null,
"json3":null,
"srv1":null,
"srv2":null,
"srv3":null,
"ttml":null,
"vtt":null,
"error":"Failed to process: Failed to extract valid playerResponse from HTML after 2 attempts.",
"details":"Error: Failed to extract valid playerResponse from HTML after 2 attempts.\n at processVideos (/actor/main.js:497:23)\n at ..."
}

📝 Usage Notes

• Recent Uploads: Recently upload videos may not have transcripts right away.
• Private or Deleted Videos: Keep in mind these videos will result in errors.
• Live Streams: Processing live or upcoming streams may result in errors or incomplete data, as the necessary transcript information might not be available.
• Large Transcripts & Multiple Formats: Apify has a 9.4mb limit for each item (transcript), keep this in mind when using multiple formats and large transcripts.

💬 Support

If you encounter issues or have questions, contact me @ https://x.com/t_zerohour.