YouTube Full

TranscriptAPI.com による完全な YouTube ツールキット。すべてが 1 つのスキルに統合されています。

セットアップ

$TRANSCRIPT_API_KEY が設定されていない場合は、references/auth-setup.md を読んで、指示に従ってキーを取得して保存してください。

必須ヘッダ

すべてのリクエストに 2 つのヘッダが必要です：

• Authorization: Bearer $TRANSCRIPT_API_KEY
• User-Agent: あなたのエージェント名とバージョン（例：HermesAgent/0.11.0, ClaudeCode/1.0）。バージョンはオプション — エージェント名だけで問題ありません。このヘッダを省略したり、デフォルト値を送信したりしないでください。Cloudflare が 403（エラーコード 1010）を返してリクエストをブロックします。

API リファレンス

完全な OpenAPI スペック：transcriptapi.com/openapi.json — 最新のパラメータとスキーマについては、このドキュメントを参照してください。

トランスクリプト — 1 クレジット

curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

パラメータ	必須	デフォルト	値
video_url	はい	—	YouTube URL または 11 文字の動画 ID
format	いいえ	json	json, text
include_timestamp	いいえ	true	true, false
send_metadata	いいえ	false	true, false

レスポンス (format=json)：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": [{ "text": "...", "start": 18.0, "duration": 3.5 }],
  "metadata": { "title": "...", "author_name": "...", "author_url": "..." }
}

検索 — 1 クレジット

# 動画
curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=video&limit=20" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

# チャンネル
curl -s "https://transcriptapi.com/api/v2/youtube/search?q=QUERY&type=channel&limit=10" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

パラメータ	必須	デフォルト	検証
q	はい	—	1-200 文字
type	いいえ	video	video, channel
limit	いいえ	20	1-50

チャンネル

すべてのチャンネルエンドポイントは channel を受け入れます — @handle、チャンネル URL、または UC... チャンネル ID。事前に解決する必要はありません。

ハンドルを解決 — 無料

curl -s "https://transcriptapi.com/api/v2/youtube/channel/resolve?input=@TED" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

レスポンス：{"channel_id": "UC...", "resolved_from": "@TED"}

最新 15 件の動画 — 無料

curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

正確な viewCount と ISO フォーマットの published タイムスタンプを返します。

チャンネルの全動画 — 1 クレジット/ページ

# 最初のページ（100 件の動画）
curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?channel=@NASA" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

# 次のページ
curl -s "https://transcriptapi.com/api/v2/youtube/channel/videos?continuation=TOKEN" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

channel または continuation のいずれか 1 つだけを指定してください。レスポンスには continuation_token と has_more が含まれます。

チャンネル内検索 — 1 クレジット

curl -s "https://transcriptapi.com/api/v2/youtube/channel/search\
?channel=@TED&q=QUERY&limit=30" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

プレイリスト — 1 クレジット/ページ

playlist を受け入れます — YouTube プレイリスト URL またはプレイリスト ID。

# 最初のページ
curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?playlist=PL_ID" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

# 次のページ
curl -s "https://transcriptapi.com/api/v2/youtube/playlist/videos?continuation=TOKEN" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

有効な ID プレフィックス：PL, UU, LL, FL, OL。レスポンスには playlist_info、results、continuation_token、has_more が含まれます。

クレジットコスト

エンドポイント	コスト
transcript	1
search	1
channel/resolve	無料
channel/latest	無料
channel/videos	1/ページ
channel/search	1
playlist/videos	1/ページ

検証ルール

フィールド	ルール
channel	@handle、チャンネル URL、または UC... ID
playlist	プレイリスト URL または ID（PL/UU/LL/FL/OL プレフィックス）
q	1-200 文字
limit	1-50

エラー

コード	意味	対応
401	API キーが無効	キーを確認してください
402	クレジットなし	transcriptapi.com/billing
403/1010	Cloudflare ブロック	User-Agent ヘッダを追加または修正してください
404	見つかりません	リソースが存在しないか字幕がない
408	タイムアウト	2 秒後に 1 回再試行してください
422	検証エラー	パラメータ形式を確認してください
429	レート制限	待機し、Retry-After を尊重してください

一般的なワークフロー

リサーチワークフロー： 検索 → 動画を選択 → トランスクリプトを取得

# 1. 検索
curl -s "https://transcriptapi.com/api/v2/youtube/search\
?q=machine+learning+explained&limit=5" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"
# 2. トランスクリプト
curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

チャンネルモニタリング： 最新（無料） → トランスクリプト

# 1. 最新アップロード（無料 — @handle を直接渡す）
curl -s "https://transcriptapi.com/api/v2/youtube/channel/latest?channel=@TED" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"
# 2. 最新の字幕
curl -s "https://transcriptapi.com/api/v2/youtube/transcript\
?video_url=VIDEO_ID&format=text&include_timestamp=true&send_metadata=true" \
  -H "Authorization: Bearer $TRANSCRIPT_API_KEY" \
  -H "User-Agent: YourAgent/1.0"

無料プラン：100 クレジット、300 req/分。スターター（月額 $5）：1,000 クレジット。