youtube-api

YouTube API

必要なときに利用できるYouTubeデータ：実際のフィルターを使った動画／チャンネル／プレイリスト検索（ アップロード日、長さ、並べ替え順）、チャンネルと動画の詳細取得、動画、 ショート、ライブ配信、プレイリストの動画一覧、コメント、ハッシュタグフィード、急上昇動画 — 呼び出しごとにシンプルなHTTP GETを1回行い、使った分だけ支払います。デベロッパーコンソールのプロジェクト、 OAuth同意画面、1日のクォータは不要です。

ベースURL：https://youtube.fetcher.sh

認証

支払い方法は2種類、データは同じです — 詳細な仕組みについては fetcher スキルをご覧ください。

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/search/video?query=hello"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

すべてのレスポンスは { "status": number, "message": string, "data": ... } です。HTTPステータスは status と一致します。

エンドポイント（15 — すべてGET、1回あたり$0.005）

エンドポイント	返される内容
/api/search/video	クエリに一致する動画。アップロード日、長さ、並べ替えのフィルター
/api/search/channel	クエリに一致するチャンネル
/api/search/playlist	クエリに一致するプレイリスト
/api/channel/{id}	IDによるチャンネルの詳細
/api/channel/handle/{handle}	@handleによるチャンネルの詳細
/api/channel/path	カスタムURLパスによるチャンネルの詳細
/api/channel/{id}/videos	チャンネルの動画
/api/channel/{id}/shorts	チャンネルのショート
/api/channel/{id}/live-streams	チャンネルのライブ配信
/api/video/{id}	動画（またはショート）の詳細
/api/video/{id}/comments	動画のコメント
/api/shorts/{id}	ショートの詳細
/api/playlist/{id}/videos	プレイリストの動画
/api/hashtag/{tag}	ハッシュタグが付いた動画
/api/trending	急上昇動画。地域を指定可能

{id} / {handle} / {tag} はパスパラメーターです。任意の cursor / lang / geo で結果を絞り込めます。query（検索）と channelPath（パス による検索）は、指定する場合に必須です。

シナリオ

今週アップロードされた動画：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=ai agents" -G \
  --data-urlencode "uploadDate=week" \
  "https://youtube.fetcher.sh/api/search/video"

再生回数の多い順、長尺動画のみ：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=x402 protocol" -G \
  --data-urlencode "sortBy=view_count" \
  --data-urlencode "duration=long" \
  "https://youtube.fetcher.sh/api/search/video"

新しい順：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=stablecoin payments" -G \
  --data-urlencode "sortBy=upload_date" \
  "https://youtube.fetcher.sh/api/search/video"

その他の uploadDate の値：hour、today、month、year。その他の duration の値：short、medium。その他の sortBy の値：relevance、rating。

チャンネルまたはプレイリストを検索：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=lofi hip hop" -G \
  "https://youtube.fetcher.sh/api/search/channel"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=lofi hip hop" -G \
  "https://youtube.fetcher.sh/api/search/playlist"

ID、ハンドル、またはカスタムパスでチャンネルを取得 — その後、動画、ショート、ライブ配信を取得：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/channel/handle/mkbhd"

curl -H "Authorization: Bearer $FETCHER_API_KEY" -G \
  --data-urlencode "channelPath=@mkbhd" \
  "https://youtube.fetcher.sh/api/channel/path"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/channel/UCBJycsmduvYEL83R_U4JriQ/videos"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/channel/UCBJycsmduvYEL83R_U4JriQ/shorts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/channel/UCBJycsmduvYEL83R_U4JriQ/live-streams"

動画の詳細とコメント、またはショートの詳細を取得：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/video/dQw4w9WgXcQ"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "sort=top" -G \
  "https://youtube.fetcher.sh/api/video/dQw4w9WgXcQ/comments"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/shorts/abc123XYZ90"

プレイリストの動画、ハッシュタグが付いた動画、地域別の急上昇動画を取得：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/playlist/PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI/videos"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://youtube.fetcher.sh/api/hashtag/shorts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "geo=US" -G \
  "https://youtube.fetcher.sh/api/trending"

MCP

{
  "mcpServers": {
    "youtube": {
      "url": "https://youtube.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

無料：search_endpoints、describe_endpoint、check_balance。有料： fetch_data（上記の任意のエンドポイント）、topup_credits、および名前付きショートカットの youtube_search_video。代わりにx402で呼び出しごとに支払うには、headers ブロックを削除してください — 詳細な手順については fetcher スキルをご覧ください。

エラー

• 400 — パラメーターがない、または無効（メッセージに該当項目が示されます）
• 401 — キーが不明、またはローテーション済み
• 402 — 支払いが必要（x402チャレンジ）、または topup_required（クレジットを使い切っています）
• 404 — 料金設定のないパス
• レート制限なし。上流での失敗に対する返金はありません（提供より先に決済されます）

リファレンス

• エージェントのセットアップ全般：https://youtube.fetcher.sh/skill.md
• OpenAPI 3.1仕様：https://youtube.fetcher.sh/openapi.json
• 簡易カタログ：https://youtube.fetcher.sh/llms.txt
• 支払い、クレジット、MCPの詳細：fetcher スキル
• サイト：https://youtube.fetcher.sh