APIドキュメント

YouTubeの文字起こし、検索、メタデータを取得するREST APIです。ダッシュボードからAPIキーを取得してください — 100無料クレジット、カード登録不要。

認証

APIキーはベアラートークンとして、またはx-api-keyヘッダーで渡してください:

Authorization: Bearer sk_live_...
# or
x-api-key: sk_live_...

ベースURL

https://getyoutubetranscript.com/api/v1

クレジットとプラン

プラン価格クレジット/月追加購入価格レート制限
無料$0100(一回限り)60リクエスト/分
月額$5.00/月1,000$2.50 / 1,000200リクエスト/分
年額$4.50/月(年額$54)1,000$1.50 / 1,000300リクエスト/分

1クレジット = 1回の成功したリクエスト。失敗したリクエストに課金されることはありません。追加購入したクレジットは、購入から30日後または現在の請求期間終了時のいずれか遅い方で失効し、使用にはアクティブなサブスクリプションが必要です。

エンドポイント

GET/transcript1クレジット

動画のタイトル、チャンネル名、サムネイルなどのメタデータとともに、YouTube動画の文字起こしを取得します。

パラメータ必須説明
vはい動画IDまたは完全なYouTube URL
languageいいえ言語コード(デフォルト: en)

リクエスト

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

レスポンス

{
  "success": true,
  "data": {
    "video_id": "jNQXAC9IVRw",
    "language_code": "en",
    "title": "Me at the zoo",
    "author_name": "jawed",
    "author_url": "https://www.youtube.com/channel/UC4Qob...",
    "thumbnail_url": "https://...",
    "transcript": "All right, so here we are...",
    "word_count": 39
  }
}
GET/search1クレジット / ページ

フィルターとページネーションを使ってYouTube動画を検索します。

パラメータ必須説明
qはい検索クエリ(2文字以上)
countryいいえ2文字の国コード(デフォルト: us)
languageいいえ言語コード(デフォルト: en)
page_tokenいいえ次のページを取得するための、前回レスポンスのpagination.next_page_token
limitいいえ最大結果数(デフォルト20、最大50)

リクエスト

curl "https://getyoutubetranscript.com/api/v1/search?q=lofi+beats" \
  -H "Authorization: Bearer sk_live_..."

レスポンス

{
  "success": true,
  "data": {
    "query": "lofi beats",
    "video_results": [ { "title": "...", "videoId": "...", "channel": { "name": "..." } } ],
    "pagination": { "next_page_token": "..." }
  }
}
GET/resolve無料

チャンネルのハンドル、URL、またはユーザー名を実際のチャンネルIDに解決します。構文的な入力(すでにチャンネルIDまたはIDを含むURL)は通信なしで即座に解決されますが、単なるハンドルの場合は1回の実際のルックアップが発生します。

パラメータ必須説明
handleはいチャンネルID、URL、または@ハンドル

リクエスト

curl "https://getyoutubetranscript.com/api/v1/resolve?handle=@mkbhd" \
  -H "Authorization: Bearer sk_live_..."

レスポンス

{
  "success": true,
  "data": {
    "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
    "title": "Marques Brownlee",
    "handle": "http://www.youtube.com/@mkbhd",
    "resolved_via": "scrape"
  }
}
GET/playlist1クレジット / ページ

プレイリスト内の動画を取得します。現在は最初のページのみを返します - has_moreでさらに動画があるかどうかがわかりますが、追加ページの取得にはまだ対応していません。

パラメータ必須説明
listはいプレイリストIDまたはURL

リクエスト

curl "https://getyoutubetranscript.com/api/v1/playlist?list=PLxxx" \
  -H "Authorization: Bearer sk_live_..."

レスポンス

{
  "success": true,
  "data": {
    "playlist_id": "PLxxx",
    "title": "...",
    "videos": [ { "position": 1, "id": "...", "title": "...", "channel": { "name": "..." } } ],
    "has_more": true
  }
}

エラー

エラーはHTTPステータスに加え、条件分岐に使える安定したcodeフィールドを含むJSONボディを返します:

ステータスコード意味
400BAD_REQUESTパラメータが不足しているか無効です
401MISSING_API_KEY / INVALID_API_KEYキーが指定されていないか、無効/失効しています
402PAYMENT_REQUIREDクレジット不足 - 追加購入するかアップグレードしてください
404VIDEO_UNAVAILABLE / TRANSCRIPT_NOT_FOUND動画またはリソースが見つかりません
429RATE_LIMITEDプランのレート制限を超えるリクエストです
503UPSTREAM_UNAVAILABLE一時的な上流の問題です - 再試行しても問題ありません

近日公開

チャンネル内検索、チャンネル内の全動画一覧、完全なプレイリストのページネーションは開発中です。RSS経由の新規アップロード追跡は、YouTube側の無関係な問題により一時的に利用できません。

このAPIをAIツールと組み合わせて使う

リクエストを自分で書く代わりに、Claude(または他のAIコーディングツール)にこのAPIを呼び出させたいですか?YouTube Transcriptスキルをダウンロードしてください - 文字起こしの取得、検索などの方法をAIに教える、すぐに使えるClaude Skillです。