YouTube Search

TranscriptAPI.com 経由で YouTube を検索し、文字起こしを取得します。

セットアップ

$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 — 最新のパラメータとスキーマについてはこちらを参照してください。

GET /api/v2/youtube/search — 1 クレジット

YouTube 全体から動画またはチャンネルを検索します。

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"

パラメータ	必須	デフォルト	検証
q	はい	—	1-200 文字 (トリム済み)
type	いいえ	video	video または channel
limit	いいえ	20	1-50

動画検索レスポンス:

{
  "results": [
    {
      "type": "video",
      "videoId": "dQw4w9WgXcQ",
      "title": "Rick Astley - Never Gonna Give You Up",
      "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "channelTitle": "Rick Astley",
      "channelHandle": "@RickAstley",
      "channelVerified": true,
      "lengthText": "3:33",
      "viewCountText": "1.5B views",
      "publishedTimeText": "14 years ago",
      "hasCaptions": true,
      "thumbnails": [{ "url": "...", "width": 120, "height": 90 }]
    }
  ],
  "result_count": 20
}

チャンネル検索レスポンス (type=channel):

{
  "results": [{
    "type": "channel",
    "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "title": "Rick Astley",
    "handle": "@RickAstley",
    "url": "https://www.youtube.com/@RickAstley",
    "description": "Official channel...",
    "subscriberCount": "4.2M subscribers",
    "verified": true,
    "rssUrl": "https://www.youtube.com/feeds/videos.xml?channel_id=UC...",
    "thumbnails": [...]
  }],
  "result_count": 5
}

GET /api/v2/youtube/channel/search — 1 クレジット

特定のチャンネル内から動画を検索します。channel は @handle、チャンネル URL、または UC... ID を受け付けます。

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

パラメータ	必須	検証
channel	はい	@handle、チャンネル URL、または UC... ID
q	はい	1-200 文字
limit	いいえ	1-50 (デフォルト 30)

最大 ~30 件の結果を返します (YouTube の制限)。グローバル検索と同じ動画レスポンス形式です。

GET /api/v2/youtube/channel/resolve — 無料

@handle をチャンネル 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"

ワークフロー: 検索 → 文字起こし

# 1. 動画を検索
curl -s "https://transcriptapi.com/api/v2/youtube/search\
?q=python+web+scraping&type=video&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"

エラー

コード	意味	アクション
401	API キーが無効	キーを確認してください
402	クレジット不足	transcriptapi.com/billing
403/1010	Cloudflare ブロック	User-Agent ヘッダーを追加または修正してください
404	見つかりません	リソースが存在しません
408	タイムアウト	1 回再試行してください
422	無効なパラメータ	パラメータ形式を確認してください

無料ティア: 100 クレジット、300 req/min。