בחרו auto, captions_only, human_captions_only, speech_to_text_only במקום לשלב בין source ל-allow_asr. בקשות קיימות ממשיכות לעבוד בדיוק כמו קודם. איך זה עובד

מפרט OpenAPI

הורידו את קובץ ה־YAML כדי לייבא אותו ל־Postman או ל־Insomnia, לייצר לקוחות, או להדביק אותו ב־ChatGPT / Claude.

OpenAPI 3.0: V2 (מומלץ)

תמלול סרטון בודד

הדרך המהירה ביותר לסרטון אחד בכל פעם. תמלולים מבוססי כתוביות חוזרים תוך שניות ספורות. ASR רץ באופן אסינכרוני, ואת התוצאה מתשאלים דרך /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"
}

תמלול ריל מאינסטגרם

Transcribe an Instagram Reel. Uses the Reel's captions when it has them, otherwise transcribes its audio (about 15 to 20 seconds). The transcript is saved like a YouTube one with video_id instagram_<code>: read it with GET /api/v2/transcripts/{video_id} and file it in folders. Transcribing a Reel you already have is free.

POST/api/v2/social/transcribe1 credit with captions; otherwise 1 credit per 2 minutes of audio (minimum 1). Refunded if it fails.

פרמטרים

urlstringחובה

Instagram Reel or video post link, e.g. https://www.instagram.com/reel/C9xYz12AbCd/

languageISO 639-1

Preferred transcript language.

curl -X POST https://www.youtubetranscript.dev/api/v2/social/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.instagram.com/reel/C9xYz12AbCd/" }'

תגובה (200)

{
  "request_id": "5b0e1c2d-3f4a-4b5c-8d6e-7f8a9b0c1d2e",
  "transcript": {
    "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
    "video_id": "instagram_C9xYz12AbCd",
    "language": "en",
    "source_kind": "auto"
  },
  "credits_used": 1,
  "cached": false
}

הערכת עלות

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. With speaker labels on (asr_options.speakerLabels or speakerId), every segment carries a speaker field ("A", "B", ... or a name or role with speakerId), and so does every word when you add include_words=true. There is no separate speakers or utterances object.

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). Each word carries a speaker field when speaker labels were on.

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

תגובה (200, speaker labels on)

{
  "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, "speaker": "A" },
        { "text": "Thanks for having me.", "start": 2600, "end": 4100, "speaker": "B" }
      ]
    }
  },
  "credits_used": 6
}

העלאת מדיה משלכם

תמללו קובצי אודיו או וידאו משלכם דרך צינור ה־ASR. שלושה שלבים: רושמים את ההעלאה, שולחים את הבייטים ב־PUT לכתובת ה־URL החתומה ומסיימים את ההעלאה. לאחר מכן קוראים ל־/transcribe עם upload_id. התוצאות מגיעות דרך ה־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"
}

תמלולים ומשימות

הציגו, שלפו, תרגמו ומחקו את התמלולים השמורים שלכם, והציגו רשימה של משימות אסינכרוניות. כל נקודות הקצה תומכות באותו אימות באמצעות מפתח API.

רשימת משימות

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" }]
  }
}

קבלת נושאים ומילות מפתח

AI key moments, themes & keywords for a stored transcript: a short TL;DR, the key moments worth finding again (each a short label plus the exact quote, with where it starts and ends), its main themes, and each keyword with the timestamps where it's said. 1 credit per transcript, charged once: calling it again (or GET) is free. Waits up to ~25s; a 202 "processing" means it's paid for and still running, so poll GET. If detection fails the credit is refunded. Transcripts too short to analyse return empty themes for 0 credits. 402 without enough credits.

POST/api/v2/transcripts/{video_id}/themes

פרמטרים

video_idpathחובה

YouTube 11-character video ID of a transcript you own.

idquery

Specific transcript/job id.

languagequery

Which language version to analyse.

sourcequery

auto | manual | asr.

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

