YOUTUBE TRANSCRIPT API · गाइड

Python में youtube-transcript-api कैसे इस्तेमाल करें, और यह मेरे सर्वर पर क्यों फेल होता है?

youtube-transcript-api एक मुफ्त, ओपन-सोर्स Python लाइब्रेरी है: pip से इंस्टॉल करें और वीडियो ID के साथ fetch() चलाएं। यह आपके कंप्यूटर पर अच्छी चलती है, लेकिन क्लाउड सर्वर पर YouTube अक्सर इसे ब्लॉक कर देता है। हमने 21 नवंबर 2026 को एक क्लाउड सर्वर से चलाया और दोनों वीडियो पर IpBlocked मिला।

21 नवंबर 2026 को अपडेट · 5 मिनट में पढ़ें

youtube-transcript-api एक मुफ्त, ओपन-सोर्स Python लाइब्रेरी है जो YouTube वीडियो के कैप्शन लाती है: pip install youtube-transcript-api, फिर YouTubeTranscriptApi().fetch(video_id)। यह आपके अपने कंप्यूटर से अच्छी चलती है, लेकिन क्लाउड सर्वर से YouTube अक्सर इसे RequestBlocked या IpBlocked से रोक देता है, और बिना कैप्शन वाले वीडियो में यह मदद नहीं करती।

हमने 21 नवंबर 2026 को इसे एक क्लाउड मशीन से चलाया, फिर उसी मशीन से वही दो वीडियो अपनी होस्टेड API से निकाले। यहां बताया है कि हर एक में क्या हुआ, लाइब्रेरी कैसे इस्तेमाल करें और कब होस्टेड API बेहतर है।

youtube-transcript-api क्या है?

यह Jonas Depoix की बनाई Python लाइब्रेरी है, GitHub और PyPI पर, MIT लाइसेंस में। मौजूदा वर्शन 1.2.5 है, Python 3.8 और उसके बाद के लिए।

  • यह वे कैप्शन पढ़ती है जो YouTube पर पहले से हैं, चैनल के अपने या YouTube के ऑटोमैटिक।
  • इसे न API की चाहिए, न हेडलेस ब्राउज़र।
  • यह वीडियो की कैप्शन भाषाओं की सूची दे सकती है, एक भाषा को दूसरी पर प्राथमिकता दे सकती है और YouTube का मशीन अनुवाद इस्तेमाल कर सकती है।
  • यह टेक्स्ट, JSON, SRT या WebVTT में आउटपुट देती है, और इसका कमांड-लाइन टूल भी है।

इसका README इस समझौते के बारे में साफ़ है: यह YouTube के वेब प्लेयर का एक बिना दस्तावेज़ वाला हिस्सा इस्तेमाल करती है, इसलिए "no guarantee that it won't stop working tomorrow"।

इसे कैसे इस्तेमाल करें?

pip install youtube-transcript-api
from youtube_transcript_api import YouTubeTranscriptApi
from youtube_transcript_api.formatters import SRTFormatter

ytt_api = YouTubeTranscriptApi()

# English if it exists, else German
transcript = ytt_api.fetch("aircAruvnKk", languages=["en", "de"])

for snippet in transcript:
    print(snippet.start, snippet.text)

print(SRTFormatter().format_transcript(transcript))

कमांड लाइन पर youtube_transcript_api aircAruvnKk --languages en --format json > transcript.json यही काम करता है। भाषाओं की सूची, अनुवाद और बाकी बातें README में हैं।

मेरे सर्वर पर यह IpBlocked से क्यों फेल होती है?

क्योंकि YouTube क्लाउड कंपनियों से आने वाली ज़्यादातर रिक्वेस्ट ब्लॉक करता है। लाइब्रेरी का README साफ़ कहता है: YouTube "has started blocking most IPs that are known to belong to cloud providers (like AWS, Google Cloud Platform, Azure, etc.)", इसलिए कोड डिप्लॉय करने के बाद "most likely" आपको RequestBlocked या IpBlocked एरर मिलेंगे। बहुत ज़्यादा रिक्वेस्ट के बाद घर का IP भी ब्लॉक हो सकता है।

