API حوالہ

ٹرانسکرپٹس V2

V2 ایک منظم، صارف کی ملکیت والا ٹرانسکرپٹ ماڈل ہے۔ یہ تیز کیش ہٹس اور یکساں جوابات کو ترجیح دیتا ہے، اور جب تک آپ کوئی زبان طلب نہ کریں کوئی غیر متوقع ترجمہ نہیں کرتا۔

بیس URLhttps://www.youtubetranscript.dev/api/v2

آپ کیا کر سکتے ہیں

ویڈیو ٹرانسکرائب کریں

YouTube لنک یا ویڈیو ID پیسٹ کریں اور عموماً چند سیکنڈ میں ٹرانسکرپٹ حاصل کریں۔

POST/transcribe

کئی ویڈیوز ٹرانسکرائب کریں

ایک ہی درخواست میں 3,000 تک ویڈیوز بھیجیں اور مکمل ہونے پر اطلاع پائیں۔

POST/batch

پلے لسٹس اور چینلز

کسی پلے لسٹ یا چینل کو ویڈیوز کی فہرست میں بدلیں، ٹرانسکرائب کے لیے تیار۔

POST/playlists/resolve

آپ کی اپنی آڈیو اور ویڈیو

فائل اپ لوڈ کریں اور اسپیچ ٹو ٹیکسٹ سے ٹرانسکرائب کریں۔

POST/uploads

ٹرانسکرپٹس کا انتظام

اپنی ٹرانسکرپٹس دیکھیں، حاصل کریں، ترجمہ کریں یا حذف کریں۔

GET/transcripts

طویل جابز ٹریک کریں

اسپیچ ٹو ٹیکسٹ جابز چیک کریں یا مکمل ہونے پر ویب ہک حاصل کریں۔

GET/jobs/{job_id}

نیا: ہر ٹرانسکرپٹ ماخذ کے لیے ایک mode پیرامیٹر

source اور allow_asr کو ملانے کے بجائے auto, captions_only, human_captions_only, speech_to_text_only میں سے انتخاب کریں۔ موجودہ درخواستیں پہلے کی طرح ہی کام کرتی رہیں گی۔ دیکھیں یہ کیسے کام کرتا ہے

OpenAPI تفصیلات

Postman، Insomnia میں امپورٹ کرنے، کلائنٹس بنانے یا ChatGPT / Claude میں پیسٹ کرنے کے لیے YAML ڈاؤن لوڈ کریں۔

OpenAPI 3.0: V2 (تجویز کردہ)

ایک ویڈیو ٹرانسکرائب کریں

ایک وقت میں ایک ویڈیو کے لیے تیز ترین راستہ۔ کیپشن پر مبنی ٹرانسکرپٹس چند سیکنڈز میں واپس آ جاتے ہیں؛ ASR غیر ہم وقت (async) چلتا ہے اور /api/v2/jobs/{job_id} کے ذریعے پول کیا جاتا ہے۔

ویڈیو ٹرانسکرائب کریں

Transcribe a single YouTube video. Returns immediately for caption-based videos. With mode=auto it falls back to ASR (async) when captions are unavailable: you get status processing and a job_id to poll at /api/v2/jobs/{job_id}, or the result is POSTed to webhook_url if you set one. Responses include the mode the request ran with.

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 (mode must be omitted or speech_to_text_only); webhook_url required. The upload id is returned as video_id in results.

modeauto | captions_only | human_captions_only | speech_to_text_only

Where the transcript comes from (recommended). auto: captions first, speech-to-text (ASR) only if the video has none. captions_only: any captions, never ASR. human_captions_only: human-made captions only. speech_to_text_only: always transcribe the audio. auto and speech_to_text_only can charge ASR credits. Replaces source + allow_asr; cannot be combined with them. Note: mode=auto is not the same as legacy source=auto (captions only, which is mode=captions_only). When omitted, your account default from the API Dashboard applies: auto for accounts created from October 2026, captions_only for older accounts unless changed. ASR modes work without webhook_url: poll the returned job_id.

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

Legacy, still supported: use mode instead. Default: auto. asr transcribes the audio (async, requires webhook_url).

allow_asrboolean

Legacy, still supported: use mode=auto instead. Falls back to ASR if captions fail.

formatobject

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

webhook_urluri

When set, ASR results are POSTed to your URL. Optional with mode (poll the job_id instead); required for legacy source=asr. Ignored by captions_only and human_captions_only, which never use 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.

