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/v1Krediler ve planlar
| Plan | Fiyat | Kredi/ay | Ek paket fiyatı | Hız sınırı |
|---|---|---|---|---|
| Ücretsiz | $0 | 100 (tek seferlik) | — | 60 istek/dk |
| Aylık | $5,00/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 |
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
/transcript1 krediBir YouTube videosunun transkriptini, meta verilerle (başlık, kanal, küçük resim) birlikte alın.
| Parametre | Zorunlu | Açıklama |
|---|---|---|
v | Evet | Video ID'si veya tam YouTube URL'si |
language | Hayır | Dil 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
}
}/search1 kredi / sayfaFiltreler 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 pagination.next_page_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": "..." } } ],
"pagination": { "next_page_token": "..." }
}
}/resolveÜcretsizBir 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": "scrape"
}
}/playlist1 kredi / sayfaBir ç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.
| Parametre | Zorunlu | Açıklama |
|---|---|---|
list | Evet | Ç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:
| Durum | Kod | Anlamı |
|---|---|---|
| 400 | BAD_REQUEST | Eksik veya geçersiz parametre |
| 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 |
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.