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を、任意の並び順とグループごとの取得上限とともに送信し、非同期タスクの結果をカーソルページネーションで読み取ります。
- 公開FacebookグループのURLを1つ以上用意します。
- urls と任意の results_limit、sort_by を /v1/facebook/group-posts に POST し、返された task_id を保存します。
- タスクが成功するか失敗が返されるまで /v1/tasks/{task_id} をポーリングします。
- 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 trueFacebook 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 をたどってください。
関連API
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から、公開写真をキャプション、投稿者情報、エンゲージメント、画像メタデータ、取得元の参照情報とともに取得します。