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

Hızlı yanıt

TranscriptAPI.com'un video_url, format ve include_timestamp parametreleri bizim v ve language parametrelerimizle eşleşir - ancak genel API'miz onların format=json seçeneği gibi segment başına zaman damgası sunmaz. Yalnızca düz transkript metnine ve meta verilere ihtiyacınız varsa, bu neredeyse doğrudan bir değişimdir; API yanıtının kendisinden segment düzeyinde zaman damgalarına bağımlıysanız, geçiş yapmadan önce farklar bölümünü okuyun.

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",
#      "title": "...", "author_name": "...", "author_url": "...",
#      "thumbnail_url": "...", "transcript": "...", "word_count": 1847 } }

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=... (ücretsiz)`	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=... (ücretsiz)`	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

API yanıtında segment başına zaman damgası yok. TranscriptAPI'nin format=json + include_timestamp=true seçeneği start/duration içeren segmentler döndürür; genel API'miz yalnızca düzleştirilmiş transkript metnini döndürür. (Segment düzeyinde zaman damgaları veritabanımızda mevcuttur ve web sitesinin kendisindeki tıklanabilir transkript görünümünü besler - sadece henüz genel API yanıtında değildir.)
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