YouTube Community Post Comments
コミュニティ投稿のコメントは、クリエイターが投稿タブに公開した更新の下にファンが書き込む反応で、それぞれ本文、コメントしたチャンネル、高評価数、そこから始まった返信の数を持ちます。こうしたやり取りは動画のコメントとは別の場所にあるため、動画の合間に出されるアンケート、お知らせ、舞台裏の投稿に視聴者がどう反応しているかがわかります。
YouTube Community Post Comments API の主な機能
- 投稿リンクからコメントを取得投稿の /post/ リンクか ?lb= 付きの投稿タブのリンクを送信すると、results_limit(最大1,000件)に達するまでコメントをページ送りで取得します。
- すべての行にコメントしたチャンネルauthor には、コメントしたユーザーのチャンネルID、ハンドル、チャンネルURL、アイコン、認証済みかどうかが入ります。
- 高評価数とスレッドの規模metrics.likes_count と metrics.replies_count から、共感を集めたコメントと議論を呼んだコメントがわかります。
- コメントへの直接リンク各 url はそのコメントがハイライトされた状態で投稿を開き、post_id で各行を元の投稿と紐づけられます。
YouTube Community Post Comments API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須 | コミュニティ投稿のリンクです。https://www.youtube.com/post/{post_id}、または ?lb={post_id} を含むチャンネルの投稿タブのリンクを指定します。 |
results_limit | 任意 | 返すコメントの件数です。1〜1,000で指定でき、デフォルトは100です。 |
YouTube Community Post Comments API の使い方
投稿リンクを送信し、コメントをページ送りで読み取ります。
- {"url": "https://www.youtube.com/post/Ugkx...", "results_limit": 100} を /v1/youtube/community-post-comments に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items からコメントを読み取り、has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ","results_limit":100}'
# Each item is one comment with author, metrics.likes_count and metrics.replies_count.YouTube Community Post Comments API の主なユースケース
- アンケートやお知らせへの反応を読む: クリエイターのアンケートや告知投稿についたコメント本文を取得し、投票数だけではわからないファンの声を確認します。
- 熱心なファンの把握: チャンネルの複数の投稿にわたって author.id でコメントをまとめ、何度も現れる視聴者を見つけます。
- 注目すべきコメントの抽出: likes_count と replies_count で並べ替え、コミュニティが支持したコメントや議論になったコメントを拾い出します。
YouTube Community Post Comments API 活用のヒント
- コメントが数千件ある投稿では、まず控えめな results_limit で始め、最初の結果が役立つ場合にだけ増やしてください。
- コメントの id を保存し、後で同じ投稿を再取得したときは重複を除いてください。
- コメントとあわせて投稿本文も必要な場合は、同じリンクで YouTube Community Post を実行してください。
関連API
YouTube Community Post Comments API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。
- YouTube Channel Videos API — チャンネルURLから、ショートとライブ配信を除く通常の公開動画を取得します。
- YouTube Comments API — 公開コメント、投稿者、エンゲージメント、元の動画、会話の情報を取得します。
- YouTube Channels API — 公開チャンネルのアカウント情報、画像、認証状態、表示中のオーディエンス統計を取得します。
- YouTube Comment Replies API — 返信トークンから既知のYouTubeコメントスレッドの続きを取得し、公開返信、投稿者、エンゲージメント、親コメントの情報を返します。
- YouTube Community Posts API — チャンネルURLから、コミュニティタブの公開投稿を、テキスト、チャンネル情報、タイムスタンプ、画像の参照、取得元の情報とともに取得します。
- YouTube Community Post API — リンクから1件のコミュニティ投稿を読み取り、全文、添付画像、高評価数、投稿したチャンネルを返します。
- YouTube Transcripts API
- YouTube Videos API
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos 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