API Dokümantasyonu

YouTube transkriptleri, arama ve meta veriler için bir REST API. Panelinizden bir API anahtarı alın — 100 ücretsiz kredi, kart gerektirmez.

Kimlik Doğrulama

API anahtarınızı bir bearer token olarak veya x-api-key üzerinden geçirin:

Authorization: Bearer sk_live_...
# or
x-api-key: sk_live_...

Temel URL

https://getyoutubetranscript.com/api/v1

Krediler ve planlar

Plan	Fiyat	Kredi/ay	Ek paket fiyatı	Hız sınırı
Ücretsiz	$0/ay	100 (tek seferlik)	—	60 istek/dk
Aylık	$5/ay	1.000	$2,50 / 1.000	200 istek/dk
Yıllık	$4,50/ay ($54/yıl)	1.000	$1,50 / 1.000	300 istek/dk
Starter	$19/ay	7.500	$1,50 / 1.000	300 istek/dk
Pro	$49/ay	25.000	$1,50 / 1.000	400 istek/dk
Scale	$99/ay	60.000	$1,50 / 1.000	600 istek/dk

1 kredi = 1 başarılı istek. Başarısız isteklerden hiçbir zaman ücret alınmaz. Örnek: 2 videonun altyazısı olmayan 10 transkript isteği 8 kredi tutar; başarısız bir videoyu yeniden denemek, başarılı olana kadar ücretsizdir. Ek kredi paketleri satın alımdan 30 gün sonra veya mevcut faturalama döneminizin sonunda (hangisi daha geçse) sona erer ve harcanabilmesi için aktif bir abonelik gerektirir.

Uç Noktalar

GET/transcript1 kredi

Bir YouTube videosunun transkriptini, meta verilerle (başlık, kanal, küçük resim) birlikte alın. Ayrıca language_code ile requested_language, caption_type (manual veya auto, bilinmiyorsa null) ve cached / fetched_at değerlerini döndürür.

Parametre	Zorunlu	Açıklama
`v`	Evet	Video ID'si veya tam YouTube URL'si
`language`	Hayır	Dil kodu (varsayılan: en)
`timestamps`	Hayır	Satır başına zaman damgaları (segments: start, duration, text, saniye cinsinden) için true yap. Varsayılan olarak kapalı.
`translate`	Hayır	Makine çevirisi yapılacak dil kodu, örneğin es veya zh-CN. Zaman damgaları korunur; yanıta translated_to eklenir. Yine 1 kredi.

İstek

curl "https://getyoutubetranscript.com/api/v1/transcript?v=jNQXAC9IVRw" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "video_id": "jNQXAC9IVRw",
    "language_code": "en",
    "requested_language": "en",
    "caption_type": "manual",
    "title": "Me at the zoo",
    "author_name": "jawed",
    "author_url": "https://www.youtube.com/channel/UC4Qob...",
    "thumbnail_url": "https://...",
    "transcript": "All right, so here we are...",
    "word_count": 39,
    "cached": true,
    "fetched_at": "2026-09-20T03:10:58.938Z"
  }
}

GET/transcript/languages1 kredi

Bir videonun sunduğu altyazı dillerini (manuel ve otomatik oluşturulan) birini almadan önce listeler. default_language_code, /transcript'in dil verilmeden döndürdüğü dildir; altyazısı kapalı bir video boş liste döndürür.

Parametre	Zorunlu	Açıklama
`v`	Evet	Video ID'si veya tam YouTube URL'si

İstek

curl "https://getyoutubetranscript.com/api/v1/transcript/languages?v=kJQP7kiw5Fk" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "video_id": "kJQP7kiw5Fk",
    "default_language_code": "en",
    "languages": [
      { "language_code": "en", "name": "English - en", "caption_type": "manual" },
      { "language_code": "es", "name": "Spanish", "caption_type": "manual" }
    ]
  }
}

POST/batchBaşarılı video başına 1 kredi

Tek çağrıda en fazla 100 videoyu kuyruğa alın. Hemen bir batch_id döndürür ve transkriptleri arka planda getirir. GET /batch ile durumu sorgulayın ya da bitince imzalı bir POST (X-GYT-Signature başlığı) almak için webhook_url verin. Başarısız videolardan hiçbir zaman ücret alınmaz.

Parametre	Zorunlu	Açıklama
`videos`	Evet	Video ID veya URL dizisi (1-100). Tekrarlananlar bir kez getirilir.
`language`	Hayır	Tüm videolar için dil kodu (varsayılan: en)
`timestamps`	Hayır	Sonuçlara satır bazında segments eklemek için true
`webhook_url`	Hayır	Toplu iş bitince bildirim alan herkese açık https URL
`Idempotency-Key`	Hayır	Başlık. İsteği güvenle yeniden deneyin: aynı anahtar orijinal toplu işi döndürür.

