Facebook Posts
Facebook投稿は、Facebookページ、プロフィール、グループで公開される更新情報で、テキスト、リンク、メディア、投稿者情報、タイムスタンプ、表示中のエンゲージメントを含みます。これらのコンテンツとエンゲージメントのシグナルは、キャンペーンのモニタリング、編集リサーチ、オーディエンス分析、レポーティングに活用できます。
Facebook Posts API の主な機能
- 対応する公開URL公開Facebookページ、プロフィール、グループ、投稿のURLから、1つの正規化されたレスポンス形式で投稿を取得します。
- コンテンツとメディアのフィールド投稿テキスト、投稿ID、投稿者情報、タイムスタンプ、リンク、メディア、シェア数、コメント数、表示中のリアクション数を正規化されたフィールドで返します。
- リアクションの内訳like、love、wow、care、sad、angry、haha の表示中のリアクション内訳を提供します。
- 取得件数の上限指定対応するURLを1つ以上受け付け、results_limit で取得する投稿レコード数の上限を指定できます。
- 公開データの範囲非公開、制限付き、ログイン必須、または削除済みのコンテンツはレスポンスの対象外です。
Facebook Posts API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 公開Facebookページ、プロフィール、グループ、投稿のURLです。カンマまたは改行で区切ります。 |
results_limit | 任意 | 収集タスクが取得するレコードの最大数です。正の整数で指定してください。 |
Facebook Posts API の使い方
非同期の収集タスクを送信し、タスクIDをポーリングして、正規化された公開投稿レコードをカーソルページネーションで読み取ります。
- 公開Facebookページ、プロフィール、グループ、投稿のURLを1つ以上用意します。
- urls と任意の results_limit を /v1/facebook/posts に POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /v1/tasks/{task_id}?limit=50 を読み取り、続きのレコードがある場合は results.next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/facebook/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/cern"],"results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Facebook Posts API の主なユースケース
- 公開ページのモニタリング: 自社プロダクトで追跡しているFacebookページから、公開投稿、タイムスタンプ、リンク、メディア参照、表示中のカウンターを取得します。
- キャンペーン・ブランドのレポーティング: キャンペーンデータをダッシュボードやBIツールに送る前に、投稿テキスト、リアクション、コメント、シェア、メディアのフィールドを正規化します。
- コンテンツリサーチ: ブランド、イベント、トピックに関する公開キャプション、投稿テーマ、リンク、画像、動画、エンゲージメントの傾向を分析します。
- ソーシャルリスニングのワークフロー: 壊れやすいページパーサーを保守することなく、公開投稿のシグナルをレビューキュー、アラートシステム、社内リサーチツールに連携します。
- 投稿アーカイブと監査証跡: 正規化された投稿ID、ソースURL、タイムスタンプ、表示中のカウンター、収集日時を保存し、再現性のあるアーカイブやレポートに活用します。
Facebook Posts API 活用のヒント
- まずは少数の公開ページから始め、リトライとバックオフの処理が機能することを確認してから limit を増やしてください。
- 障害発生後に投稿の収集を再開できるよう、正規化された投稿ID、URL、タスクID、next_cursor を保存してください。
- ソース側の公開状況によっては、一部の公開投稿でコメント、メディア、リアクションの詳細、タイムスタンプが含まれない場合があります。
- 簡易的なプレビューフィールドを超えて公開コメントのスレッドを詳しく取得したい場合は、Comments APIを使用してください。
- 公開されているAPIドキュメントで明示的にサポートされていない限り、非公開、制限付き、ログイン必須、アカウント所有者のみのデータを連携の前提に含めないでください。
関連API
Facebook Posts API 以外に別の種類の公開Facebookデータが必要な場合は、これらのAPIをご利用ください。
- Facebook Pages API — 公開Facebookページのプロフィール、連絡先、画像、表示中のユーザー評価を取得します。
- Facebook Comments API — 投稿URLから、公開コメント、投稿者、エンゲージメント、メディア、元のリンクを取得します。
- Facebook Video Transcript API — 既知の公開動画投稿またはリールのURLから、取得可能な文字起こしテキストと形式を抽出します。
- Facebook Group Posts API — FacebookグループのURLから公開投稿を取得します。並び順やグループごとの取得上限を指定でき、投稿者情報、動画メディア、表示中のエンゲージメントを返します。
- Facebook Ad Transcript API — Facebook広告ライブラリのURLから、取得可能な音声の文字起こしテキスト、言語、形式、取得元の情報を抽出します。
- Facebook Profiles API — 既知のFacebook URLから公開プロフィールまたはページを検索し、アカウント情報、プロフィール文、アバター、表示中のカウント、入力情報を返します。