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

PlanFiyatKredi/ayEk paket fiyatıHız sınırı
Ücretsiz$0100 (tek seferlik)60 istek/dk
Aylık$5,00/ay1.000$2,50 / 1.000200 istek/dk
Yıllık$4,50/ay ($54/yıl)1.000$1,50 / 1.000300 istek/dk

1 kredi = 1 başarılı istek. Başarısız isteklerden hiçbir zaman ücret alınmaz. 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.

ParametreZorunluAçıklama
vEvetVideo ID'si veya tam YouTube URL'si
languageHayırDil kodu (varsayılan: en)

İ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",
    "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
  }
}
GET/search1 kredi / sayfa

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

ParametreZorunluAçıklama
qEvetArama sorgusu (en az 2 karakter)
countryHayır2 harfli ülke kodu (varsayılan: us)
languageHayırDil kodu (varsayılan: en)
page_tokenHayırBir sonraki sayfayı almak için önceki yanıtın pagination.next_page_token değeri
limitHayırMaksimum 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": "..." } } ],
    "pagination": { "next_page_token": "..." }
  }
}
GET/resolveÜcretsiz

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.

ParametreZorunluAçıklama
handleEvetKanal 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": "scrape"
  }
}
GET/playlist1 kredi / sayfa

Bir çalma listesindeki videoları alın. Şu anda yalnızca ilk sayfayı döndürür - has_more, daha fazla video olup olmadığını belirtir, ancak ek sayfaları çekme henüz desteklenmiyor.

ParametreZorunluAçıklama
listEvetÇalma listesi ID'si veya URL'si

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

Hatalar

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

DurumKodAnlamı
400BAD_REQUESTEksik veya geçersiz parametre
401MISSING_API_KEY / INVALID_API_KEYAnahtar sağlanmadı veya anahtar geçersiz/iptal edilmiş
402PAYMENT_REQUIREDKredi kalmadı - ek paket satın alın veya yükseltin
404VIDEO_UNAVAILABLE / TRANSCRIPT_NOT_FOUNDVideo veya kaynak bulunamadı
429RATE_LIMITEDPlan katmanınız için çok fazla istek
503UPSTREAM_UNAVAILABLEGeçici üst kaynak sorunu - yeniden denemek güvenli

Yakında

Bir kanal içinde arama, bir kanaldaki tüm videoları listeleme ve tam çalma listesi sayfalama üzerinde çalışılıyor. Yeni yüklemeleri RSS ile takip etme, YouTube tarafındaki ilgisiz bir sorun nedeniyle geçici olarak kullanılamıyor.

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.