curl -X POST https://www.youtubetranscript.dev/api/v2/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "dQw4w9WgXcQ",
    "mode": "auto",
    "language": "en",
    "format": { "timestamp": true, "paragraphs": true }
  }'

جواب (200)

{
  "request_id": "req_abc123",
  "status": "completed",
  "data": {
    "video_id": "dQw4w9WgXcQ",
    "video_title": "Example video",
    "transcript": {
      "text": "Welcome to this tutorial...",
      "language": "en",
      "source": "auto",
      "segments": [
        { "text": "Welcome to this tutorial.", "start": 0, "end": 2500 }
      ]
    }
  },
  "credits_used": 1,
  "mode": "auto"
}

لاگت کا اندازہ

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.

modeauto | captions_only | human_captions_only | speech_to_text_only

Same values as /transcribe. Use speech_to_text_only (or auto) to preview the ASR cost.

sourceauto | manual | asr

Legacy, still supported: use mode instead. Defaults to asr for cost preview.

asr_optionsobject

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

curl -X POST https://www.youtubetranscript.dev/api/v2/transcribe/estimate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "dQw4w9WgXcQ",
    "mode": "speech_to_text_only",
    "asr_options": {
      "speakerLabels": true,
      "summarization": true,
      "translateTo": "es"
    }
  }'

جواب (200)

{
  "request_id": "req_abc123",
  "video_id": "dQw4w9WgXcQ",
  "source": "asr",
  "mode": "speech_to_text_only",
  "duration_seconds": 213,
  "duration_minutes": 4,
  "max_duration_minutes": 480,
  "exceeds_max_duration": false,
  "base_credits": 3,
  "addon_credits": 2,
  "estimated_credits": 5
}

جاب اسٹیٹس دیکھیں

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).

curl -X GET https://www.youtubetranscript.dev/api/v2/jobs/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "request_id": "req_abc123",
  "status": "completed",
  "data": {
    "video_id": "dQw4w9WgXcQ",
    "transcript": {
      "text": "Welcome to this tutorial...",
      "language": "en",
      "source": "asr",
      "segments": [{ "text": "Welcome to this tutorial.", "start": 0, "end": 2500 }]
    }
  },
  "credits_used": 6
}

اپنا میڈیا اپ لوڈ کریں

اپنی آڈیو یا ویڈیو فائلیں 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.

curl -X POST https://www.youtubetranscript.dev/api/v2/uploads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "interview.mp3",
    "mime_type": "audio/mpeg",
    "size_bytes": 48211234,
    "duration_sec": 1820
  }'

# Then PUT the raw file bytes to the returned signed_url:
curl -X PUT "SIGNED_URL_FROM_RESPONSE" \
  -H "Content-Type: audio/mpeg" \
  --data-binary @interview.mp3

# Then finalize:
curl -X POST https://www.youtubetranscript.dev/api/v2/uploads/UPLOAD_ID/complete \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "upload_id": "up_a1B2c3D4",
  "bucket": "asr-media",
  "path": "user-uuid/up_a1B2c3D4/interview.mp3",
  "token": "eyJhbGciOiJIUzI1NiJ9...",
  "signed_url": "https://api.youtubetranscript.dev/storage/v1/object/upload/sign/asr-media/...?token=..."
}

اپ لوڈ مکمل کریں

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.

curl -X POST https://www.youtubetranscript.dev/api/v2/uploads/up_a1B2c3D4/complete \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "upload_id": "up_a1B2c3D4",
  "status": "uploaded",
  "filename": "interview.mp3",
  "duration_sec": 1820
}

بیچ ٹرانسکرپشن

ایک ہی ریکویسٹ میں متعدد ویڈیوز ٹرانسکرائب کریں، پھر پول کریں یا 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.

modeauto | captions_only | human_captions_only | speech_to_text_only

Where the transcript comes from (recommended). auto: captions first, speech-to-text (ASR) only if the video has none. captions_only: any captions, never ASR. human_captions_only: human-made captions only. speech_to_text_only: always transcribe the audio. auto and speech_to_text_only can charge ASR credits. Replaces source + allow_asr; cannot be combined with them. Note: mode=auto is not the same as legacy source=auto (captions only, which is mode=captions_only). For batch, auto and speech_to_text_only require webhook_url. When omitted, your API Dashboard default applies (an ASR default only when webhook_url is set).