תגובה (200)

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "status": "completed",
  "credits_used": 1,
  "credits_remaining": 41,
  "tldr": "A promise of lifelong loyalty, sung as a list of things he'll never do.",
  "moments": [
    {
      "id": "m1",
      "theme_id": "t1",
      "label": "The six promises of the chorus",
      "quote": "Never gonna give you up, never gonna let you down",
      "color_hex": "#0d9488",
      "start": 43000,
      "end": 47500,
      "segment_start": 4,
      "segment_end": 5
    }
  ],
  "themes": [
    {
      "id": "t1",
      "name": "Commitment",
      "summary": "Promises never to leave or let the listener down.",
      "color": "teal",
      "color_hex": "#0d9488",
      "share": 0.62,
      "mention_count": 18,
      "moment_count": 3,
      "keywords": [
        {
          "id": "k1",
          "term": "never gonna give you up",
          "aliases": [],
          "definition": "The song's central promise.",
          "mention_count": 6,
          "mentions": [{ "segment_index": 4, "start": 43000 }]
        }
      ]
    }
  ]
}

קריאת נושאים שנפתחו

Read key moments, themes & keywords you've already unlocked. Never charges and never starts the AI: returns status "locked" (with credits_required) until you POST, then "completed" with the same body as POST, or 202 "processing" while detection is still running.

GET/api/v2/transcripts/{video_id}/themes

פרמטרים

video_idpathחובה

YouTube 11-character video ID of a transcript you own.

idquery

Specific transcript/job id.

languagequery

Which language version to analyse.

sourcequery

auto | manual | asr.

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

תגובה (200, not unlocked yet)

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "status": "locked",
  "credits_required": 1
}

תרגום תמלול

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"
}

תיקיות

ארגנו את הסרטונים שתמללתם בתיקיות שטוחות שפועלות כמו תגיות: סרטון אחד יכול להיות בכמה תיקיות. חינם לכל חשבון, בלי קרדיטים. קבלו רשימה של הסרטונים שלכם עם התוצרים שכבר יצרתם, מסוננת לפי תיקייה.

רשימת תיקיות

List your folders, alphabetically, with how many videos each holds. Folders are flat and work like tags: one video can be in many folders.

GET/api/v2/foldersFree: no credits

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

תגובה (200)

{
  "folders": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Competitor research",
      "video_count": 12,
      "created_at": "2026-10-29T09:14:02Z",
      "updated_at": "2026-10-29T09:14:02Z"
    }
  ]
}

יצירת תיקייה

Create a folder. Names are unique per account, ignoring case (409 if you already have one with that name). Up to 200 folders.

POST/api/v2/foldersFree: no credits

פרמטרים

namestringחובה

1 to 80 characters.

curl -X POST https://www.youtubetranscript.dev/api/v2/folders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Competitor research" }'

תגובה (201)

{
  "folder": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "name": "Competitor research",
    "video_count": 0,
    "created_at": "2026-10-29T09:14:02Z",
    "updated_at": "2026-10-29T09:14:02Z"
  }
}

שינוי שם של תיקייה

Rename a folder. GET the same path returns one folder.

PATCH/api/v2/folders/{folder_id}Free: no credits

פרמטרים

folder_idpathחובה

The folder's id.

namestringחובה

1 to 80 characters.

curl -X PATCH https://www.youtubetranscript.dev/api/v2/folders/{folder_id} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Competitors 2026" }'

תגובה (200)

{
  "folder": { "id": "7c9e6679-...", "name": "Competitors 2026", "video_count": 12, "created_at": "...", "updated_at": "..." }
}

מחיקת תיקייה

Delete a folder. Only the folder goes: its videos, transcripts and outputs stay in your account.

DELETE/api/v2/folders/{folder_id}Free: no credits

פרמטרים

folder_idpathחובה

The folder's id.

curl -X DELETE https://www.youtubetranscript.dev/api/v2/folders/{folder_id} \
  -H "Authorization: Bearer YOUR_API_KEY"

תגובה (200)