İstek

curl -X POST "https://getyoutubetranscript.com/api/v1/batch" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
        "videos": ["jNQXAC9IVRw", "https://youtu.be/dQw4w9WgXcQ"],
        "webhook_url": "https://example.com/hooks/transcripts"
      }'

Yanıt

{
  "success": true,
  "data": {
    "batch_id": "324eb615-e4d5-4b3c-b8e7-04235671066b",
    "status": "queued",
    "total": 2,
    "succeeded": 0,
    "failed": 0,
    "pending": 2,
    "results_url": "https://getyoutubetranscript.com/api/v1/batch?id=324eb615-...",
    "webhook_secret": "whsec_..."
  }
}

GET/batchÜcretsiz

Toplu iş durumu, sayılar ve gönderim sırasına göre bir sayfa sonuç. Başarılı öğeler /transcript ile aynı alanlara sahiptir; başarısız öğelerde error_code bulunur.

Parametre	Zorunlu	Açıklama
`id`	Evet	POST /batch yanıtındaki batch_id
`offset`	Hayır	Atlanacak öğe sayısı (varsayılan: 0)
`limit`	Hayır	Sayfa başına öğe, 1-50 (varsayılan: 20)

İstek

curl "https://getyoutubetranscript.com/api/v1/batch?id=324eb615-e4d5-4b3c-b8e7-04235671066b" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "batch_id": "324eb615-...",
    "status": "completed",
    "total": 2,
    "succeeded": 1,
    "failed": 1,
    "credits_charged": 1,
    "items": [
      { "position": 0, "status": "succeeded", "charged": true, "video_id": "jNQXAC9IVRw", "caption_type": "manual", "transcript": "All right, so here we are...", ... },
      { "position": 1, "status": "failed", "charged": false, "video_id": "dQw4w9WgXcQ", "error_code": "TRANSCRIPT_DISABLED" }
    ],
    "next_offset": null
  }
}

GET/search1 kredi / sayfa

Filtreler ve sayfalama ile YouTube videolarında arama yapın.

Parametre	Zorunlu	Açıklama
`q`	Evet	Arama sorgusu (en az 2 karakter)
`country`	Hayır	2 harfli ülke kodu (varsayılan: us)
`language`	Hayır	Dil kodu (varsayılan: en)
`page_token`	Hayır	Bir sonraki sayfayı almak için önceki yanıtın continuation_token değeri
`limit`	Hayır	Maksimum sonuç sayısı (varsayılan 20, maksimum 50)

İstek

curl "https://getyoutubetranscript.com/api/v1/search?q=lofi+beats" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "query": "lofi beats",
    "video_results": [ { "title": "...", "videoId": "...", "channel": { "name": "..." } } ],
    "continuation_token": "c_bKt9xQ2mVf7LpR0aZ3sWyA"
  }
}

GET/resolve1 kredi

Bir kanal handle'ını, URL'sini veya kullanıcı adını gerçek kanal ID'sine çözümleyin. Sözdizimsel bir girdi (zaten bir kanal ID'si veya içinde bir tane barındıran URL) ağ çağrısı yapılmadan anında çözümlenir; sade bir handle ise gerçek bir arama tetikler.

Parametre	Zorunlu	Açıklama
`handle`	Evet	Kanal ID'si, URL veya @handle

İstek

curl "https://getyoutubetranscript.com/api/v1/resolve?handle=@mkbhd" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
    "title": "Marques Brownlee",
    "handle": "http://www.youtube.com/@mkbhd",
    "resolved_via": "lookup"
  }
}

GET/channel/latest1 kredi

Kanal bilgileri (başlık, abone sayısı, açıklama, avatar) ve kanalın ana sayfa sekmesindeki en yeni videolar. Tüm yükleme geçmişi için /channel/videos kullanın.

Parametre	Zorunlu	Açıklama
`channel`	Evet	Kanal @handle'ı, URL'si veya kanal kimliği

İstek

curl "https://getyoutubetranscript.com/api/v1/channel/latest?channel=@mkbhd" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "channel": { "id": "UCBJycsmduvYEL83R_U4JriQ", "title": "Marques Brownlee", "subscribers": 1160000, "avatar": "https://..." },
    "about": { "description": "...", "links": [] },
    "videos_sections": [ ... ]
  }
}

GET/channel/videos1 kredi / sayfa

Bir kanalın yüklediği tüm videolar, en yeniden eskiye, sayfalı.

