블로그로 돌아가기연동

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

빠른 답변

TranscriptAPI.com의 video_url, format, include_timestamp는 저희의 v, language 파라미터에 대응합니다 - 다만 저희 공개 API는 그들의 format=json 옵션처럼 세그먼트 단위 타임스탬프를 제공하지 않습니다. 일반 텍스트 자막과 메타데이터만 필요하다면 거의 그대로 대체할 수 있습니다. API 응답 자체에서 세그먼트 단위 타임스탬프에 의존한다면 전환하기 전에 차이점 섹션을 읽어보세요.
01

파라미터 매핑

두 API 모두 베어러 토큰으로 인증하며 전체 URL, 짧은 URL, 또는 순수 동영상 ID를 받습니다. TranscriptAPI의 나머지 자막 파라미터가 저희와 어떻게 대응하는지:

TranscriptAPI.comGetYouTubeTranscript참고
Authorization: Bearer KEYAuthorization: Bearer KEYx-api-key도 대체 헤더로 받습니다.
video_urlv (또는 url, videoId)동일한 형식 지원: 전체 URL, 짧은 URL, 또는 11자 ID.
languagelanguage저희는 우선순위 목록이 아니라 기본값이 있는 단일 코드를 받습니다 - 호출당 언어 하나를 요청하세요.
format=json|text(없음 - 항상 일반 텍스트)저희 응답은 항상 transcript 필드에 평탄화된 문자열을 반환하며, 이는 그들의 format=text와 동일합니다.
include_timestamp(제공되지 않음)세그먼트별 start/duration 타임스탬프는 현재 공개 응답에 없습니다 - 아래 차이점 참고.
send_metadata=true(항상 포함됨)title, author_name, author_url, thumbnail_url은 항상 응답에 포함되어 별도 플래그가 필요 없습니다.
02

이전 / 이후

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

같은 동영상, 양쪽 다 1 크레딧. 저희 쪽은 메타데이터가 기본으로 반환되므로 send_metadata 플래그를 기억할 필요가 없습니다.

03

다른 엔드포인트

TranscriptAPI.comGetYouTubeTranscript참고
GET /youtube/info (무료)GET /resolve?handle=... (무료)저희는 핸들/URL을 채널 ID로 변환합니다. 동영상 수준 메타데이터는 /transcript를 호출해 응답 필드를 읽으세요.
GET /youtube/search (1 크레딧)GET /search?q=... (1 크레딧/페이지)동일한 개념 - 페이지네이션 검색, 가져온 페이지당 1 크레딧.
GET /youtube/channel/resolve (무료)GET /resolve?handle=... (무료)직접 대응.
GET /youtube/channel/videos (1/페이지)GET /channel/videos?channel=... (1 크레딧/페이지)동일한 페이지네이션 모델 - 응답의 continuation 토큰을 그대로 돌려주세요.
GET /youtube/channel/search (1 크레딧)GET /channel/search?channel=...&q=... (1 크레딧/페이지)직접 대응.
GET /youtube/channel/playlists, /channel/posts(대응 없음)현재 제공하지 않습니다 - 아래 차이점 참고.

1:1로 대응하지 않는 부분

  • API 응답에 세그먼트별 타임스탬프가 없습니다. TranscriptAPI의 format=json + include_timestamp=true는 start/duration이 있는 세그먼트를 반환하지만, 저희 공개 API는 평탄화된 자막 문자열만 반환합니다 (세그먼트별 타임스탬프는 저희 데이터베이스에 존재하며 웹사이트 자체의 클릭 가능한 자막 뷰를 구동하지만, 아직 공개 API 응답에는 없습니다).
  • 여기서 language는 우선순위 목록이 아니라 단일 코드입니다. TranscriptAPI는 de,en,asr 같은 쉼표로 구분된 목록을 왼쪽부터 시도하지만, 저희는 기본값이 있는 코드 하나를 받습니다. 폴백 체인에 의존했다면 다른 값으로 직접 재시도하세요.
  • 채널 재생목록이나 채널 게시물 엔드포인트가 없습니다. TranscriptAPI의 /channel/playlists와 /channel/posts는 현재 여기에 대응하는 것이 없습니다.

일반 자막 텍스트, 메타데이터, 검색, 채널 데이터가 사용 사례를 충족한다면 거의 그대로 대체할 수 있습니다 - 100 무료 크레딧(카드 불필요)으로 가입하고 전체 요금 및 엔드포인트 목록을 확인하거나, 전체 파라미터 참조는 API 문서를 확인하세요.

마이그레이션 FAQ

Q01

인증 헤더를 바꿔야 하나요?

아니요 - 두 API 모두 Authorization: Bearer YOUR_KEY를 사용합니다. 저희는 x-api-key도 대안으로 받습니다.

Q02

기존 동영상 URL과 ID가 계속 작동하나요?

네 - 두 API 모두 같은 파라미터 위치(그쪽은 video_url, 저희는 v)에서 전체 YouTube URL, 짧은 youtu.be URL, 또는 11자 동영상 ID를 받습니다.

Q03

TranscriptAPI 형식처럼 쉼표로 구분된 언어 목록을 보내면 어떻게 되나요?

저희 language 파라미터는 목록이 아니라 단일 코드를 기대합니다. 쉼표로 구분된 값은 아마 일치하지 않을 것입니다 - 호출당 언어 하나를 요청하고, 폴백 체인이 필요하면 다른 값으로 재시도하세요.

Q04

귀사의 API에서 세그먼트별 타임스탬프를 받을 수 있나요?

현재 공개 REST API 응답에서는 불가능합니다 - 평탄화된 자막 텍스트를 반환합니다. 마이그레이션이 이에 의존한다면 제공될 때까지 기다리거나, 이를 지원하는 웹사이트 자체 자막 뷰를 사용하세요.

Q05

무료로 사용해볼 수 있나요?

가입 시 100 무료 크레딧, 카드 불필요 - 플랜을 정하기 전에 자막, 검색, 채널 엔드포인트를 테스트하기에 충분합니다.

관련 콘텐츠