{ "deleted": true }

הוספת סרטונים לתיקייה

Add videos you've transcribed to a folder. Videos already in it are skipped; ids you have no transcript for come back in not_found. Every language and output of a video comes with it.

POST/api/v2/folders/{folder_id}/videosFree: no credits

פרמטרים

folder_idpathחובה

The folder's id.

video_idsstring[]חובה

Up to 100 video ids: YouTube ids, upload ids (upl_...) or Instagram ids (instagram_...).

curl -X POST https://www.youtubetranscript.dev/api/v2/folders/{folder_id}/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "video_ids": ["dQw4w9WgXcQ", "jNQXAC9IVRw"] }'

תגובה (200)

{
  "added": ["dQw4w9WgXcQ"],
  "already_in_folder": ["jNQXAC9IVRw"],
  "not_found": []
}

הסרת סרטונים מתיקייה

Take videos out of a folder. Their transcripts are not touched. GET the same path lists the folder's videos, like GET /api/v2/videos?folder_id=.

DELETE/api/v2/folders/{folder_id}/videosFree: no credits

פרמטרים

folder_idpathחובה

The folder's id.

video_idsstring[]חובה

Up to 100 video ids.

curl -X DELETE https://www.youtubetranscript.dev/api/v2/folders/{folder_id}/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "video_ids": ["dQw4w9WgXcQ"] }'

תגובה (200)

{ "removed": ["dQw4w9WgXcQ"] }

רשימת הסרטונים שלך

List your videos, one entry per video (its newest transcript), newest first, with the folders it's in and the outputs you've already made (summary, themes, mind_map, flashcards, notes, quiz, case_study), each with its languages.

GET/api/v2/videosFree: no credits

פרמטרים

folder_idquery

Only this folder's videos.

unfiledquery

true: only videos in no folder.

channelquery

Only this channel's videos (a channel_name from GET /api/v2/videos/channels).

sortquery

recent (default), oldest, longest, shortest or title.

searchquery

Title contains, or an exact video id.

pagequery

1-based. Default 1.

limitquery

1 to 100. Default 50.

# Every video, newest first
curl "https://www.youtubetranscript.dev/api/v2/videos?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Only one folder's videos
curl "https://www.youtubetranscript.dev/api/v2/videos?folder_id={folder_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

# One channel's videos, longest first
curl "https://www.youtubetranscript.dev/api/v2/videos?channel=TED&sort=longest" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Videos that aren't in any folder yet
curl "https://www.youtubetranscript.dev/api/v2/videos?unfiled=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

תגובה (200)

{
  "videos": [
    {
      "video_id": "dQw4w9WgXcQ",
      "transcript": { "id": "0b6f...", "language": "en", "source_kind": "manual" },
      "title": "Example video",
      "duration_seconds": 212,
      "channel_name": "Example Channel",
      "last_transcribed_at": "2026-10-28T18:02:11Z",
      "folder_ids": ["7c9e6679-7425-40de-944b-e07fc1f90ae7"],
      "outputs": {
        "summary": ["en"],
        "flashcards": ["en"],
        "mind_map": ["en", "es"]
      }
    }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 1, "total_pages": 1, "has_more": false }
}

רשימת הערוצים שלך

The channels your videos come from, most videos first, for filtering GET /api/v2/videos?channel=.

GET/api/v2/videos/channelsFree: no credits

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

תגובה (200)

{
  "channels": [
    { "channel_name": "TED", "video_count": 14 },
    { "channel_name": "Starter Story", "video_count": 9 }
  ]
}

הגדרת התיקיות של סרטון

Put one video in exactly these folders, adding and removing as needed ([] takes it out of all of them). GET the same path returns its folder_ids.

PUT/api/v2/videos/{video_id}/foldersFree: no credits

פרמטרים

video_idpathחובה

A video you have a transcript of.

folder_idsstring[]חובה

Your folder ids.

