API Keys

ট্রান্সক্রিপ্ট V2

V2 হলো সুবিন্যস্ত, ব্যবহারকারী-মালিকানাধীন ট্রান্সক্রিপ্ট মডেল। এটি দ্রুত ক্যাশ হিট ও সামঞ্জস্যপূর্ণ রেসপন্সকে অগ্রাধিকার দেয়, আর আপনি কোনো ভাষা না চাইলে অপ্রত্যাশিত অনুবাদ করে না।

POSThttps://www.youtubetranscript.dev/api/v2/transcribe
POSThttps://www.youtubetranscript.dev/api/v2/batch
GEThttps://www.youtubetranscript.dev/api/v2/jobs/{job_id}
GEThttps://www.youtubetranscript.dev/api/v2/batch/{batch_id}
POSThttps://www.youtubetranscript.dev/api/v2/channels/resolve
GEThttps://www.youtubetranscript.dev/api/v2/channels/{channel_id}
GEThttps://www.youtubetranscript.dev/api/v2/channels/history

OpenAPI স্পেসিফিকেশন

Postman, Insomnia-তে ইমপোর্ট করতে, ক্লায়েন্ট তৈরি করতে বা ChatGPT / Claude-এ পেস্ট করতে YAML ডাউনলোড করুন।

OpenAPI 3.0: V2 (প্রস্তাবিত)

একটি ভিডিও ট্রান্সক্রাইব করুন

একবারে একটি ভিডিওর জন্য দ্রুততম পথ। ক্যাপশন-ভিত্তিক ট্রান্সক্রিপ্ট কয়েক সেকেন্ডেই ফেরত আসে; ASR অ্যাসিঙ্ক্রোনাসভাবে চলে এবং /api/v2/jobs/{job_id} দিয়ে পোল করা হয়।

Transcribe a single YouTube video. Returns immediately for caption-based videos; falls back to ASR (async) when allow_asr is true and captions are unavailable.

POST/api/v2/transcribe
প্যারামিটার
videostringআবশ্যক

YouTube URL or 11-character video ID. Required unless upload_id is set.

upload_idstring

Transcribe an uploaded media file instead of a YouTube video (see /uploads). Forces the ASR path; webhook_url required. The upload id is returned as video_id in results.

languageISO 639-1

Preferred transcript language (e.g. en). If unavailable, captions in another language may be returned: transcript.language reports the actual language.

sourceauto | manual | asr

Preferred transcript source. Default: auto. Use asr for audio transcription (async, requires webhook_url).

allow_asrboolean

Fall back to ASR if captions fail. Required for ASR-only videos.

formatobject

{ timestamp, paragraphs, words }: include extra structure in the transcript.

webhook_urluri

When set, the response returns processing and the result is delivered to your URL. Required for ASR.

asr_optionsobject

Rich ASR config: language (+ codeSwitching, medicalMode, keyTerms), translateTo, speaker diarization (speakerLabels, speakerId + type/known values, multichannel, exact or min/max expected speakers), speech understanding (topics, summary, moderation, PII, profanity, sentiment), and formatting (punctuation, text formatting, filler words, custom date/phone/email patterns). Billable add-ons increase cost: preview with /transcribe/estimate. See the AsrOptions schema in the OpenAPI spec.

Dry-run credit estimate. Returns the ASR base cost plus any add-on surcharge for the requested asr_options without creating a job or charging credits.

POST/api/v2/transcribe/estimate
প্যারামিটার
videostringআবশ্যক

YouTube URL or 11-character video ID.

sourceauto | manual | asr

Defaults to asr for cost preview.

asr_optionsobject

Same shape as /transcribe. Add-on charges are prorated by duration.

Poll a single transcription job. Use this for ASR jobs returned from /transcribe. Returns 202 while running and 200 when complete. Completed ASR jobs include asr_intelligence (summary, topics, sentiment, etc.) when those options were enabled.

GET/api/v2/jobs/{job_id}
প্যারামিটার
job_idpathআবশ্যক

Identifier returned in the original transcribe response.

include_segmentsboolean

Include segment-level timestamps in the transcript payload.

include_paragraphsboolean

Include paragraph groupings.

include_wordsboolean

Include word-level timestamps (ASR only).

নিজের মিডিয়া আপলোড করুন

ASR পাইপলাইনের মাধ্যমে নিজের অডিও বা ভিডিও ফাইল ট্রান্সক্রাইব করুন। তিনটি ধাপ: আপলোড রেজিস্টার করুন, bytes signed URL-এ PUT করুন, finalize করুন: তারপর upload_id দিয়ে /transcribe কল করুন। ফলাফল আপনার webhook-এ আসে এবং যেকোনো ASR জবের মতো পোল করা যায়।

