How to Get YouTube Transcripts in Python

youtube-transcript-apiはYouTube自身の字幕データを直接取得する、よくメンテナンスされたPythonパッケージです - APIキーもYouTube Data APIのクォータも不要です。

pip install youtube-transcript-api

動画IDで文字起こしを取得:

from youtube_transcript_api import YouTubeTranscriptApi

api = YouTubeTranscriptApi()
transcript = api.fetch("dQw4w9WgXcQ", languages=["en"])

for snippet in transcript:
    print(snippet.text, snippet.start, snippet.duration)

ノートPC上では問題なく動きます。クラウドサーバーにデプロイすると、実際によく知られた失敗にぶつかることがあります - IPブロック、PoTokenRequired、そして見た目通りとは限らない「文字起こし無効」エラーです。正確な原因と対処法は完全な診断チェックリストをご覧ください。

ダッシュボードから無料キーを取得 - 100無料クレジット、カード不要。

pip install requests

プロキシプールもIPブロック対応のメンテナンスも不要 - 単なるHTTPリクエストです:

import requests

response = requests.get(
    "https://getyoutubetranscript.com/api/v1/transcript",
    params={"v": "dQw4w9WgXcQ"},
    headers={"Authorization": "Bearer sk_live_..."},
)
result = response.json()

print(result["data"]["transcript"])
print(result["data"]["word_count"])

失敗したリクエストはライブラリ固有の例外を投げる代わりにエラーオブジェクトを返すので、すべてのエンドポイントで同じエラーハンドリングが使えます。

{ "success": false, "code": "...", "message": "..." }

動画IDのリストをループする方法は同じです - プランの分あたりリクエスト数の上限にだけ注意してください。バックオフとリトライのロジックはレート制限ガイドを参照してください。