sourceauto | manual | asr

Legacy, still supported: use mode instead. Default: auto. source=asr requires webhook_url.

allow_asrboolean

Legacy, still supported: use mode=auto instead. webhook_url is required.

formatobject

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

webhook_urluri

Delivers the completed batch payload. Required for mode=auto or speech_to_text_only (legacy: 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.

curl -X POST https://www.youtubetranscript.dev/api/v2/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_ids": ["dQw4w9WgXcQ", "jNQXAC9IVRw"],
    "mode": "auto",
    "webhook_url": "https://your-domain.com/webhook",
    "format": { "timestamp": true }
  }'

جواب (202)

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "results": [],
  "summary": { "total": 2, "succeeded": 0, "failed": 0, "processing": 2 },
  "poll_url": "https://www.youtubetranscript.dev/api/v2/batch/550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2026-05-15T10:00:00Z"
}

بیچ اسٹیٹس دیکھیں

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.

curl -X GET https://www.youtubetranscript.dev/api/v2/batch/BATCH_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "summary": { "total": 2, "succeeded": 2, "failed": 0, "processing": 0 },
  "results": [
    { "request_id": "req_1", "status": "completed", "data": { "video_id": "dQw4w9WgXcQ" } },
    { "request_id": "req_2", "status": "completed", "data": { "video_id": "jNQXAC9IVRw" } }
  ],
  "credits_used": 2,
  "webhook_delivered": true,
  "completed_at": "2026-05-15T10:04:00Z"
}

ٹرانسکرپٹس اور جابز

اپنے محفوظ ٹرانسکرپٹس کی فہرست دیکھیں، حاصل کریں، ترجمہ کریں اور حذف کریں، اور 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.

curl "https://www.youtubetranscript.dev/api/v2/jobs?status=processing&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "jobs": [
    {
      "job_id": "9c2...",
      "video_id": "dQw4w9WgXcQ",
      "video_title": "Example video",
      "language": "en",
      "source": "asr",
      "status": "processing",
      "error": null,
      "credits_used": 0,
      "created_at": "2026-07-06T12:00:00Z",
      "started_at": "2026-07-06T12:00:01Z",
      "completed_at": null
    }
  ],
  "count": 1,
  "pagination": { "page": 1, "limit": 25, "total": 1, "totalPages": 1, "hasMore": false }
}

ٹرانسکرپٹس کی فہرست

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.

curl "https://www.youtubetranscript.dev/api/v2/transcripts?page=1&limit=50&status=succeeded" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "history": [
    {
      "id": "b1f...",
      "video_id": "dQw4w9WgXcQ",
      "video_title": "Example video",
      "language": "en",
      "source_kind": "auto",
      "status": "succeeded",
      "created_at": "2026-07-06T12:00:00Z",
      "word_count": 1234,
      "segment_count": 88,
      "credits_used": 1
    }
  ],
  "count": 1,
  "pagination": { "page": 1, "limit": 50, "total": 1, "totalPages": 1, "hasMore": false }
}

ٹرانسکرپٹ حاصل کریں

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).

curl "https://www.youtubetranscript.dev/api/v2/transcripts/dQw4w9WgXcQ?language=en" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "id": "b1f...",
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "text": "Welcome to this tutorial...",
  "segments": [{ "text": "Welcome to this tutorial.", "start": 0, "end": 2500 }],
  "has_timestamps": true,
  "source_kind": "asr",
  "video_title": "Example video",
  "summary": null,
  "mind_map": null,
  "asr_intelligence": {
    "summary": "A short overview of the video...",
    "topics": [{ "text": "Technology", "relevance": 0.92 }],
    "sentiment": [{ "text": "Great tutorial", "sentiment": "POSITIVE" }]
  }
}

ٹرانسکرپٹ کا ترجمہ کریں

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.

curl -X POST "https://www.youtubetranscript.dev/api/v2/transcripts/dQw4w9WgXcQ/translate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "target_language": "es", "provider": "ai" }'

جواب (200)

{
  "success": true,
  "message": "Translation completed",
  "language": "es",
  "credits_used": 4,
  "provider_used": "ai"
}

دستیاب زبانیں

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).

curl "https://www.youtubetranscript.dev/api/v2/transcripts/dQw4w9WgXcQ/languages" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "video_id": "dQw4w9WgXcQ",
  "languages": ["en", "es"],
  "youtube_translation_languages": ["fr", "de", "ja"]
}