हमने यह खुद देखा। 21 नवंबर 2026 को हमने एक क्लाउड मशीन पर वर्शन 1.2.5 इंस्टॉल किया और दो सार्वजनिक लेक्चर मांगे:

क्लाउड मशीन पर youtube-transcript-api में IpBlocked, और उसी मशीन से YouTubeTranscript.dev की API से वही दो वीडियो लौटते हुएवही मशीन, वही दो वीडियो, 21 नवंबर 2026 (UTC)।

दोनों कॉल पर करीब 1.1 सेकंड में IpBlocked आया। उस मशीन से youtube.com पर सीधी रिक्वेस्ट Google के "असामान्य ट्रैफ़िक" पेज पर भेज दी गई, यानी YouTube मशीन को मना कर रहा था, लाइब्रेरी में कोई गड़बड़ी नहीं थी।

README का हल प्रॉक्सी है, और वह रोटेटिंग रेज़िडेंशियल प्रॉक्सी की सलाह देता है, क्योंकि लंबे इस्तेमाल के बाद YouTube स्टैटिक प्रॉक्सी को बैन कर देता है। यह चलता है, लेकिन इसका मतलब है एक और पेड सेवा, एक और अकाउंट और ब्लॉक पर नज़र रखना।

इसे और क्या रोक सकता है?

  • कैप्शन नहीं हैं। लाइब्रेरी कैप्शन पढ़ती है; ऑडियो ट्रांसक्राइब नहीं करती। कैप्शन बंद हों तो TranscriptsDisabled, और भाषा न हो तो NoTranscriptFound आता है।
  • उम्र-सीमा वाले वीडियो। README के मुताबिक इनके लिए ज़रूरी कुकी लॉगिन YouTube की तरफ़ बदलावों के बाद "currently not available" है।
  • YouTube के बदलाव। यह बिना दस्तावेज़ वाला इंटरफ़ेस इस्तेमाल करती है, इसलिए YouTube का कोई अपडेट इसे नया वर्शन आने तक तोड़ सकता है।

इनमें से कुछ भी लैपटॉप पर स्क्रिप्ट चलाने में रुकावट नहीं है। लेकिन प्रोडक्ट में डालने से पहले इनकी योजना बनानी चाहिए।

ब्लॉक होने पर इसकी जगह क्या इस्तेमाल करें?

एक होस्टेड ट्रांसक्रिप्ट API, जो डेटा अपनी तरफ़ से लाती है। हमारी है YouTubeTranscript.dev की API। उसी क्लाउड मशीन से, कुछ मिनट पहले, वही दो वीडियो:

वीडियोअवधिसमयशब्दटाइमस्टैम्प वाली लाइनेंक्रेडिट
But what is a neural network? (3Blue1Brown)18:404.2 सेकंड3,3572861
1. What is Computation? (MIT OpenCourseWare)43:064.2 सेकंड6,3638871
वही 3Blue1Brown वीडियो, दोबारा मांगा18:401.3 सेकंड3,3572860

हमने कैसे मापा: हर वीडियो के लिए POST /api/v2/transcribe पर एक रिक्वेस्ट, सिर्फ कैप्शन और टाइमस्टैम्प चालू, curl से भेजने से पूरा जवाब आने तक समय मापा। क्रेडिट वही हैं जो हर जवाब ने बताए। हर एक एक बार मापा, इसलिए समय को उदाहरण मानें।

Python से कॉल:

import requests

r = requests.post(
    "https://www.youtubetranscript.dev/api/v2/transcribe",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"video": "aircAruvnKk", "mode": "auto", "format": {"timestamp": True}},
)
data = r.json()["data"]
for seg in data["transcript"]["segments"]:
    print(seg["start"], seg["text"])  # start and end are in milliseconds

