facebook/
posts

Facebookページ、プロフィール、グループ、投稿のURLから公開Facebook投稿を取得し、正規化されたテキスト、投稿者情報、メディア、リアクション、コメント数、シェア数を返します。

Facebook Posts API

投稿
リアクション
公開データ
結果1件あたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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をポーリングして、正規化された公開投稿レコードをカーソルページネーションで読み取ります。

  1. 公開Facebookページ、プロフィール、グループ、投稿のURLを1つ以上用意します。
  2. urls と任意の results_limit を /v1/facebook/posts に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /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ドキュメントで明示的にサポートされていない限り、非公開、制限付き、ログイン必須、アカウント所有者のみのデータを連携の前提に含めないでください。

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から公開プロフィールまたはページを検索し、アカウント情報、プロフィール文、アバター、表示中のカウント、入力情報を返します。

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

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

Facebook Posts API — よくある質問

Facebook Posts APIは、Facebookページ、プロフィール、グループ、投稿のURLから一般公開されている投稿を取得するAPIです。正規化されたテキスト、投稿者情報、メディア参照、タイムスタンプ、リアクション、コメント数、シェア数を返します。

公開Facebookページ、プロフィール、公開グループ、投稿のURLを送信してください。非公開グループ、制限付きプロフィール、削除済みの投稿、ログイン必須の画面では、取得できるデータが限られるか、レコードが返らないことがあります。

主な結果フィールドには、id、url、message、author、metrics、reactions、media、created_at、collected_at、extra があります。タスクと結果のページネーションのメタデータは、それぞれを含むAPIレスポンスで返されます。

公開投稿の取得に、お客様側でFacebookのcookieを用意する必要はありません。ログイン後にのみ表示されるコンテンツは公開データの範囲外です。

公開投稿で表示されている場合は、画像、動画、リアクションの詳細、表示中のコメント数が返されます。個々のコメントレコードが必要な場合はFacebook Comments APIを使用し、任意のメディアやリアクションのフィールドは null になり得るものとして扱ってください。

ページサイズは控えめに設定し、429などの負荷を示すレスポンスを受けた後はバックオフを行い、短い間隔でのリトライループは避けてください。大規模なジョブでは小さなバッチに分けて収集し、保存したカーソルから再開してください。

対象が一般公開でアクセス可能であること、投稿が削除または制限されていないこと、指定した任意のフィールドが公開されていることを確認してください。Facebookは公開ページの構造を頻繁に変更するため、フィールドの欠落は通常の公開状況の一つとして扱うことをおすすめします。