YouTube 자막 API

영상 한 편 이상을 위해 만들어짐

대부분의 무료 YouTube 자막 도구는 영상 한 편에서 끝납니다. 이 API는 YouTube 검색, 채널 핸들 확인, 채널 또는 재생목록의 영상 목록 조회까지 - 모두 하나의 키로 가능합니다.

• 언어 선택이 가능한, 공개된 모든 영상의 자막 추출
• 페이지네이션이 가능한 YouTube 전문 검색
• 채널 핸들 확인 및 채널 영상 목록 조회
• 재생목록 영상 목록 조회
• 같은 계정으로 영상에 질문만 하고 싶은 사람들을 위한 Chrome 확장 프로그램

OAuth 화면도, Google Cloud 프로젝트도, 소진될 수 있는 프로젝트별 할당량도 없습니다 - 공식 API에서 이것이 얼마나 큰 비용인지 YouTube API 할당량 가이드에서 확인하세요.

요청 한 번, JSON 응답

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

# => { "success": true, "data": { "transcript": "...", "word_count": 1847 } }

채널 전체를 한 번의 작업으로 백업

채널의 동영상 목록을 가져와 최대 100개를 한 번의 배치 요청으로 보내면, 완료 시 서명된 웹훅을 받습니다. 폴링 루프도, 신경 써야 할 프록시도 없습니다.

• 스크립트를 반환한 동영상에만 1크레딧이 차감됩니다. 자막이 없는 동영상, 비공개 또는 삭제된 동영상, 가져오기에 실패한 경우는 무료입니다.
• 각 동영상은 실패로 처리하기 전에 다시 시도하므로, YouTube의 일시적인 문제로 크레딧을 잃거나 다시 실행할 필요가 없습니다.
• 실제 요청 5,412건 기준 측정(2026년 10월 2일~8일): 자막이 있는 동영상의 96.8%가 스크립트를 반환했고, 전체 요청의 98%가 확정적인 결과(스크립트 또는 '자막 없음'·'이용 불가'라는 명확한 결과)를 받았습니다.

# 1. List the channel's uploads (1 credit per page of results)
curl "https://getyoutubetranscript.com/api/v1/channel/videos?channel=@3blue1brown" \
  -H "Authorization: Bearer sk_live_..."

# 2. Queue up to 100 of them in one batch
curl -X POST "https://getyoutubetranscript.com/api/v1/batch" \
  -H "Authorization: Bearer sk_live_..." -H "Content-Type: application/json" \
  -d '{"videos": ["aircAruvnKk", "IHZwWFHWa-w", "..."], "webhook_url": "https://you.example/hook"}'

# 3. Get a signed webhook when it's done, or poll GET /api/v1/batch?id=...

간단한 크레딧 기반 요금제

1 크레딧 = 아래 엔드포인트 중 하나에 대한 성공적인 요청 1회. 실패한 요청은 과금되지 않습니다.

엔드포인트

전체 파라미터 참조, 응답 형식, 에러 코드는 API 문서에 있습니다.