Yoinku
← ガイド一覧へ戻る

YouTube文字起こしAPI:GETリクエスト1本で動画の字幕・トランスクリプトを取得する

アプリやデータパイプライン、AIエージェントからYouTubeの文字起こしを取得したい——実はこれ、意外と選択肢が限られています。

  • YouTube公式のData APIでは、字幕トラックをダウンロードできるのは自分がオーナーの動画だけ(チャンネル所有者としてのOAuth認証が必要)。任意の動画には使えません。
  • スクレイピング系ライブラリ(Pythonの youtube-transcript-api など)はYouTubeの内部エンドポイントを直接叩くため、仕様変更のたびに壊れ、クラウドのIPから某かの量を取得するとすぐブロックされます。

Yoinku API は第三の選択肢です。YouTube側の処理(プロキシや形式のパース含む)をホスト側で引き受け、クリーンなJSONを返します。

クイックスタート

アカウントページで無料アカウントを作成し、APIキーを発行してください。あとはこれだけ:

curl -H "x-api-key: YOUR_API_KEY" \
  "https://yoinku.com/api/v1/transcript?url=https://www.youtube.com/watch?v=VIDEO_ID"

レスポンスには、プレーンテキストとタイムスタンプ付きチャンクの両方が含まれます:

{
  "ok": true,
  "data": {
    "id": "VIDEO_ID",
    "platform": "youtube",
    "lang": "ja",
    "source": "manual",
    "text": "文字起こし全文がひとつのテキストとして...",
    "chunks": [
      { "startSeconds": 0, "durationSeconds": 4.2, "text": "文字起こし全文が" },
      { "startSeconds": 4.2, "durationSeconds": 3.8, "text": "ひとつのテキストとして" }
    ],
    "availableLanguages": { "manual": ["ja"], "auto": ["ja", "en", "es"] }
  }
}

ポイント:

  • 投稿者字幕を自動字幕より優先:クリエイターが字幕を用意していればそれを、なければ自動生成字幕を返します。
  • lang パラメータ:&lang=en のように言語を指定できます。availableLanguages で存在する言語を確認できます。
  • chunks はRAG向け設計:各キューに startSeconds / durationSeconds が付くので、時間窓でチャンク分割してタイムスタンプ付きで引用できます。
  • 失敗したリクエストは自動返金され、利用枠を消費しません。

Pythonの例

import requests

resp = requests.get(
    "https://yoinku.com/api/v1/transcript",
    params={"url": "https://www.youtube.com/watch?v=VIDEO_ID", "lang": "ja"},
    headers={"x-api-key": "YOUR_API_KEY"},
)
data = resp.json()["data"]
print(data["text"][:500])
for chunk in data["chunks"][:5]:
    print(f'{chunk["startSeconds"]:>8.1f}s  {chunk["text"]}')

JavaScriptの例

const res = await fetch(
  "https://yoinku.com/api/v1/transcript?url=" +
    encodeURIComponent("https://www.youtube.com/watch?v=VIDEO_ID"),
  { headers: { "x-api-key": process.env.YOINKU_API_KEY } },
);
const { data } = await res.json();
console.log(data.text);

メタデータも取得できる

兄弟エンドポイントの GET /api/v1/meta?url=... は、同じ動画の構造化メタデータ(タイトル・概要欄・チャンネル・再生時間・再生回数・タグ・チャプター・字幕言語一覧)を返します。認証も利用枠も共通です。詳細はAPIリファレンスへ。

AIエージェントから使う(MCP)

利用者がコードではなくAIエージェントなら、リモートMCPサーバー https://yoinku.com/mcp が使えます。ツールは get_video_transcript・get_video_metadata・get_video_download_url の3つで、APIキーも利用枠もREST APIと共通。Claude Codeなら1行で追加できます:

claude mcp add --transport http yoinku https://yoinku.com/mcp --header "x-api-key: YOUR_API_KEY"

セットアップの詳細はMCPページへ。

料金

  • Free:データリクエスト(文字起こし・メタデータ)1日10回 — 開発・検証には十分
  • Hobby($9/月):1日100回
  • Pro($29/月):1日1,000回

利用枠はUTC日ごとで、RESTとMCPで共有されます。超過時はHTTP 429と upgradeUrl が返ります。詳細は料金ページへ。

まとめ

GETリクエスト1本とAPIキー1つで、YouTubeの文字起こしをプレーンテキストとタイムスタンプ付きチャンクの両形式で取得できます。スクレイパーのメンテナンスもプロキシ管理も不要です。無料でAPIキーを発行する →