ٹرانسکرپٹ حذف کریں

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).

curl -X DELETE "https://www.youtubetranscript.dev/api/v2/transcripts/dQw4w9WgXcQ" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "success": true,
  "deleted": 2,
  "message": "Successfully deleted 2 transcripts"
}

پلے لسٹس

پلے لسٹ کو ویڈیو 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).

curl -X POST https://www.youtubetranscript.dev/api/v2/playlists/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "playlist_url": "https://www.youtube.com/playlist?list=PLxxxx", "limit": 100 }'

جواب (200)

{
  "playlist_id": "PLxxxx",
  "title": "My playlist",
  "total": 42,
  "truncated": false,
  "items": [
    { "video_id": "dQw4w9WgXcQ", "title": "Example video" }
  ]
}

پلے لسٹ جاب اسٹیٹس

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.

curl "https://www.youtubetranscript.dev/api/v2/playlists/{playlist_batch_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "playlist": { "id": "3f1...", "playlist_id": "PLxxxx", "title": "My playlist" },
  "videos": [
    { "video_id": "dQw4w9WgXcQ", "video_title": "Example video", "status": "succeeded" }
  ]
}

حالیہ پلے لسٹ جابز

List recent playlist batches for the authenticated user.

GET/api/v2/playlists/history

curl "https://www.youtubetranscript.dev/api/v2/playlists/history" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "history": [
    { "id": "3f1...", "playlist_id": "PLxxxx", "title": "My playlist", "total_videos": 42 }
  ],
  "count": 1
}

چینلز

چینل ٹرانسکرپشن فلو: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.

curl -X POST https://www.youtubetranscript.dev/api/v2/channels/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "handle": "@youtube",
    "limit": 50
  }'

جواب (200)

{
  "channel_id": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
  "channel_title": "YouTube",
  "subscriber_count": 42000000,
  "video_count": 1200,
  "total": 1,
  "truncated": false,
  "items": [
    {
      "video_id": "dQw4w9WgXcQ",
      "title": "Latest upload",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "published_at": "2026-05-01T12:00:00Z",
      "duration_seconds": 420
    }
  ]
}

چینل جاب اسٹیٹس

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.

curl -X GET https://www.youtubetranscript.dev/api/v2/channels/CHANNEL_BATCH_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "channel": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "channel_id": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
    "channel_title": "YouTube",
    "total_videos": 2,
    "completed_count": 1,
    "failed_count": 0,
    "status": "processing",
    "created_at": "2026-05-15T10:00:00Z"
  },
  "videos": [
    {
      "id": "job_123",
      "video_id": "dQw4w9WgXcQ",
      "video_title": "Latest upload",
      "status": "succeeded",
      "created_at": "2026-05-15T10:00:00Z",
      "finished_at": "2026-05-15T10:00:10Z"
    }
  ]
}

حالیہ چینل جابز

List recent channel batches for the authenticated user.

GET/api/v2/channels/history

پیرامیٹرز

limitquery

Max items (default 50, max 100).

curl -X GET "https://www.youtubetranscript.dev/api/v2/channels/history?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "history": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "channel_id": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
      "channel_title": "YouTube",
      "total_videos": 25,
      "completed_count": 25,
      "failed_count": 0,
      "status": "completed",
      "created_at": "2026-05-15T10:00:00Z",
      "completed_at": "2026-05-15T10:12:00Z"
    }
  ],
  "count": 1
}

تلاش

تلاش کریں، پھر ٹرانسکرائب کریں:1. GET /api/v2/search/videos (/shorts, /channels, /playlists): کی ورڈ سے مواد تلاش کریں۔ ہر درخواست پر 1 کریڈٹ۔2. ویڈیو کا url POST /api/v2/transcribe پر بھیجیں، یا چینل یا پلے لسٹ کا url /api/v2/channels/resolve یا /api/v2/playlists/resolve پر بھیجیں۔3. مزید نتائج کے لیے next_page_token کو page_token کے طور پر بھیجیں (ہر صفحے پر 1 کریڈٹ)۔

ویڈیوز تلاش کریں

Search YouTube videos by keyword. Live streams are included with type "live". Pass a result's url to /api/v2/transcribe to get its transcript. 1 credit per request, including each next page. Refunded if the search fails.

GET/api/v2/search/videos

پیرامیٹرز

qqueryلازمی

Search text, up to 200 characters.

durationquery