curl -X PUT https://www.youtubetranscript.dev/api/v2/videos/dQw4w9WgXcQ/folders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "folder_ids": ["7c9e6679-7425-40de-944b-e07fc1f90ae7"] }'

תגובה (200)

{
  "video_id": "dQw4w9WgXcQ",
  "folder_ids": ["7c9e6679-7425-40de-944b-e07fc1f90ae7"]
}

הצעת סרטונים לתיקייה

Videos you've transcribed that look like they belong in this folder, picked by AI from their titles (up to 20, best first). Add them with POST /api/v2/folders/{folder_id}/videos.

GET/api/v2/folders/{folder_id}/suggestionsFree: no credits

פרמטרים

folder_idpathחובה

One of your folders.

curl "https://www.youtubetranscript.dev/api/v2/folders/7c9e6679-7425-40de-944b-e07fc1f90ae7/suggestions" \
  -H "Authorization: Bearer YOUR_API_KEY"

תגובה (200)

{
  "folder_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "videos": [
    { "video_id": "dQw4w9WgXcQ", "title": "Keyword research for beginners", "channel_name": "Backlinko", "duration_seconds": 912 }
  ]
}

הצעת תיקיות לסרטון

Which of your folders a video fits (up to 3), picked by AI from its title, and a name for a new folder when none fits well (new_folder, or null).

GET/api/v2/videos/{video_id}/folder-suggestionsFree: no credits

פרמטרים

video_idpathחובה

A video you have a transcript of.

curl "https://www.youtubetranscript.dev/api/v2/videos/dQw4w9WgXcQ/folder-suggestions" \
  -H "Authorization: Bearer YOUR_API_KEY"

תגובה (200)

