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

Jawaban singkat

Parameter video_url, format, dan include_timestamp milik TranscriptAPI.com sepadan dengan v dan language kami - tapi API publik kami tidak menampilkan timestamp per segmen seperti opsi format=json mereka. Jika Anda hanya butuh teks transkrip biasa dan metadata, ini hampir seperti pengganti langsung; jika Anda bergantung pada timestamp tingkat segmen dari respons API itu sendiri, baca bagian celah sebelum beralih.

Pemetaan parameter

Kedua API mengautentikasi dengan token bearer dan menerima URL lengkap, URL pendek, atau ID video polos. Berikut cara parameter transkrip TranscriptAPI lainnya sepadan dengan milik kami:

TranscriptAPI.com	GetYouTubeTranscript	Catatan
`Authorization: Bearer KEY`	`Authorization: Bearer KEY`	Kami juga menerima x-api-key sebagai header alternatif.
`video_url`	`v (atau url, videoId)`	Format yang diterima sama: URL lengkap, URL pendek, atau ID 11 karakter polos.
`language`	`language`	Milik kami menerima satu kode dengan default, bukan daftar prioritas dipisah koma - minta satu bahasa per panggilan.
`format=json\|text`	`(tidak ada - selalu teks biasa)`	Respons kami selalu mengembalikan string transkrip yang diratakan di field transcript, setara dengan format=text mereka.
`include_timestamp`	`(tidak tersedia)`	Timestamp per segmen (start/duration) tidak ada di respons publik kami saat ini - lihat celah di bawah.
`send_metadata=true`	`(selalu disertakan)`	title, author_name, author_url, dan thumbnail_url selalu ada di respons - tidak perlu flag.

Sebelum / sesudah

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

Video yang sama, satu kredit di kedua sisi. Metadata kembali secara default di sisi kami, jadi tidak ada flag send_metadata yang perlu diingat.

Endpoint lainnya

TranscriptAPI.com	GetYouTubeTranscript	Catatan
`GET /youtube/info (gratis)`	`GET /resolve?handle=... (gratis)`	Milik kami mengurai handle/URL menjadi ID channel; untuk metadata level video, panggil /transcript dan baca field responsnya.
`GET /youtube/search (1 kredit)`	`GET /search?q=... (1 kredit/halaman)`	Ide yang sama - pencarian berpaginasi, satu kredit per halaman yang diambil.
`GET /youtube/channel/resolve (gratis)`	`GET /resolve?handle=... (gratis)`	Setara langsung.
`GET /youtube/channel/videos (1/halaman)`	`GET /channel/videos?channel=... (1 kredit/halaman)`	Model paginasi yang sama - kembalikan token continuation dari respons.
`GET /youtube/channel/search (1 kredit)`	`GET /channel/search?channel=...&q=... (1 kredit/halaman)`	Setara langsung.
`GET /youtube/channel/playlists, /channel/posts`	`(tidak ada padanan)`	Belum ditawarkan saat ini - lihat celah di bawah.

Yang tidak sepadan 1:1

Tidak ada timestamp per segmen di respons API. format=json + include_timestamp=true milik TranscriptAPI mengembalikan segmen dengan start/duration; API publik kami hanya mengembalikan string transkrip yang diratakan. (Timestamp tingkat segmen ada di database kami dan menjalankan tampilan transkrip yang dapat diklik di situs itu sendiri - hanya saja belum ada di respons API publik.)
language di sini adalah satu kode, bukan daftar prioritas. TranscriptAPI mencoba daftar dipisah koma seperti de,en,asr dari kiri ke kanan; milik kami menerima satu kode dengan default. Jika Anda mengandalkan rantai fallback, coba lagi sendiri dengan nilai lain.
Tidak ada endpoint playlist channel atau postingan channel. /channel/playlists dan /channel/posts milik TranscriptAPI belum memiliki padanan di sini.

Jika teks transkrip biasa, metadata, pencarian, dan data channel mencakup kasus penggunaan Anda, ini hampir seperti pengganti langsung - daftar untuk 100 kredit gratis (tanpa kartu) dan lihat daftar harga dan endpoint lengkap, atau cek dokumentasi API untuk referensi parameter lengkap.

FAQ migrasi

Q01

Apakah saya perlu mengubah header autentikasi saya?

Tidak - kedua API menggunakan Authorization: Bearer KUNCI_ANDA. Milik kami juga menerima x-api-key sebagai alternatif.

Q02

Apakah URL dan ID video yang sudah ada tetap berfungsi?

Ya - kedua API menerima URL YouTube lengkap, URL pendek youtu.be, atau ID video 11 karakter di posisi parameter yang sama (video_url di sana, v di sini).

Q03

Apa yang terjadi jika saya mengirim daftar bahasa dipisah koma seperti format TranscriptAPI?

Parameter language kami mengharapkan satu kode, bukan daftar. Nilai dipisah koma kemungkinan tidak akan cocok - minta satu bahasa per panggilan, dan coba lagi dengan nilai lain jika perlu rantai fallback.

Q04

Bisakah saya mendapatkan timestamp tingkat segmen dari API Anda?

Tidak dari respons API REST publik saat ini - itu mengembalikan teks transkrip yang diratakan. Jika migrasi Anda bergantung pada itu, tunggu sampai tersedia, atau gunakan tampilan transkrip situs itu sendiri yang mendukungnya.

Q05

Apakah ini gratis untuk dicoba?

100 kredit gratis saat mendaftar, tanpa kartu - cukup untuk menguji endpoint transkrip, pencarian, dan channel sebelum berkomitmen pada satu paket.

Terkait