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

Trả lời nhanh

Các tham số video_url, format và include_timestamp của TranscriptAPI.com tương ứng với v và language của chúng tôi - nhưng API công khai của chúng tôi không cung cấp dấu thời gian theo từng đoạn như tùy chọn format=json của họ. Nếu bạn chỉ cần văn bản chép lời thuần và metadata, đây gần như là thay thế trực tiếp; nếu bạn phụ thuộc vào dấu thời gian cấp đoạn từ chính phản hồi API, hãy đọc phần chênh lệch trước khi chuyển đổi.

Ánh xạ tham số

Cả hai API đều xác thực bằng bearer token và chấp nhận URL đầy đủ, URL rút gọn, hoặc ID video trần. Đây là cách các tham số chép lời còn lại của TranscriptAPI tương ứng với chúng tôi:

TranscriptAPI.com	GetYouTubeTranscript	Ghi chú
`Authorization: Bearer KEY`	`Authorization: Bearer KEY`	Chúng tôi cũng chấp nhận x-api-key như một header thay thế.
`video_url`	`v (hoặc url, videoId)`	Cùng định dạng được chấp nhận: URL đầy đủ, URL rút gọn, hoặc ID 11 ký tự trần.
`language`	`language`	Của chúng tôi nhận một mã duy nhất với giá trị mặc định, không phải danh sách ưu tiên phân tách bằng dấu phẩy - yêu cầu một ngôn ngữ mỗi lần gọi.
`format=json\|text`	`(không có - luôn là văn bản thuần)`	Phản hồi của chúng tôi luôn trả về chuỗi chép lời được làm phẳng trong trường transcript, tương đương format=text của họ.
`include_timestamp`	`(không cung cấp)`	Dấu thời gian theo đoạn (start/duration) hiện không có trong phản hồi công khai của chúng tôi - xem phần chênh lệch bên dưới.
`send_metadata=true`	`(luôn được bao gồm)`	title, author_name, author_url, và thumbnail_url luôn có trong phản hồi - không cần cờ nào.

Trước / sau

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

Cùng một video, một tín dụng ở cả hai bên. Metadata trả về mặc định ở phía chúng tôi, nên không có cờ send_metadata nào cần nhớ.

Các endpoint khác

TranscriptAPI.com	GetYouTubeTranscript	Ghi chú
`GET /youtube/info (miễn phí)`	`GET /resolve?handle=... (miễn phí)`	Của chúng tôi phân giải handle/URL thành ID kênh; để lấy metadata cấp video, gọi /transcript và đọc các trường trong phản hồi.
`GET /youtube/search (1 tín dụng)`	`GET /search?q=... (1 tín dụng/trang)`	Cùng ý tưởng - tìm kiếm phân trang, một tín dụng mỗi trang được lấy.
`GET /youtube/channel/resolve (miễn phí)`	`GET /resolve?handle=... (miễn phí)`	Tương đương trực tiếp.
`GET /youtube/channel/videos (1/trang)`	`GET /channel/videos?channel=... (1 tín dụng/trang)`	Cùng mô hình phân trang - trả lại token continuation từ phản hồi.
`GET /youtube/channel/search (1 tín dụng)`	`GET /channel/search?channel=...&q=... (1 tín dụng/trang)`	Tương đương trực tiếp.
`GET /youtube/channel/playlists, /channel/posts`	`(không có tương đương)`	Hiện chưa cung cấp - xem phần chênh lệch bên dưới.

Những gì không tương ứng 1:1

Không có dấu thời gian theo đoạn trong phản hồi API. format=json + include_timestamp=true của TranscriptAPI trả về các đoạn kèm start/duration; API công khai của chúng tôi chỉ trả về chuỗi chép lời đã làm phẳng. (Dấu thời gian cấp đoạn tồn tại trong cơ sở dữ liệu của chúng tôi và cung cấp cho chế độ xem chép lời có thể nhấp trên chính trang web - chỉ là chưa có trong phản hồi API công khai.)
language ở đây là một mã duy nhất, không phải danh sách ưu tiên. TranscriptAPI thử danh sách phân tách bằng dấu phẩy như de,en,asr từ trái sang phải; của chúng tôi nhận một mã với giá trị mặc định. Nếu bạn dựa vào chuỗi dự phòng, hãy tự thử lại với giá trị khác.
Không có endpoint danh sách phát kênh hay bài đăng kênh. /channel/playlists và /channel/posts của TranscriptAPI hiện chưa có tương đương ở đây.

Nếu văn bản chép lời thuần, metadata, tìm kiếm, và dữ liệu kênh đáp ứng trường hợp sử dụng của bạn, đây gần như là thay thế trực tiếp - đăng ký để nhận 100 tín dụng miễn phí (không cần thẻ) và xem danh sách giá và endpoint đầy đủ, hoặc xem tài liệu API để có tham chiếu tham số đầy đủ.

Câu hỏi thường gặp về di chuyển

Q01

Tôi có cần thay đổi header xác thực không?

Không - cả hai API đều dùng Authorization: Bearer KHÓA_CỦA_BẠN. API của chúng tôi cũng chấp nhận x-api-key như một lựa chọn thay thế.

Q02

URL và ID video hiện có của tôi có còn hoạt động không?

Có - cả hai API đều chấp nhận URL YouTube đầy đủ, URL rút gọn youtu.be, hoặc ID video 11 ký tự ở cùng vị trí tham số (video_url ở đó, v ở đây).

Q03

Điều gì xảy ra nếu tôi gửi danh sách ngôn ngữ phân tách bằng dấu phẩy như định dạng của TranscriptAPI?

Tham số language của chúng tôi mong đợi một mã duy nhất, không phải danh sách. Giá trị phân tách bằng dấu phẩy có thể sẽ không khớp - hãy yêu cầu một ngôn ngữ mỗi lần gọi, và thử lại với giá trị khác nếu cần chuỗi dự phòng.

Q04

Tôi có thể lấy dấu thời gian cấp đoạn từ API của bạn không?

Hiện tại không thể từ phản hồi API REST công khai - nó trả về văn bản chép lời đã làm phẳng. Nếu việc di chuyển của bạn phụ thuộc vào điều đó, hãy chờ đến khi tính năng này được cung cấp, hoặc dùng chế độ xem chép lời của chính trang web, vốn đã hỗ trợ điều đó.

Q05

Dùng thử có miễn phí không?

100 tín dụng miễn phí khi đăng ký, không cần thẻ - đủ để thử nghiệm các endpoint chép lời, tìm kiếm, và kênh trước khi quyết định chọn gói.

Liên quan