YouTube Community Post
コミュニティ投稿は、クリエイターがチャンネルの投稿タブに公開するお知らせ、質問、画像セット、リンクなどの更新で、それぞれに本文、添付画像、高評価数があります。投稿全体を取得すれば、クリエイターの発言を記録に残し、個々の投稿にファンがどう反応したかを測り、寄せられたコメントの背景も把握できます。
YouTube Community Post API の主な機能
- 2種類の投稿リンクに対応youtube.com/post/{post_id} 形式のリンクと、?lb={post_id} で終わるチャンネルの投稿タブのリンクのどちらも貼り付けられ、どちらも同じ投稿として扱われます。
- 全文とすべての画像text には改行を含む投稿本文全体が入り、media には最初の1枚だけでなく、添付されたすべての画像が並びます。
- 高評価数と投稿チャンネルmetrics.likes_count で高評価の合計がわかり、author にはチャンネルID、ハンドル、名前、URLが入ります。
YouTube Community Post API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須 | コミュニティ投稿のリンクです。https://www.youtube.com/post/{post_id}、または ?lb={post_id} を含むチャンネルの投稿タブのリンクを指定します。 |
YouTube Community Post API の使い方
投稿リンクを1つ送信し、投稿レコードを読み取ります。
- YouTube Community Posts の結果や共有リンクなどから、コミュニティ投稿のリンクをコピーします。
- {"url": "https://www.youtube.com/post/Ugkx..."} を /v1/youtube/community-post に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングし、results.items にある1件の投稿を読み取ります。
curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'
# The result is one post with text, media and metrics.likes_count.YouTube Community Post API の主なユースケース
- クリエイターのお知らせの保存: 新商品の発表、プレゼント企画、配信スケジュールなどの投稿の全文と画像を保存し、後で編集や削除されても記録が残るようにします。
- 個々の投稿の反響の確認: 特定の投稿の likes_count を取得し、クリエイターのお知らせ、アンケート、画像投稿の反響を比較します。
YouTube Community Post API 活用のヒント
- まず YouTube Community Posts でチャンネルの最近の投稿を一覧にし、全文が必要な投稿だけをこのエンドポイントで取得してください。
- 同じリンクで YouTube Community Post Comments も実行すると、投稿と視聴者の反応を並べて確認できます。
関連API
YouTube Community Post API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。
- YouTube Channel Videos API — チャンネルURLから、ショートとライブ配信を除く通常の公開動画を取得します。
- YouTube Transcripts API — 取得可能なプレーンテキストの文字起こしを取得します。言語は任意で指定できます。
- YouTube Channels API — 公開チャンネルのアカウント情報、画像、認証状態、表示中のオーディエンス統計を取得します。
- YouTube Videos API — 既知の動画またはショートのURLから、メタデータ、サムネイル、再生時間、エンゲージメントを取得します。
- YouTube Community Posts API — チャンネルURLから、コミュニティタブの公開投稿を、テキスト、チャンネル情報、タイムスタンプ、画像の参照、取得元の情報とともに取得します。
- YouTube Community Post Comments API — コミュニティ投稿のリンクから、その下のコメントを収集し、コメントしたチャンネル、高評価数、返信数を返します。
- YouTube Comments API
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API