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 انسٹال کیا اور دو عوامی لیکچرز مانگے:
وہی مشین، وہی دو ویڈیوز، 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:40 | 4.2 سیکنڈ | 3,357 | 286 | 1 |
| 1. What is Computation? (MIT OpenCourseWare) | 43:06 | 4.2 سیکنڈ | 6,363 | 887 | 1 |
| وہی 3Blue1Brown ویڈیو، دوبارہ مانگی | 18:40 | 1.3 سیکنڈ | 3,357 | 286 | 0 |
ہم نے کیسے ناپا: ہر ویڈیو کے لیے 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 ہو، یہی طریقہ چلتا ہے:
- کی کو سرور پر رکھیں۔ یوزرز آپ کے بیک اینڈ کو لنک بھیجتے ہیں، اور بیک اینڈ API کو کال کرتا ہے۔ کی کو کبھی براؤزر یا ایپ کے کوڈ میں نہ ڈالیں۔
- ہر طرح کا لنک قبول کریں۔ یوزر نے جیسا لکھا، لنک ویسا ہی آگے بھیجیں؛ ہماری API پورے URL، youtu.be، Shorts، ایمبیڈ اور صرف ID سب لیتی ہے (پوری فہرست)۔
- ویڈیو ID کے حساب سے ٹرانسکرپٹ محفوظ کریں۔ زیادہ تر پروڈکٹس بار بار وہی مقبول ویڈیوز مانگتے ہیں۔ ہمارے ہاں، جو ٹرانسکرپٹ آپ کے اکاؤنٹ میں پہلے سے ہے اسے دوبارہ لانے پر کوئی خرچ نہیں، جیسا تیسری لائن دکھاتی ہے، لیکن لوکل کاپی اور بھی تیز ہے۔
- بغیر کیپشن والی ویڈیوز کو جاب کی طرح سنبھالیں۔ آڈیو ٹرانسکرائب کرنے میں اس سے زیادہ وقت لگتا ہے جتنا کسی ویب ریکویسٹ کو انتظار کرنا چاہیے۔
mode: "auto"کے ساتھwebhook_urlبھیجیں، یا واپس آئے جاب ID کو بار بار چیک کریں، اور یوزر کو پیش رفت دکھائیں۔ - بہت ہوں تو بیچ استعمال کریں۔ پلے لسٹ، چینل یا بیک لاگ کے لیے الگ الگ کالز کے لوپ کی جگہ بیچ اینڈپوائنٹ استعمال کریں، تاکہ ریٹ لمٹ کے اندر رہیں۔
ہر فیلڈ 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 کے حساب سے ٹرانسکرپٹ محفوظ کریں تاکہ دو بار ادائیگی نہ ہو، بغیر کیپشن والی ویڈیوز کو ویب ہک والے غیر ہم وقت جاب کی طرح سنبھالیں، اور بہت سی ویڈیوز کے لیے بیچ اینڈپوائنٹ استعمال کریں۔