समझौता खर्च का है: लाइब्रेरी मुफ्त है, API में कैप्शन वाले हर वीडियो पर 1 क्रेडिट लगता है, हर महीने 10 मुफ्त क्रेडिट और $5 में 500 क्रेडिट से पेड प्लान। "mode": "auto" के साथ यह बिना कैप्शन वाले वीडियो भी ट्रांसक्राइब करती है, हर 2 मिनट ऑडियो पर 1 क्रेडिट। अगर खुद रिक्वेस्ट न लिखना चाहें तो Python SDK है।

अपने प्रोडक्ट में ट्रांसक्रिप्शन API कैसे जोड़ें?

कोई भी API हो, यही तरीका चलता है:

  1. की को सर्वर पर रखें। यूज़र आपके बैकएंड को लिंक भेजते हैं, और बैकएंड API को कॉल करता है। की को कभी ब्राउज़र या ऐप के कोड में न डालें।
  2. हर तरह का लिंक स्वीकार करें। यूज़र ने जैसा लिखा, लिंक वैसा ही आगे भेजें; हमारी API पूरे URL, youtu.be, Shorts, एम्बेड और सिर्फ ID सब लेती है (पूरी सूची)।
  3. वीडियो ID के हिसाब से ट्रांसक्रिप्ट सेव करें। ज़्यादातर प्रोडक्ट बार-बार वही लोकप्रिय वीडियो मांगते हैं। हमारे यहां, जो ट्रांसक्रिप्ट आपके अकाउंट में पहले से है उसे दोबारा लाने का कोई खर्च नहीं, जैसा तीसरी लाइन दिखाती है, लेकिन लोकल कॉपी और भी तेज़ है।
  4. बिना कैप्शन वाले वीडियो को जॉब की तरह संभालें। ऑडियो ट्रांसक्राइब करने में उतने से ज़्यादा समय लगता है जितना किसी वेब रिक्वेस्ट को इंतज़ार करना चाहिए। mode: "auto" के साथ webhook_url भेजें, या लौटे जॉब ID को बार-बार जांचें, और यूज़र को प्रोग्रेस दिखाएं।
  5. बहुत हों तो बैच इस्तेमाल करें। प्लेलिस्ट, चैनल या बैकलॉग के लिए अलग-अलग कॉल के लूप की जगह बैच एंडपॉइंट इस्तेमाल करें, ताकि रेट लिमिट के अंदर रहें।

हर फ़ील्ड API डॉक्स में है, और हमारी स्पीच-टू-टेक्स्ट API गाइड बिना कैप्शन वाले ऑडियो पर सटीकता और खर्च मापती है।

मुझे कौन सा इस्तेमाल करना चाहिए?

अगर आप...इस्तेमाल करें
अपने कंप्यूटर पर स्क्रिप्ट चला रहे हैं, एक बार में कुछ वीडियोyoutube-transcript-api
क्लाउड सर्वर, सर्वरलेस फ़ंक्शन या प्रोडक्ट में डिप्लॉय कर रहे हैंहोस्टेड API, या लाइब्रेरी के साथ रोटेटिंग रेज़िडेंशियल प्रॉक्सी
बिना कैप्शन वाले वीडियो संभाल रहे हैंऑडियो ट्रांसक्राइब करने वाली सेवा
पूरी प्लेलिस्ट या चैनल ला रहे हैंबैच एंडपॉइंट वाली होस्टेड API

