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 ফ্রি ক্রেডিট আর 500 ক্রেডিট $5 থেকে পেইড প্ল্যান। "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 সেকেন্ড করে, 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 সেকেন্ড করে, 1 ক্রেডিট করে ফেরত দিয়েছে, আর আবার করা রিকোয়েস্ট 1.3 সেকেন্ডে ফ্রিতে।
আমার প্রোডাক্টে ট্রান্সক্রিপশন API কীভাবে যুক্ত করব?+
API কী সার্ভারে রাখুন, ভিডিও লিংক একটি এন্ডপয়েন্টে পাঠান, দুবার পেমেন্ট এড়াতে ভিডিও ID অনুযায়ী ট্রান্সক্রিপ্ট সেভ করুন, ক্যাপশন ছাড়া ভিডিওকে ওয়েবহুকসহ অ্যাসিঙ্ক্রোনাস জব হিসেবে সামলান, আর অনেক ভিডিওর জন্য ব্যাচ এন্ডপয়েন্ট ব্যবহার করুন।