Entegrasyonlar

Migrating from TranscriptAPI.com: A Field Guide

Switching a YouTube transcript integration from TranscriptAPI.com to GetYouTubeTranscript - parameter mapping, a before/after curl example, endpoint equivalents, and the real gaps that do not map 1:1.

00:06:00 · SEP 26, 2026 · GÜNCELLENDI OCT 09, 2026

Hızlı yanıt

TranscriptAPI.com'un video_url, format ve include_timestamp parametreleri bizim v, language ve timestamps parametrelerimize karşılık gelir: onların format=json seçeneğindeki gibi segment başına start/duration zaman damgaları için timestamps=true ekle. Sadece düz metin ve meta verilere ihtiyacın varsa eklemene gerek yok. Her iki durumda da geçiş neredeyse birebir; kalan farklar aşağıda listelendi.

Parametre eşleme

Her iki API de bearer token ile kimlik doğrular ve tam URL, kısa URL veya sade video ID kabul eder. TranscriptAPI'nin diğer transkript parametreleri bizimkiyle şöyle eşleşir:

TranscriptAPI.com	GetYouTubeTranscript	Not
`Authorization: Bearer KEY`	`Authorization: Bearer KEY`	Alternatif başlık olarak x-api-key'i de kabul ediyoruz.
`video_url`	`v (veya url, videoId)`	Aynı kabul edilen biçimler: tam URL, kısa URL, veya sade 11 karakterlik ID.
`language`	`language`	Bizimki, virgülle ayrılmış öncelik listesi değil, varsayılanlı tek bir kod alır - her çağrıda tek bir dil isteyin.
`format=json\|text`	`(yok - her zaman düz metin)`	Yanıtımız her zaman transcript alanında düzleştirilmiş metni döndürür, bu onların format=text'ine eşdeğerdir.
`include_timestamp`	`(sunulmuyor)`	Segment başına start/duration zaman damgaları bugün genel yanıtımızda yok - aşağıdaki farklara bakın.
`send_metadata=true`	`(her zaman dahil)`	title, author_name, author_url ve thumbnail_url her zaman yanıtta yer alır - herhangi bir bayrağa gerek yok.

Önce / sonra

TranscriptAPI.com

curl -X GET "https://transcriptapi.com/api/v2/youtube/transcript?video_url=https://youtu.be/dQw4w9WgXcQ&language=en&send_metadata=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

GetYouTubeTranscript

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

# => { "success": true, "data": { "video_id": "...", "language_code": "en",
#      "requested_language": "en", "caption_type": "manual",
#      "title": "...", "author_name": "...", "author_url": "...",
#      "thumbnail_url": "...", "transcript": "...", "word_count": 1847,
#      "cached": true, "fetched_at": "..." } }

Aynı video, her iki tarafta da bir kredi. Bizim tarafımızda meta veri varsayılan olarak döner, bu yüzden hatırlanması gereken bir send_metadata bayrağı yok.

Diğer endpoint'ler

TranscriptAPI.com	GetYouTubeTranscript	Not
`GET /youtube/info (ücretsiz)`	`GET /resolve?handle=... (1 kredi)`	Bizimki bir handle/URL'yi kanal ID'sine çözer; video düzeyinde meta veri için /transcript'i çağırıp yanıt alanlarını okuyun.
`GET /youtube/search (1 kredi)`	`GET /search?q=... (1 kredi/sayfa)`	Aynı fikir - sayfalanmış arama, getirilen her sayfa için bir kredi.
`GET /youtube/channel/resolve (ücretsiz)`	`GET /resolve?handle=... (1 kredi)`	Doğrudan eşdeğer.
`GET /youtube/channel/videos (1/sayfa)`	`GET /channel/videos?channel=... (1 kredi/sayfa)`	Aynı sayfalama modeli - yanıttaki continuation token'ı geri gönderin.
`GET /youtube/channel/search (1 kredi)`	`GET /channel/search?channel=...&q=... (1 kredi/sayfa)`	Doğrudan eşdeğer.
`GET /youtube/channel/playlists, /channel/posts`	`(eşdeğeri yok)`	Şu anda sunulmuyor - aşağıdaki farklara bakın.

1:1 eşleşmeyenler

language burada tek bir kod, öncelik listesi değil. TranscriptAPI, de,en,asr gibi virgülle ayrılmış bir listeyi soldan sağa dener; bizimki varsayılanlı tek bir kod alır. Bir yedek zincirine güveniyorsanız, farklı bir değerle kendiniz yeniden deneyin.
Kanal oynatma listesi veya kanal gönderisi endpoint'i yok. TranscriptAPI'nin /channel/playlists ve /channel/posts'unun burada şu anda bir eşdeğeri yok.

Düz transkript metni, meta veri, arama ve kanal verisi kullanım durumunuzu karşılıyorsa, bu neredeyse doğrudan bir değişimdir - 100 ücretsiz kredi için (kart gerekmez) kaydolun ve tam fiyat ve endpoint listesini görün, ya da tam parametre referansı için API belgelerine bakın.

Geçiş SSS

Q01

Kimlik doğrulama başlığımı değiştirmem gerekiyor mu?

Hayır - her iki API de Authorization: Bearer ANAHTARINIZ kullanır. Bizimki alternatif olarak x-api-key'i de kabul eder.

Q02

Mevcut video URL'lerim ve ID'lerim çalışmaya devam edecek mi?

Evet - her iki API de aynı parametre konumunda (orada video_url, burada v) tam bir YouTube URL'si, kısa bir youtu.be URL'si veya 11 karakterlik sade bir video ID'si kabul eder.

Q03

TranscriptAPI'nin formatı gibi virgülle ayrılmış bir dil listesi gönderirsem ne olur?

Bizim language parametremiz bir liste değil, tek bir kod bekler. Virgülle ayrılmış bir değer muhtemelen eşleşmeyecektir - her çağrıda tek bir dil isteyin, ve bir yedek zincire ihtiyacınız varsa farklı bir değerle yeniden deneyin.

Q04

API'nizden segment düzeyinde zaman damgaları alabilir miyim?

Bugün genel REST API yanıtından alamazsınız - o, düzleştirilmiş transkript metnini döndürür. Geçişiniz buna bağlıysa, sunulana kadar bekleyin veya bunu destekleyen web sitesinin kendi transkript görünümünü kullanın.

Q05

Denemek ücretsiz mi?

Kayıt olurken 100 ücretsiz kredi, kart gerekmez - bir plana karar vermeden önce transkript, arama ve kanal endpoint'lerini test etmeye yeter.

İlgili

Migrating from TranscriptAPI.com: A Field Guide

Parametre eşleme

Önce / sonra

Diğer endpoint'ler

Geçiş SSS

Kimlik doğrulama başlığımı değiştirmem gerekiyor mu?

Mevcut video URL'lerim ve ID'lerim çalışmaya devam edecek mi?

TranscriptAPI'nin formatı gibi virgülle ayrılmış bir dil listesi gönderirsem ne olur?

API'nizden segment düzeyinde zaman damgaları alabilir miyim?

Denemek ücretsiz mi?

Araçlar

Sosyal medya

Biçimler

Yapay zekâ ajanları

SDK'lar ve otomasyon