facebook/
group-posts

グループURLから公開Facebookグループの投稿を並び順を選んで取得し、テキスト、投稿者、タイムスタンプ、動画、表示中のエンゲージメントを正規化レコードとして返します。

Facebook Group Posts API

公開グループ投稿
4種類の並び順
グループごとの取得上限
結果1件あたり1.2クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Facebook Group Posts

Facebookグループ投稿は、グループ内で公開されている更新情報で、本文テキスト、投稿者の情報、投稿日時、ソースリンク、表示中のリアクション数・コメント数・再生数、動画メディアを含みます。これらのレコードは、グループ活動のモニタリング、ディスカッションのリサーチ、エンゲージメントの比較、公開コンテンツのレポーティングに活用できます。

Facebook Group Posts API の主な機能

  • 公開グループURLの一括指定1つ以上の公開FacebookグループURLを受け付け、正規化された投稿レコードごとに取得元のグループURLを保持します。
  • 4種類のグループ並び順top_posts、recent_activity、chronological、chronological_listings のいずれかで、送信したグループ全体に適用する並び順を選択できます。
  • グループごとの取得件数results_limit はグループURLごとに個別に適用されます。デフォルトは100で、3〜2,000の範囲で指定できます。
  • 投稿と投稿者のコンテキスト投稿ID、ソースURL、本文テキスト、投稿者IDと名前、投稿日時、収集日時を一貫した構造で返します。
  • 表示中のエンゲージメントと動画公開投稿で表示されている場合は、リアクション数、コメント数、動画再生数に加え、正規化された動画URLとサムネイルURLを含めます。

Facebook Group Posts API のパラメータ

パラメータ必須説明
urls必須必須。公開FacebookグループのURLです。カンマまたは改行で区切ります。
results_limit任意グループURLごとに取得する投稿の最大数です。デフォルトは100で、3〜2,000の整数を指定できます。
sort_by任意任意。送信したすべてのグループに適用する並び順で、top_posts、recent_activity、chronological、chronological_listings のいずれかです。

Facebook Group Posts API の使い方

公開グループURLを、任意の並び順とグループごとの取得上限とともに送信し、非同期タスクの結果をカーソルページネーションで読み取ります。

  1. 公開FacebookグループのURLを1つ以上用意します。
  2. urls と任意の results_limit、sort_by を /v1/facebook/group-posts に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗が返されるまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きをリクエストします。
curl -X POST "https://api.socq.ai/v1/facebook/group-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/groups/1270525996445602/"],"results_limit":30,"sort_by":"recent_activity"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Facebook Group Posts API の主なユースケース

  • 公開グループの活動確認: recent_activity または chronological の並び順と、message、author、created_at、group_url のフィールドを使って、選定したグループの公開更新を確認します。
  • グループディスカッションのアーカイブ: 投稿ID、本文テキスト、投稿者情報、ソースURL、投稿日時、収集日時を、出典をたどれる公開グループレコードとして保存します。
  • 条件をそろえたエンゲージメント比較: 複数のグループURLに同じ sort_by を適用し、同一の並び順のもとで reactions_count、comments_count、views_count を比較します。

Facebook Group Posts API 活用のヒント

  • 各入力が明確なソースに対応するよう、グループ名ではなく公開グループのURLを直接送信してください。
  • 上限はグループごとに個別に適用されるため、リクエストされる件数は urls の数に results_limit を掛けた値として計算してください。
  • 1つのリクエスト内のすべてのグループURLには1つの sort_by の値が適用されるため、並び順を比較する場合は別々のタスクを実行してください。
  • 後続のレコードで出典をたどり、グループ内で重複を排除できるよう、id と extra.group_url をあわせて保持してください。
  • 公開投稿で表示されていない場合に備え、投稿者、本文、投稿日時、動画メディア、動画再生数は任意項目として扱ってください。
  • 完了したタスクに複数の結果ページがある場合は、has_more が false になるまで results.next_cursor をたどってください。

Facebook Group Posts API 以外に別の種類の公開Facebookデータが必要な場合は、これらのAPIをご利用ください。

  • Facebook Pages API — 公開Facebookページのプロフィール、連絡先、画像、表示中のユーザー評価を取得します。
  • Facebook Posts API — 対応するFacebook URLから、公開投稿、メディア、リアクション、コメント、シェアを取得します。
  • Facebook Comments API — 投稿URLから、公開コメント、投稿者、エンゲージメント、メディア、元のリンクを取得します。
  • Facebook Video Transcript API — 既知の公開動画投稿またはリールのURLから、取得可能な文字起こしテキストと形式を抽出します。
  • Facebook Ad Transcript API — Facebook広告ライブラリのURLから、取得可能な音声の文字起こしテキスト、言語、形式、取得元の情報を抽出します。
  • Facebook Profile Photos API — プロフィールまたはページのURLから、公開写真をキャプション、投稿者情報、エンゲージメント、画像メタデータ、取得元の参照情報とともに取得します。

他のプラットフォームを見る

Facebookのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Facebook Group Posts API — よくある質問

Facebook Group Posts APIは、1つ以上のFacebookグループURLから公開投稿を取得するためのプログラムインターフェースで、並び替えを任意で指定できます。正規化された投稿テキスト、投稿者情報、タイムスタンプ、動画メディア、表示中のエンゲージメント、取得元のグループURLを返します。

urls に公開FacebookグループのURLを1つ以上指定してください。空の入力リストは受け付けられず、公開グループの画面で表示されないコンテンツは結果に含まれません。

sort_by には top_posts、recent_activity、chronological、chronological_listings を指定できます。選択した1つの値が、リクエスト内のすべてのグループURLに適用されます。

results_limit はデフォルトが100で、3〜2,000の整数を指定でき、グループURLごとに個別に適用されます。2つのURLに results_limit 30 を指定すると、最大60件の投稿がリクエストされます。

正規化レコードには、id、url、message、author、reactions_count、comments_count、views_count、動画メディア、created_at、collected_at、extra.group_url が含まれる場合があります。公開投稿に存在しないフィールドは、正規化された型に応じて null、0、または空のままになります。

GET /v1/tasks/{task_id} から data.results.items を読み取ります。has_more が true の場合は、次のタスクリクエストで results.next_cursor を cursor として渡してください。各ページの limit は1〜500の範囲で指定できます。

返されたグループ投稿レコード1件につき1.2 SocQクレジットです。リクエスト時の見積もりは urls の数に results_limit を掛けた値で算出され、結果が空の場合は結果に対する料金はかかりません。