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 asynchronously चलता है और /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 जॉब की सूची देखें। सभी endpoints एक ही 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).

प्लेलिस्ट

प्लेलिस्ट को वीडियो IDs में बदलें, उन्हें /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).

इंटीग्रेशन

आधिकारिक SDKs, 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