{
  "video_id": "dQw4w9WgXcQ",
  "folders": [{ "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "name": "SEO Hacks" }],
  "new_folder": null
}

חיפוש מילות מפתח

מצאו כל אזכור של מילה או ביטוי בתמלולים ששמרתם, עם חותמות זמן. התאמת טקסט פשוטה, בלי AI. חינם לכל חשבון, בלי קרדיטים. שמרו רשימות מילים כקבוצות וקבלו את אותן מילים בשפות אחרות.

חיפוש בתמלולים שלכם

Find every mention of your keywords across the transcripts you've saved, with timestamps and a snippet around each one. Plain text match (no AI). A transcript matches when it mentions any keyword. Results are sorted by most mentions, then newest.

POST/api/v2/library/searchFree: no credits

פרמטרים

keywordsstring[]חובה

Words or phrases to find (up to 50). Required unless keyword_set_id is set.

keyword_set_idstring

Use a saved keyword set's keywords instead of keywords.

excludestring[]

Leave out transcripts that mention any of these.

whole_wordboolean

Match whole words only (default true). Languages written without spaces, like Chinese or Japanese, always match as written.

video_idsstring[]

Search only these videos (up to 500). Default: your 1,000 most recent transcripts.

limitinteger

Transcripts to return, up to 100 (default 50).

curl -X POST https://www.youtubetranscript.dev/api/v2/library/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keywords": ["MRR", "churn"], "exclude": ["sponsor"], "whole_word": true }'

תגובה (200)

{
  "keywords": ["MRR", "churn"],
  "scanned": 412,
  "results": [
    {
      "transcript_id": "3f2b7c1e-8a4d-4f7e-9c11-2d5e6f7a8b9c",
      "video_id": "dQw4w9WgXcQ",
      "title": "I quit my job to build this micro-SaaS",
      "channel_id": "UCxRw2DkbN2qY3Rr1oQ4uWzQ",
      "channel_name": "Starter Story",
      "language": "en",
      "created_at": "2026-10-25T14:02:11Z",
      "word_count": 6120,
      "duration_seconds": 2140,
      "total_matches": 3,
      "counts": { "MRR": 2, "churn": 1 },
      "matches": [
        { "keyword": "MRR", "start": 184.2, "snippet": "…we crossed $31,500 MRR last month…" }
      ]
    }
  ]
}

הצעת תרגומים

The same keywords in other languages, so a search also finds videos spoken in them (search matches words as written). Suggestions only: add the terms you want to keywords.

POST/api/v2/library/keywords/suggestFree: no credits

פרמטרים

keywordsstring[]חובה

The keywords to translate.

languagesstring[]

Up to 8 ISO 639-1 codes. Default: the languages your transcripts are in.

curl -X POST https://www.youtubetranscript.dev/api/v2/library/keywords/suggest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keywords": ["pricing"], "languages": ["es", "de"] }'

תגובה (200)

{
  "detected_language": "en",
  "languages": ["es", "de"],
  "suggestions": [
    { "language": "es", "name": "Spanish", "keywords": [{ "source": "pricing", "terms": ["precios", "precio"] }] },
    { "language": "de", "name": "German", "keywords": [{ "source": "pricing", "terms": ["Preisgestaltung", "Preise"] }] }
  ]
}

רשימת קבוצות מילים

Your saved keyword sets, most recently changed first.

GET/api/v2/library/keyword-setsFree: no credits

curl "https://www.youtubetranscript.dev/api/v2/library/keyword-sets" \
  -H "Authorization: Bearer YOUR_API_KEY"

תגובה (200)

{
  "keyword_sets": [
    {
      "id": "8b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
      "name": "SaaS metrics",
      "keywords": ["MRR", "ARR", "churn"],
      "created_at": "2026-10-30T09:12:00Z",
      "updated_at": "2026-10-31T10:00:00Z"
    }
  ]
}

שמירת קבוצת מילים

Save a list of keywords under a name, to search with again (keyword_set_id).

POST/api/v2/library/keyword-setsFree: no credits

פרמטרים

namestringחובה

The set's name.

keywordsstring[]חובה

Words or phrases (up to 50).

curl -X POST https://www.youtubetranscript.dev/api/v2/library/keyword-sets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "SaaS metrics", "keywords": ["MRR", "ARR", "churn"] }'

תגובה (201)

{
  "keyword_set": {
    "id": "8b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
    "name": "SaaS metrics",
    "keywords": ["MRR", "ARR", "churn"],
    "created_at": "2026-10-31T10:00:00Z",
    "updated_at": "2026-10-31T10:00:00Z"
  }
}

עדכון קבוצת מילים

Rename a keyword set or replace its keywords.

PATCH/api/v2/library/keyword-sets/{set_id}Free: no credits

פרמטרים

set_idpathחובה

One of your keyword sets.

namestring

New name.

keywordsstring[]

The new full list of keywords.

curl -X PATCH https://www.youtubetranscript.dev/api/v2/library/keyword-sets/8b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keywords": ["MRR", "ARR", "churn", "LTV"] }'

תגובה (200)

{
  "keyword_set": {
    "id": "8b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
    "name": "SaaS metrics",
    "keywords": ["MRR", "ARR", "churn"],
    "created_at": "2026-10-31T10:00:00Z",
    "updated_at": "2026-10-31T10:00:00Z"
  }
}

מחיקת קבוצת מילים

Delete a keyword set.

DELETE/api/v2/library/keyword-sets/{set_id}Free: no credits

פרמטרים

set_idpathחובה

One of your keyword sets.

curl -X DELETE https://www.youtubetranscript.dev/api/v2/library/keyword-sets/8b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e \
  -H "Authorization: Bearer YOUR_API_KEY"

תגובה (200)

{ "deleted": true }

פלייליסטים

המירו פלייליסט למזהי סרטונים, תמללו אותם עם /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
}

api-docs.docs.nav.endpoints.recommendations-videos

Newest uploads from the channels you transcribe most, excluding videos you have already transcribed. Results are interleaved across channels, newest first. Free: no credits are charged. Pass the returned url or video_id to /api/v2/transcribe or /api/v2/batch.

GET/api/v2/recommendations/videos

פרמטרים

limitquery

Max videos returned (default 6, max 30).

channelsquery

How many of your top channels to draw from (default 3, max 10).

curl -X GET "https://www.youtubetranscript.dev/api/v2/recommendations/videos?limit=6" \
  -H "Authorization: Bearer YOUR_API_KEY"

תגובה (200)

{
  "recommendations": [
    {
      "video_id": "dQw4w9WgXcQ",
      "title": "Latest upload",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg",
      "published_at": "2026-10-17T15:00:00Z",
      "duration_seconds": 1089,
      "channel_id": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
      "channel_title": "YouTube"
    }
  ],
  "channels": [
    {
      "channel_id": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
      "channel_title": "YouTube",
      "transcribed_count": 12
    }
  ],
  "count": 1
}

חיפוש

חפשו, ואז תמללו:1. GET /api/v2/search/videos (/shorts, /channels, /playlists): חיפוש תוכן לפי מילת מפתח. קרדיט אחד לכל בקשה.2. שלחו את ה-url של סרטון אל POST /api/v2/transcribe, או את ה-url של ערוץ או פלייליסט אל /api/v2/channels/resolve או /api/v2/playlists/resolve.3. העבירו את next_page_token בתור page_token כדי לקבל תוצאות נוספות (קרדיט אחד לכל עמוד).איך ההתאמה עובדת: התוצאות זהות לחיפוש של YouTube עצמו, ומדורגות לפי רלוונטיות לפי הכותרת, התיאור והתוכן של כל סרטון. הן לא מסוננות לפי מילים מדויקות, ולכן חלק מהתוצאות לא יכילו את כל המילים שחיפשתם. אם אתם צריכים התאמות מדויקות, סננו את התוצאות לפי title בצד שלכם.

חיפוש סרטונים

Search YouTube videos by keyword, ranked by relevance like YouTube's own search (not filtered by exact words). 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, ranked by relevance like YouTube's own search (not filtered by exact words). 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
}