Video length: under_3_min, 3_to_20_min or over_20_min.

upload_datequery

Only results uploaded within: today, this_week, this_month or this_year.

sort_byquery

relevance (default) or popular.

regionquery

Two-letter country code to localize results, e.g. US.

page_tokenquery

The next_page_token from a previous response, to get the next page. null means there are no more results.

ریٹ لمٹ

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.

curl "https://www.youtubetranscript.dev/api/v2/search/videos?q=python%20tutorial&duration=over_20_min" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "request_id": "6f1c2a9e-4b7d-4f2a-9c1e-2d3b4a5c6d7e",
  "type": "videos",
  "query": "python tutorial",
  "results": [
    {
      "type": "video",
      "video_id": "kqtD5dpn9C8",
      "url": "https://www.youtube.com/watch?v=kqtD5dpn9C8",
      "title": "Python for Beginners - Learn Coding with Python in 1 Hour",
      "thumbnail": "https://i.ytimg.com/vi/kqtD5dpn9C8/hq720.jpg",
      "channel": {
        "channel_id": "UCWv7vMbMWH4-V0ZXdmDpPBA",
        "title": "Programming with Mosh",
        "handle": "programmingwithmosh",
        "url": "https://www.youtube.com/@programmingwithmosh",
        "thumbnail": "https://yt3.ggpht.com/..."
      },
      "view_count": 25574982,
      "view_count_text": "25,574,982 views",
      "published_at": null,
      "published_text": "6 years ago",
      "duration_seconds": 3606,
      "duration_text": "1:00:06",
      "badges": []
    }
  ],
  "next_page_token": "cDA6RWdJUUFV...",
  "credits_used": 1,
  "credits_remaining": 4602
}

Shorts تلاش کریں

Search YouTube Shorts by keyword. 1 credit per request, including each next page. Refunded if the search fails.

GET/api/v2/search/shorts

پیرامیٹرز

qqueryلازمی

Search text, up to 200 characters.

upload_datequery

Only results uploaded within: today, this_week, this_month or this_year.

sort_byquery

relevance (default) or popular.

regionquery

Two-letter country code to localize results, e.g. US.

page_tokenquery

The next_page_token from a previous response, to get the next page. null means there are no more results.

ریٹ لمٹ

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.

curl "https://www.youtubetranscript.dev/api/v2/search/shorts?q=python%20tips" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "request_id": "0b8e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c6b",
  "type": "shorts",
  "query": "python tips",
  "results": [
    {
      "type": "short",
      "video_id": "gbYLsUngzLc",
      "url": "https://www.youtube.com/watch?v=gbYLsUngzLc",
      "title": "Top 10 Most Important Python Functions You Must Know!",
      "thumbnail": "https://i.ytimg.com/vi/gbYLsUngzLc/oar2.jpg",
      "channel": null,
      "view_count": 1200000,
      "view_count_text": "1.2M views",
      "published_at": null,
      "published_text": null,
      "duration_seconds": null,
      "duration_text": null,
      "badges": []
    }
  ],
  "next_page_token": "cDA6RWdJUUNR...",
  "credits_used": 1,
  "credits_remaining": 4601
}

چینلز تلاش کریں

Search YouTube channels by keyword. Pass a result's url to /api/v2/channels/resolve to list its videos. 1 credit per request, including each next page. Refunded if the search fails.

GET/api/v2/search/channels

پیرامیٹرز

qqueryلازمی

Search text, up to 200 characters.

upload_datequery

Only results uploaded within: today, this_week, this_month or this_year.

sort_byquery

relevance (default) or popular.

regionquery

Two-letter country code to localize results, e.g. US.

page_tokenquery

The next_page_token from a previous response, to get the next page. null means there are no more results.

ریٹ لمٹ

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.

curl "https://www.youtubetranscript.dev/api/v2/search/channels?q=python" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "request_id": "9a8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d",
  "type": "channels",
  "query": "python",
  "results": [
    {
      "type": "channel",
      "channel_id": "UCKQdc0-Targ4nDIAUrlfKiA",
      "url": "https://www.youtube.com/@PythonSimplified",
      "title": "Python Simplified",
      "handle": "PythonSimplified",
      "description": "Hi everyone! My name is Mariya and I'm a software developer...",
      "thumbnail": "https://yt3.googleusercontent.com/...",
      "subscriber_count": 286000,
      "subscriber_count_text": "286K",
      "badges": ["Verified"]
    }
  ],
  "next_page_token": "cDA6RWdJUUFn...",
  "credits_used": 1,
  "credits_remaining": 4600
}