Parametre	Zorunlu	Açıklama
`channel`	Evet	Kanal @handle'ı, URL'si veya kanal kimliği
`tab`	Hayır	videos (varsayılan), shorts veya streams (Canlı sekmesi). Yalnızca ilk sayfa.
`sort`	Hayır	latest (varsayılan), popular veya oldest. Yalnızca ilk sayfa.
`continuation`	Hayır	Sonraki sayfayı almak için önceki yanıttaki continuation_token (diğer parametrelerin yerine kullanın). 24 saat sonra geçersiz olur.

İstek

curl "https://getyoutubetranscript.com/api/v1/channel/videos?channel=@mkbhd&tab=shorts&sort=popular" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "videos": [ { "position": 1, "id": "...", "title": "...", "views": "6.2M", "published_time": "1d ago", "length": "10:47" } ],
    "has_more": true,
    "continuation_token": "c_pqHR9v13sqaqxlcKhA4MnA"
  }
}

GET/channel/playlists1 kredi / sayfa

Bir kanalın oynatma listeleri (Oynatma listeleri sekmesi), sayfa sayfa. Videolarını listelemek için bir oynatma listesi kimliğini /playlist'e verin.

Parametre	Zorunlu	Açıklama
`channel`	Evet	Kanal @handle'ı, URL'si veya kanal kimliği
`continuation`	Hayır	Sonraki sayfayı almak için önceki yanıttaki continuation_token (diğer parametrelerin yerine kullanın). 24 saat sonra geçersiz olur.

İstek

curl "https://getyoutubetranscript.com/api/v1/channel/playlists?channel=@mkbhd" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "playlists": [ { "position": 1, "id": "PL...", "title": "...", "link": "https://www.youtube.com/playlist?list=PL...", "video_count": 5 } ],
    "has_more": false,
    "continuation_token": null
  }
}

GET/channel/posts1 kredi / sayfa

Bir kanalın topluluk gönderileri (Gönderiler sekmesi), sayfa sayfa: metin, bağlantılar, beğeniler, yorumlar ve ekli görsel.

Parametre	Zorunlu	Açıklama
`channel`	Evet	Kanal @handle'ı, URL'si veya kanal kimliği
`continuation`	Hayır	Sonraki sayfayı almak için önceki yanıttaki continuation_token (diğer parametrelerin yerine kullanın). 24 saat sonra geçersiz olur.

İstek

curl "https://getyoutubetranscript.com/api/v1/channel/posts?channel=@mkbhd" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "posts": [ { "position": 1, "id": "Ugkx...", "url": "https://www.youtube.com/post/Ugkx...", "text": "...", "published_time": "2 years ago", "likes": "12K", "comments": "1K" } ],
    "has_more": true,
    "continuation_token": "c_DfE9mQx2Ln8TbW4kJ1pZsA"
  }
}

GET/channel/search1 kredi / sayfa

Tek bir kanalın videoları içinde arama, sayfalı.

Parametre	Zorunlu	Açıklama
`channel`	Evet	Kanal @handle'ı, URL'si veya kanal kimliği
`q`	Evet	Arama sorgusu (en az 2 karakter)
`continuation`	Hayır	Sonraki sayfayı almak için önceki yanıttaki continuation_token (diğer parametrelerin yerine kullanın). 24 saat sonra geçersiz olur.

İstek

curl "https://getyoutubetranscript.com/api/v1/channel/search?channel=@mkbhd&q=iphone" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "videos": [ { "position": 1, "id": "...", "title": "...", "published_time": "3w ago", "length": "17:14", "channel": { "name": "Marques Brownlee" } } ],
    "has_more": true,
    "continuation_token": "c_pnm10M6orzLgOTVWJk2oww"
  }
}

GET/playlist1 kredi / sayfa

Bir oynatma listesindeki tüm videolar, sayfalı. Son sayfada continuation_token null olur.

Parametre	Zorunlu	Açıklama
`list`	Evet	Çalma listesi ID'si veya URL'si
`continuation`	Hayır	Sonraki sayfayı almak için önceki yanıttaki continuation_token (diğer parametrelerin yerine kullanın). 24 saat sonra geçersiz olur.

İstek

curl "https://getyoutubetranscript.com/api/v1/playlist?list=PLxxx" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "playlist_id": "PLxxx",
    "title": "...",
    "videos": [ { "position": 1, "id": "...", "title": "...", "channel": { "name": "..." } } ],
    "has_more": true,
    "continuation_token": "c_DfE9mQx2Ln8TbW4kJ1pZsA"
  }
}

GET/video/related1 kredi

YouTube'un bir videonun yanında önerdiği videolar; başlık, kimlik, kanal, izlenme, yaş ve süre ile birlikte.