אינטגרציות

SDK רשמיים, שרת MCP ל־Claude ול־Cursor, GPT מותאם אישית ותבניות מוכנות ל־Make ול־n8n.

MCP serverClaude · Cursor

מאגר

הוסיפו את שרת ה־MCP של YouTube Transcript ל־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 מלאים, ניסיונות חוזרים, כלי עזר לעימוד ואימות חתימות webhook.

התקנה ושימוש

npm install youtube-transcript-api

Python SDKPyPI

PyPI

לקוחות סינכרוניים ואסינכרוניים, type stubs וכלי עזר לתהליכי אצווה ו־webhook.

התקנה ושימוש

pip install youtubetranscriptdevapi

Custom GPTChatGPT

פתיחה ב־ChatGPT

הוסיפו את ה־GPT המותאם שלנו ל־ChatGPT כדי לסכם, לצטט, לתרגם או לתשאל כל סרטון YouTube בשפה טבעית. מאחורי הקלעים הוא מבוסס על /api/v2/gpt/*.

· התחברות OAuth: בלי מפתח API בצ'אט
· גיבוי 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 }
    }

HTTP node של n8n

{
  "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

שגיאות

שגיאות מחזירות גוף JSON עם code ו־message. סטטוס ה־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

מגבלות קצב ומכסות

מגבלות לפי תוכנית לבקשות רציפות ולגודל אצוות. חריגה מהמגבלה בפרצי תעבורה מחזירה 429 עם כותרת Retry-After.

תוכנית	בקשות	גודל אצווה
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

זמינות ותקלות

משאבים קשורים

איך לחלץ תמלוליםמדריך צעד אחר צעד לחילוץ תמלולים מ־YouTube עיבוד תמלולים בכמויותעבדו פלייליסטים וערוצים דרך ה־API API לתמלולי YouTubeחלצו תמלולים באופן תכנותי עם ה-REST API שלנו תבניות אוטומציהתהליכי עבודה בסיסיים ב-Make.com וב-n8n עבור V2 API מסלולי תמחורמסלולי Free, ‏Basic, ‏Pro ו-Business