YouTube BulkPublish

YouTube API

自分のコードからYouTubeの公開、予約、管理ができます。1つのREST APIと1つのキーで、YouTubeと接続済みのほかのネットワークをまとめて扱えるので、連携の実装は一度で済みます。

YouTube APIでできること

以下はすべて公開されているAPIの機能で、YouTubeで今すぐ使えます。

機能	エンドポイント
投稿の作成、予約、更新、公開	`POST /api/posts`
画像と動画のアップロード	`POST /api/media`
キューの次の空き枠を探す	`GET /api/posts/queue-slot`
繰り返しスケジュールの作成	`POST /api/schedules`
RSSフィードの新着を公開	`POST /api/rss-feeds`
チャンネルのYouTubeプレイリストを取得	`GET /api/channels/{id}/options`
最初のコメントを自動で投稿	`platformSpecific._firstComment`
投稿ごとの指標を取得	`GET /api/posts/{id}/metrics`
公開済み投稿のコメントを読んで返信	`GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply`
接続が正常か確認	`GET /api/channels/{id}/health`
プランの使用状況を確認	`GET /api/quotas/usage`

YouTubeに公開できる投稿タイプ

タイプはpostTypeOverridesで指定します。YouTubeが対応していないタイプは、キューに入る前に拒否されます。

投稿の種類	メディア
`video` Video	必須：1本の動画
`short` Short	必須：1本の動画

curlでYouTubeの投稿を予約する

3つのリクエストで行います。チャンネルを探し、投稿にファイルがあればアップロードし、投稿を作成します。キーは「設定」の「APIキー」で取得したものに、12は自分のチャンネルIDに置き換えてください。

1. チャンネルの一覧を取得し、YouTubeアカウントのIDを控えます。

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

2. ファイルをアップロードします。レスポンスのメディアIDを、下のmediaFilesに使います。

curl -X POST https://app.bulkpublish.com/api/media \
  -H "Authorization: Bearer bp_your_key_here" \
  -F "file=@clip.mp4"

3. 投稿を作成します。

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Everything we shipped this week",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "mediaFiles": [101],
  "platformSpecific": {
    "youtube": {
      "title": "Launch day recap",
      "privacyStatus": "public"
    }
  }
}'

レスポンスは作成された投稿で、IDとステータスが含まれます。あとからGET /api/posts/{id}で取得すると、結果を確認できます。

YouTubeのオプション

platformSpecificの中の、YouTube用のキーの下に指定します。

オプション	内容	指定できる値
`title`	タイトル	テキスト
`privacyStatus`	公開、限定公開、非公開	`publicunlistedprivate`
`categoryId`	カテゴリ	テキスト
`madeForKids`	子ども向けの設定	true または false
`playlistId`	プレイリストに追加	テキスト
`thumbnailUrl`	カバー画像（公開URL）	テキスト