پلے لسٹس تلاش کریں

Search YouTube playlists by keyword. Pass a result's url to /api/v2/playlists/resolve to list its videos. 1 credit per request, including each next page. Refunded if the search fails.

GET/api/v2/search/playlists

پیرامیٹرز

qqueryلازمی

Search text, up to 200 characters.

upload_datequery

Only results uploaded within: today, this_week, this_month or this_year.

sort_byquery

relevance (default) or popular.

regionquery

Two-letter country code to localize results, e.g. US.

page_tokenquery

The next_page_token from a previous response, to get the next page. null means there are no more results.

ریٹ لمٹ

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.

curl "https://www.youtubetranscript.dev/api/v2/search/playlists?q=python%20course" \
  -H "Authorization: Bearer YOUR_API_KEY"

جواب (200)

{
  "request_id": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
  "type": "playlists",
  "query": "python course",
  "results": [
    {
      "type": "playlist",
      "playlist_id": "PLsyeobzWxl7omDoEYrrf3oXvXxa6MPgek",
      "url": "https://www.youtube.com/playlist?list=PLsyeobzWxl7omDoEYrrf3oXvXxa6MPgek",
      "title": "Python Tutorial | Complete Python Course (Beginner to Advanced)",
      "thumbnail": "https://i.ytimg.com/vi/YZkyL-f-YXY/hq720.jpg",
      "video_count": 54,
      "first_video_id": "YZkyL-f-YXY",
      "channel": {
        "channel_id": "UC59K-uG2A5ogwIrHw4bmlEg",
        "title": "Telusko",
        "handle": "Telusko",
        "url": "https://www.youtube.com/@Telusko",
        "thumbnail": null
      }
    }
  ],
  "next_page_token": "cDA6RWdJUUF3...",
  "credits_used": 1,
  "credits_remaining": 4599
}

انٹیگریشنز

آفیشل 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 ڈاؤن لوڈ کریں

ایررز

ایررز code اور message پر مشتمل JSON body واپس کرتے ہیں۔ HTTP اسٹیٹس زمرے کی نشاندہی کرتا ہے۔

HTTP اسٹیٹس	ایرر کوڈ	تفصیل
400	`invalid_request`	Invalid JSON or missing required fields
401	`invalid_api_key`	Missing or invalid API key
402	`payment_required`	Insufficient credits
404	`no_captions`	No captions available and ASR not used
429	`rate_limit_exceeded`	Too many requests, check Retry-After
500	`internal_error`	Server error, retry with backoff

ریٹ لمٹس اور کوٹے

مسلسل ریکویسٹس اور بیچ سائز کے لیے ہر پلان کی حد۔ حد سے تجاوز کرنے پر Retry-After ہیڈر کے ساتھ 429 واپس آتا ہے۔

پلان	ریکویسٹس	بیچ سائز
Free	1 req/s	10 videos
Basic	25 req/s	500 videos
Pro	50 req/s	1,500 videos
Business	100 req/s	3,000 videos

سپورٹ

لانچ کرنے میں مدد چاہیے؟ ہم سے رابطہ کریں: ہم عموماً چند گھنٹوں میں جواب دیتے ہیں۔

support@youtubetranscript.dev

Status

اپ ٹائم اور واقعات

آپ کیا کر سکتے ہیں

ویڈیو ٹرانسکرائب کریں

لاگت کا اندازہ

جاب اسٹیٹس دیکھیں

فائل اپ لوڈ کریں

اپ لوڈ مکمل کریں

کئی ویڈیوز ٹرانسکرائب کریں

بیچ اسٹیٹس دیکھیں

جابز کی فہرست

ٹرانسکرپٹس کی فہرست

ٹرانسکرپٹ حاصل کریں

ٹرانسکرپٹ کا ترجمہ کریں

دستیاب زبانیں

ٹرانسکرپٹ حذف کریں

پلے لسٹ کی ویڈیوز

پلے لسٹ جاب اسٹیٹس

حالیہ پلے لسٹ جابز

چینل کی ویڈیوز

چینل جاب اسٹیٹس

حالیہ چینل جابز

ویڈیوز تلاش کریں

Shorts تلاش کریں

چینلز تلاش کریں

پلے لسٹس تلاش کریں

متعلقہ وسائل