Parametre	Zorunlu	Açıklama
`v`	Evet	Video ID'si veya tam YouTube URL'si

İstek

curl "https://getyoutubetranscript.com/api/v1/video/related?v=dQw4w9WgXcQ" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "video_id": "dQw4w9WgXcQ",
    "related": [ { "position": 1, "id": "...", "title": "...", "channel": { "name": "..." }, "views": "410K", "published_time": "11y ago", "length": "1:01:35" } ]
  }
}

GET/video/dislikes1 kredi

Bir videonun tahmini beğeni ve beğenmeme sayıları. YouTube artık beğenmeme sayısını yayınlamadığı için bunlar tahmindir (estimated her zaman true).

Parametre	Zorunlu	Açıklama
`v`	Evet	Video ID'si veya tam YouTube URL'si

İstek

curl "https://getyoutubetranscript.com/api/v1/video/dislikes?v=dQw4w9WgXcQ" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "video_id": "dQw4w9WgXcQ",
    "likes": 19497714,
    "dislikes": 521713,
    "rating": 4.9,
    "view_count": 1830715799,
    "estimated": true
  }
}

GET/channel/banner1 kredi

Bir kanalın kırpılmamış banner'ı, YouTube'un sunduğu tüm kırpma boyutları ve avatarı. Kanalın banner'ı yoksa has_banner false olur.

Parametre	Zorunlu	Açıklama
`channel`	Evet	Kanal @handle'ı, URL'si veya kanal kimliği

İstek

curl "https://getyoutubetranscript.com/api/v1/channel/banner?channel=@mkbhd" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
    "title": "Marques Brownlee",
    "avatar": "https://yt3.googleusercontent.com/...",
    "has_banner": true,
    "banner": { "original": "https://...=s0", "largest": "https://...=w2560", "sizes": [ { "url": "https://...", "width": 1060, "height": 175 } ] }
  }
}

GET/creditsÜcretsiz

Bu anahtarın kalan kredi bakiyesini harcamadan önce kontrol edin - MCP get_credits aracının döndürdüğü ile aynı veriler.

Parametre	Zorunlu	Açıklama

İstek

curl "https://getyoutubetranscript.com/api/v1/credits" \
  -H "Authorization: Bearer sk_live_..."

Yanıt

{
  "success": true,
  "data": {
    "plan_credits_left": 87,
    "topup_credits_left": 0,
    "plan": "monthly",
    "rate_limit_per_minute": 200
  }
}

Hatalar

Hatalar, HTTP durumuna ek olarak dallanmak için sabit bir code alanı içeren bir JSON gövdesi döndürür:

Durum	Kod	Anlamı
400	`BAD_REQUEST`	Eksik veya geçersiz parametre
400	`CURSOR_EXPIRED`	Sayfa imleci süresi doldu (24 saat sonra) - ilk sayfadan yeniden başlayın
401	`MISSING_API_KEY / INVALID_API_KEY`	Anahtar sağlanmadı veya anahtar geçersiz/iptal edilmiş
402	`PAYMENT_REQUIRED`	Kredi kalmadı - ek paket satın alın veya yükseltin
404	`VIDEO_UNAVAILABLE / TRANSCRIPT_NOT_FOUND`	Video veya kaynak bulunamadı
429	`RATE_LIMITED`	Plan katmanınız için çok fazla istek
503	`UPSTREAM_UNAVAILABLE`	Geçici üst kaynak sorunu - yeniden denemek güvenli
504	`UPSTREAM_TIMEOUT`	Kaynak 25 saniyeden uzun sürdü - ücret alınmaz, yeniden denemek güvenlidir

Bu API'yi bir AI aracıyla kullanma

İstekleri elle yazmak yerine Claude'un (veya başka bir AI kodlama aracının) bu API'yi sizin için çağırmasını mı tercih ediyorsunuz? Transkript almayı, arama yapmayı ve daha fazlasını öğreten hazır bir Claude Skill olan YouTube Transcript skill'ini indirin.

Zapier'de kullanın

Kod gerekmez: Zapier uygulamamız her Zap'te transkript alır, YouTube'da arama yapar veya bir kanalın videolarını listeler. Aynı API anahtarıyla bağlayın; her eylem API çağrısıyla aynı krediyi harcar.

API Dokümantasyonu

Kimlik Doğrulama

Temel URL

Krediler ve planlar

Uç Noktalar

Hatalar

Bu API'yi bir AI aracıyla kullanma

Zapier'de kullanın

Araçlar

Sosyal medya

Biçimler

Yapay zekâ ajanları

SDK'lar ve otomasyon