सारांश

  • youtube-transcript-api मुफ्त, MIT लाइसेंस वाली और आसान है: YouTubeTranscriptApi().fetch(video_id)।
  • क्लाउड सर्वर पर YouTube अक्सर इसे ब्लॉक करता है; हमारी क्लाउड मशीन पर दोनों वीडियो पर करीब 1.1 सेकंड में IpBlocked आया। सुझाया गया हल प्रॉक्सी है।
  • यह सिर्फ मौजूद कैप्शन पढ़ती है, और उम्र-सीमा वाले वीडियो अभी नहीं चलते।
  • एक होस्टेड API ने उसी मशीन से वही वीडियो 4.2-4.2 सेकंड में, 1-1 क्रेडिट में लौटाए, और बिना कैप्शन वाले वीडियो भी संभालती है।

अक्सर पूछे जाने वाले सवाल

youtube-transcript-api क्या है?+

एक ओपन-सोर्स Python लाइब्रेरी (MIT लाइसेंस) जो YouTube पर किसी वीडियो के पहले से मौजूद कैप्शन, ऑटोमैटिक कैप्शन समेत, बिना API की और बिना ब्राउज़र के लाती है। pip install youtube-transcript-api से इंस्टॉल करें और YouTubeTranscriptApi().fetch(video_id) चलाएं।

youtube-transcript-api में RequestBlocked या IpBlocked क्यों आता है?+

क्योंकि YouTube क्लाउड कंपनियों के IP पतों से आने वाली ज़्यादातर रिक्वेस्ट ब्लॉक करता है, और बहुत ज़्यादा रिक्वेस्ट करने वाले किसी भी IP को रोक सकता है। लाइब्रेरी का README खुद यह कहता है और रोटेटिंग रेज़िडेंशियल प्रॉक्सी सुझाता है। 21 नवंबर 2026 को हमारी क्लाउड मशीन से दोनों टेस्ट वीडियो पर करीब 1.1 सेकंड में IpBlocked आया।

क्या youtube-transcript-api बिना कैप्शन वाले वीडियो को ट्रांसक्राइब कर सकती है?+

नहीं। यह सिर्फ मौजूद कैप्शन पढ़ती है। कैप्शन बंद हों तो TranscriptsDisabled आता है, और आपकी भाषा न हो तो NoTranscriptFound। ऑडियो से टेक्स्ट पाने के लिए स्पीच-टू-टेक्स्ट सेवा चाहिए।

क्या youtube-transcript-api मुफ्त है?+

हां, लाइब्रेरी मुफ्त है और MIT लाइसेंस में है। सर्वर पर चलाने के लिए आम तौर पर प्रॉक्सी का खर्च होता है, क्योंकि क्लाउड IP ब्लॉक होते हैं।

सर्वर पर youtube-transcript-api की जगह क्या इस्तेमाल करें?+

एक होस्टेड ट्रांसक्रिप्ट API जो आपकी तरफ़ से डेटा लाए। जिस मशीन पर लाइब्रेरी ब्लॉक हुई, उसी से YouTubeTranscript.dev की API ने दोनों वीडियो 4.2-4.2 सेकंड में, 1-1 क्रेडिट में लौटाए, और दोबारा की गई रिक्वेस्ट 1.3 सेकंड में मुफ्त।

अपने प्रोडक्ट में ट्रांसक्रिप्शन API कैसे जोड़ें?+

API की को अपने सर्वर पर रखें, वीडियो लिंक एक एंडपॉइंट पर भेजें, वीडियो ID के हिसाब से ट्रांसक्रिप्ट सेव करें ताकि दो बार भुगतान न हो, बिना कैप्शन वाले वीडियो को वेबहुक वाले असिंक्रोनस जॉब की तरह संभालें, और बहुत सारे वीडियो के लिए बैच एंडपॉइंट इस्तेमाल करें।

आगे पढ़ें

मुफ़्त में ट्रांसक्रिप्ट निकालना शुरू करें

किसी भी YouTube वीडियो को सेकंडों में टेक्स्ट में बदलें। क्रेडिट कार्ड की ज़रूरत नहीं।

YOUTUBETRANSCRIPT.DEV आज़माएँ →
youtube-transcript-api (Python): इस्तेमाल और फेल होने की वजह | Creator Research