youtube/
community-post

リンクから1件のYouTubeコミュニティ投稿を取得し、投稿の全文、添付されたすべての画像、高評価数、投稿したチャンネルを返します。

YouTube Community Post API

投稿URLで入力
全文と画像
高評価数
1リクエストあたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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つ送信し、投稿レコードを読み取ります。

  1. YouTube Community Posts の結果や共有リンクなどから、コミュニティ投稿のリンクをコピーします。
  2. {"url": "https://www.youtube.com/post/Ugkx..."} を /v1/youtube/community-post に POST します。
  3. 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 も実行すると、投稿と視聴者の反応を並べて確認できます。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

YouTube Community Post API — よくある質問

YouTube Community Post APIは、リンクから1件のYouTubeコミュニティ投稿を読み取るためのプログラムインターフェースです。投稿テキスト、添付画像、高評価数、チャンネル情報を返します。

https://www.youtube.com/post/{post_id} と、https://www.youtube.com/@channel/community?lb=Ugkx... のような ?lb={post_id} 付きのチャンネル投稿タブのリンクの両方を受け付けます。

同じリンクを YouTube Community Post Comments に送信してください。各コメントを、投稿者、高評価数、返信数とともに返します。

このエンドポイントは公開投稿の読み取り専用です。公式のYouTube Data APIにもコミュニティ投稿のリソースはなく、読み取りも作成もできません。

返される1件の投稿につき、1リクエストあたり固定で0.5クレジットです。