Register an audio/video file upload and get a signed URL. PUT the raw file bytes to signed_url (with the file's Content-Type), finalize via /uploads/{upload_id}/complete, then transcribe with upload_id on /transcribe. Max 2GB and 8 hours per file.

POST/api/v2/uploads
প্যারামিটার
filenamestringআবশ্যক

Original filename. The extension is preserved for content sniffing.

mime_typestringআবশ্যক

Must start with audio/ or video/ (e.g. audio/mpeg, video/mp4).

size_bytesintegerআবশ্যক

File size in bytes. Max 2147483648 (2GB).

duration_secintegerআবশ্যক

Media duration in seconds. Max 28800 (8 hours). Used for the ASR credit estimate.

Finalize an upload after the PUT to signed_url succeeds. Verifies the file exists in storage and marks it ready. The upload can then be transcribed by passing upload_id to /transcribe (source="asr", webhook_url required).

POST/api/v2/uploads/{upload_id}/complete
প্যারামিটার
upload_idpathআবশ্যক

Upload id returned by POST /uploads.

ব্যাচ ট্রান্সক্রিপশন

একটি রিকোয়েস্টেই অনেক ভিডিও ট্রান্সক্রাইব করুন, তারপর পোল করুন বা webhook-এর মাধ্যমে ফলাফল নিন।

Submit up to 3,000 videos in one request. Returns within 2 seconds; poll the returned poll_url or wait for the webhook.

POST/api/v2/batch
প্যারামিটার
video_idsstring[]আবশ্যক

Up to 3,000 IDs depending on plan. Free = 10, Basic = 500, Pro = 1,500, Business = 3,000.

languageISO 639-1

Preferred language for every video.

sourceauto | manual | asr

Preferred transcript source. Default: auto. source=asr requires webhook_url.

allow_asrboolean

Fall back to ASR when captions fail. webhook_url is required.

formatobject

{ timestamp, paragraphs, words }: applied to every result.

webhook_urluri

Delivers the completed batch payload. Required when allow_asr=true or source=asr.

asr_optionsobject

Rich ASR config applied to every video transcribed via ASR (same shape as /transcribe). Billable add-ons apply per video.

Check the status of a batch. Returns 202 while processing and 200 when results are ready. Stop polling once status is "completed", "partial", or "failed": finished batches never change, and re-fetching one more than 60 times in 24h returns 429 with a Retry-After header.

GET/api/v2/batch/{batch_id}
প্যারামিটার
batch_idpathআবশ্যক

Batch identifier returned from POST /batch.

ট্রান্সক্রিপ্ট ও জব

সংরক্ষিত ট্রান্সক্রিপ্টের তালিকা দেখুন, আনুন, অনুবাদ করুন ও মুছুন, এবং async জবের তালিকা দেখুন। সব endpoint একই API-key অথেনটিকেশন গ্রহণ করে।

List your transcription jobs, newest first. Filter by status and paginate. Use the returned job_id with GET /api/v2/jobs/{job_id} to fetch a transcript.

GET/api/v2/jobs
প্যারামিটার
pagequery

Page number (default 1).

limitquery

Items per page (default 50, max 100).

statusquery

completed | processing | failed | requires_asr_confirmation.

List stored transcripts with search, status, language, and date filters. Metadata only (no full text) unless include_segments=true.

GET/api/v2/transcripts
প্যারামিটার
pagequery

Page number (default 1).

limitquery

Items per page (default 50, max 100).

searchquery

Match video id, title, or transcript text.

statusquery

Filter by status; omit for succeeded.

languagequery

Filter by language code.

date_fromquery

ISO date-time lower bound.

date_toquery

ISO date-time upper bound.

include_segmentsquery

Include segments in each item.

Fetch the best owned transcript for a video, including asr_intelligence (summary, topics, sentiment, etc.), plus summary and mind_map when generated.

GET/api/v2/transcripts/{video_id}
প্যারামিটার
video_idpathআবশ্যক

YouTube 11-character video ID.

idquery

Specific transcript/job id.

languagequery

Preferred language version.

sourcequery

auto | manual | asr.

include_timestampsquery

Include segments (default true).

Translate an owned transcript into a target language using YouTube captions or the AI provider. Returns free if you already own the translation.

POST/api/v2/transcripts/{video_id}/translate
প্যারামিটার
video_idpathআবশ্যক

YouTube 11-character video ID.

target_languageISO 639-1আবশ্যক

Language to translate into.

source_languageISO 639-1

Source transcript language to translate from.

providerai | youtube

Translation provider.

allow_ai_fallbackboolean

Fall back to AI when YouTube has no translation.

List the languages you already own for a video plus the YouTube translation targets available for it.

GET/api/v2/transcripts/{video_id}/languages
প্যারামিটার
video_idpathআবশ্যক

YouTube 11-character video ID.

include_youtube_defaultquery

Include YouTube translation targets (default true).

Delete owned transcript(s) for a video. Optional language/source query params narrow the deletion; otherwise every language/source is removed. Also deletes bulk by id via POST /api/v2/transcripts/bulk-delete.

DELETE/api/v2/transcripts/{video_id}
প্যারামিটার
video_idpathআবশ্যক

YouTube 11-character video ID.

languagequery

Only delete this language.

sourcequery

Only delete this source (auto | manual | asr).

প্লেলিস্ট

প্লেলিস্টকে ভিডিও ID-তে রূপান্তর করুন, /api/v2/batch দিয়ে ট্রান্সক্রাইব করুন, তারপর প্লেলিস্ট ব্যাচ ও হিস্ট্রি দেখুন।

Resolve a YouTube playlist by URL or ID into its video list (metadata only). Pair the returned video_id values with /api/v2/batch to transcribe them.

POST/api/v2/playlists/resolveপেইড প্ল্যান
প্যারামিটার
playlist_urlstring

Playlist URL. One of playlist_url or playlist_id is required.

playlist_idstring

Playlist ID (the list= value).

limitinteger

Max videos returned (1-100).

Fetch a playlist batch and per-video transcription job status. For overall batch progress, poll GET /api/v2/batch/{batch_id}.

GET/api/v2/playlists/{playlist_id}
প্যারামিটার
playlist_idpathআবশ্যক

Batch ID returned from /playlists/resolve.

List recent playlist batches for the authenticated user.

GET/api/v2/playlists/history

চ্যানেল

চ্যানেল ট্রান্সক্রিপশন ফ্লো:1. POST /api/v2/channels/resolve: চ্যানেলের আপলোডগুলো আনুন (শুধু ভিডিও মেটাডেটা)।2. POST /api/v2/batch: ট্রান্সক্রিপশন শুরু করতে ফেরত আসা video_id মানগুলো পাঠান। কাজ শেষে ফলাফল পেতে একটি webhook_url ব্যবহার করুন।3. GET /api/v2/batch/{batch_id}: সামগ্রিক অগ্রগতি ও সমন্বিত ফলাফলের জন্য ব্যাচ পোল করুন।4. GET /api/v2/channels/{channel_id}: প্রতিটি ভিডিওর জব স্ট্যাটাসসহ চ্যানেল ব্যাচ আনুন; /channels/history আগের চ্যানেল ব্যাচগুলোর তালিকা দেয়।

Fetch the uploads of a YouTube channel by URL, channel ID, or @handle. Returns video metadata only: pair the returned video_id values with /api/v2/batch to transcribe them.

POST/api/v2/channels/resolveপেইড প্ল্যান
প্যারামিটার
channel_urlstringআবশ্যক

YouTube channel URL, channel ID, or @handle. One of channel_url, channel_id, or handle must be provided. Handles are the public ID without the @ (for https://www.youtube.com/@jawed, the ID is jawed).

limitinteger

Maximum uploads returned. Defaults to the plan maximum.

Per-request cap: Basic 500 videos · Pro 1,500 videos · Business 3,000 videos. Monthly job cap: Basic 3 · Pro 8 · Business unlimited.

রেট লিমিট

Plan-based: Free 1 req/s · Basic 25 req/s · Pro 50 req/s · Business 100 req/s. Exceeding the limit returns 429 with a Retry-After header.

Fetch a channel batch and the per-video transcription job status. For overall batch status (counts + progress), poll GET /api/v2/batch/{batch_id} instead: use this endpoint when you also need each video's individual job state.

GET/api/v2/channels/{channel_id}
প্যারামিটার
channel_idpathআবশ্যক

Batch ID returned from /channels/resolve.

List recent channel batches for the authenticated user.

GET/api/v2/channels/history
প্যারামিটার
limitquery

Max items (default 50, max 100).

ইন্টিগ্রেশন

অফিশিয়াল SDK, Claude ও Cursor-এর জন্য একটি MCP সার্ভার, একটি কাস্টম GPT, এবং Make ও n8n-এর জন্য তৈরি টেমপ্লেট।

MCP serverClaude · Cursor
Repo

YouTube Transcript MCP সার্ভার Claude Desktop, Cursor বা যেকোনো MCP-সামঞ্জস্যপূর্ণ ক্লায়েন্টে যুক্ত করুন। এতে ভিডিও ট্রান্সক্রাইব, বিদ্যমান ট্রান্সক্রিপ্ট আনা ও ব্যবহার যাচাইয়ের টুল যুক্ত হয়।

ইনস্টল ও কনফিগার করুন
claude mcp add --transport http youtubetranscript https://mcp.youtubetranscript.dev --header "x-api-token: YOUR_API_KEY"
Node SDKnpm
npm

প্রথম সারির TypeScript types, retries, pagination helpers এবং webhook signature verification।

ইনস্টল করে ব্যবহার করুন
npm install youtube-transcript-api
Python SDKPyPI
PyPI

Sync + async ক্লায়েন্ট, type stubs এবং ব্যাচ ও webhook ফ্লোর জন্য helpers।

ইনস্টল করে ব্যবহার করুন
pip install youtubetranscriptdevapi
Custom GPTChatGPT
ChatGPT-তে খুলুন

আমাদের কাস্টম GPT ChatGPT-তে যুক্ত করুন এবং সাধারণ ভাষায় যেকোনো YouTube ভিডিওর সারাংশ, উদ্ধৃতি, অনুবাদ বা প্রশ্নোত্তর করুন। ভেতরে /api/v2/gpt/* দ্বারা চালিত।

  • · OAuth সাইন-ইন: চ্যাটে API key লাগবে না
  • · ক্যাপশন না থাকলে ASR বিকল্প
  • · টাইমস্ট্যাম্প ও সোর্স লিংকসহ উদ্ধৃতি
  • · প্রতিটি অ্যাকাউন্টে ফ্রি ট্রায়াল
Make.com & n8nনো-কোড
টেমপ্লেট দেখুন

বিদ্যমান অটোমেশনে ট্রান্সক্রিপশন যোগ করতে টেমপ্লেট ইমপোর্ট করুন (বা স্নিপেট কপি করুন): Notion, Sheets, Slack, Airtable, Zapier-ধাঁচের ফ্লো।

Make.com মডিউল
Module: HTTP > Make a request
- URL: https://www.youtubetranscript.dev/api/v2/transcribe
- Method: POST
- Headers:
    Authorization: Bearer {{connection.api_key}}
    Content-Type: application/json
- Body type: Raw / JSON
- Request content:
    {
      "video": "{{1.video_url}}",
      "format": { "timestamp": true }
    }
n8n HTTP node
{
  "name": "Transcribe Video",
  "type": "n8n-nodes-base.httpRequest",
  "parameters": {
    "method": "POST",
    "url": "https://www.youtubetranscript.dev/api/v2/transcribe",
    "authentication": "genericCredentialType",
    "genericAuthType": "httpHeaderAuth",
    "sendBody": true,
    "specifyBody": "json",
    "jsonBody": "={ \"video\": $json.video_url }"
  }
}
Postman / OpenAPIএক ক্লিকে
Postman কালেকশন

OpenAPI স্পেক Postman, Insomnia বা OpenAPI 3 সমর্থন করে এমন যেকোনো টুলে ইমপোর্ট করুন।

V2 YAML ডাউনলোড করুনV2 JSON ডাউনলোড করুনV1 YAML ডাউনলোড করুন

এরর

এরর code ও message-সহ একটি JSON body ফেরত দেয়। HTTP স্ট্যাটাস বিভাগ নির্দেশ করে।

HTTP স্ট্যাটাসএরর কোডবিবরণ
400invalid_requestInvalid JSON or missing required fields
401invalid_api_keyMissing or invalid API key
402payment_requiredInsufficient credits
404no_captionsNo captions available and ASR not used
429rate_limit_exceededToo many requests, check Retry-After
500internal_errorServer error, retry with backoff

রেট লিমিট ও কোটা

ধারাবাহিক রিকোয়েস্ট ও ব্যাচ সাইজের জন্য প্রতিটি প্ল্যানের সীমা। সীমা ছাড়িয়ে গেলে Retry-After হেডারসহ 429 ফেরত আসে।

প্ল্যানরিকোয়েস্টব্যাচ সাইজ
Free1 req/s10 videos
Basic25 req/s500 videos
Pro50 req/s1,500 videos
Business100 req/s3,000 videos

সাপোর্ট

লঞ্চ করতে সাহায্য দরকার? যোগাযোগ করুন: আমরা সাধারণত কয়েক ঘণ্টার মধ্যে উত্তর দিই।

Discord
@volods.taimi
Email
support@youtubetranscript.dev
Status
আপটাইম ও ঘটনা

সম্পর্কিত রিসোর্স

কীভাবে ট্রান্সক্রিপ্ট বের করবেনYouTube ট্রান্সক্রিপ্ট বের করার ধাপে ধাপে গাইডবাল্ক ট্রান্সক্রিপ্ট প্রসেসিংAPI-এর মাধ্যমে প্লেলিস্ট ও চ্যানেল প্রসেস করুনYouTube Transcript APIআমাদের REST API দিয়ে প্রোগ্রামের মাধ্যমে ট্রান্সক্রিপ্ট বের করুনঅটোমেশন টেমপ্লেটV2 API-এর জন্য Make.com ও n8n স্টার্টার ওয়ার্কফ্লোমূল্য পরিকল্পনাFree, Basic, Pro ও Business প্ল্যান
API ডকুমেন্টেশন - YouTube Transcript API