API一覧に戻る
Facebookの公開データ

Facebook公開データAPI

公開Facebookページのプロフィール、投稿、グループ投稿、コメント、キーワードに一致するイベント、取得可能な動画の文字起こしを取得できます。アカウント情報、コンテンツ、取得元、形式、場所、メディア、リアクション、参加状況、エンゲージメントのフィールドは正規化されています。

利用できるFacebook API

公開プロフィールのフィールドにはPages、一般的なコンテンツにはPosts、グループURLのレコードにはGroup Posts、議論にはComments、キーワードに一致するイベントにはEvents Search、既知の動画投稿やリールのURLから取得可能な発話テキストにはVideo Transcriptsを使用します。6つすべてで、共通の認証とタスク結果の取得方式を使用します。

取得できるFacebookデータ

SocQは対応する公開Facebookの結果を一貫したJSONレコードに変換し、情報補完、モニタリング、調査、レポーティングのワークフローに活用できるようにします。

公開ページのプロフィール

公開されている場合、ページ名、カテゴリ、説明文、正規URL、プロフィール画像、カバー画像を取得します。

連絡先とオーディエンスのフィールド

公開されている場合、Webサイト、メールアドレス、電話番号、所在地、フォロワー数、ページのいいね数、評価、レビュー数を返します。

公開投稿のコンテンツ

投稿本文、投稿者、タイムスタンプ、リンク、画像、動画の参照、正規化された投稿IDを取得します。

公開コメントとエンゲージメント

取得可能な場合、公開コメントの本文、投稿者フィールド、タイムスタンプ、いいね数、返信数、シェア数、リアクションの情報を取得します。

公開イベントの検索

キーワードで検索し、イベント名、日程、場所、参加状況、カバー画像、オンライン・終了済みイベントのステータスを取得します。

取得可能な動画の文字起こし

既知の公開動画投稿やリールのURLから、取得元に紐づく文字起こしテキストと、そのプレーンテキストまたはWebVTTの形式を抽出します。

SocQ vs Facebook Graph API

SocQは、対応する公開データの取得に特化しています。ユーザーや企業が明示的に認可したアセットを管理する場合は、MetaのGraph APIが適しています。

機能SocQFacebook Graph API
主な用途公開ページ、投稿、グループ投稿、コメント、イベント、文字起こしのデータ取得認可済みのページ、アプリ、アセットの管理
顧客側のOAuthSocQのAPIキーのみ。顧客のFacebook OAuthは不要Metaのアプリ審査、権限、アクセストークン
投稿の作成・編集非対応対象のページ権限があれば対応
非公開・制限付きデータ非対応認可された権限で許可されたデータのみ
レスポンス形式正規化されたSocQレコードGraph API独自のオブジェクト

Facebook APIの仕組み

データ取得は非同期で実行されるため、アプリケーション側でタスクの送信、ステータスの監視、結果ページの処理をそれぞれ独立して行えます。

  1. 1. 入力を送信

    選択したエンドポイントのドキュメントに記載されたフィールドを使い、対応する公開ページ、投稿、グループ、動画投稿、リールのURLをPOSTするか、イベント検索用のキーワードクエリを送信します。

  2. 2. タスクをポーリング

    返されたタスクIDを使い、処理が成功または失敗するまでポーリングします。一時的な負荷を示すレスポンスを受けた後はバックオフしてください。

  3. 3. 読み取りとページネーション

    正規化された結果アイテムを取得し、タスクにさらにレコードがある場合は next_cursor をたどります。

1回のAPIリクエストから始める

SocQのAPIキーで認証します。この例では公開Facebookページのタスクを開始します。一般的な投稿には /v1/facebook/posts、グループ投稿には /v1/facebook/group-posts、コメントには /v1/facebook/comments、イベントの検索には /v1/facebook/events-search、既知の動画投稿やリールのURLには /v1/facebook/video-transcript を使用してください。

curl -X POST "https://api.socq.ai/v1/facebook/pages" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/Meta"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Facebook APIの主なユースケース

ブランドのモニタリング

自社ブランドや競合について、公開ページのアカウント情報、連絡先、オーディエンス、投稿の情報を追跡します。

コンテンツと反応の調査

公開投稿、コメント本文、投稿者、タイムスタンプ、メディア、表示中のエンゲージメントを分析し、レポートや編集上の調査に活用します。

ページ情報の補完

CRM、ディレクトリ、アカウントのレコードに、公開Facebookのアカウント情報、カテゴリ、連絡先、オーディエンスのフィールドを追加します。

イベントの発掘とモニタリング

キーワードに一致したイベントの基本情報、日程、場所、参加状況、カバー画像、ステータスのフィールドを使い、公開イベントのレコードを整理します。

レポーティングパイプライン

正規化された公開ページと投稿のレコードを、ダッシュボード、データウェアハウス、社内のレビューツールに送信します。

発話コンテンツのインデックス化

選んだ公開動画投稿やリールについて、取得可能な文字起こしテキストを取得元URLと形式とともにインデックス化します。

制限事項と公開データポリシー

Facebookの公開結果は動的に変化します。あるページ、投稿、コメント、イベント、文字起こしの取得元で表示されているフィールドが、別のレコードには含まれなかったり、時間とともに変わったりする場合があります。

  • 非公開グループ、制限付きプロフィール、削除済みの投稿、ログインが必要なコンテンツには対応していません。
  • 公開レコードでは、連絡先のフィールド、コメントの投稿者、メディア、カウンター、タイムスタンプ、返信、リアクションの内訳が欠ける場合があります。
  • 送信した公開動画のURLで空でない文字起こしテキストを取得できない場合、文字起こしのレコードは返りません。
  • バッチは小さめにし、リクエストレートを控えめに設定して、一時的なブロックやレート制限に近い状態の後はバックオフしてください。
  • これらのエンドポイントでFacebookのコンテンツを作成、更新、モデレーション、削除することはできません。

Facebook APIに関するよくある質問

これは公式のFacebook Graph APIですか?

いいえ。SocQは対応する公開Facebookの結果を正規化するサービスです。認可済みページの管理、投稿の公開、モデレーションには、MetaのGraph APIを利用してください。

ユーザーがFacebookアカウントを連携する必要はありますか?

いいえ。対応している公開データのエンドポイントでは、顧客側のFacebook OAuthは不要です。リクエストはSocQのAPIキーで認証します。

SocQで非公開のグループやプロフィールを取得できますか?

いいえ。非公開、制限付き、ログインが必要なFacebookコンテンツはサポート対象外です。

料金はどのように計算されますか?

各エンドポイントのカードに、現在の結果1件あたりのクレジット料金が表示されています。タスクは、返された正規化レコードの件数に基づいて課金されます。

さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。

X API

公開プロフィール、フォロワー・フォロー中の関係、ポスト、返信、引用、リツイートしたユーザー、検索結果、現在のトレンドを取得できます。一貫した形式の結果を調査やモニタリングに活用できます。

LinkedIn API

既知のURLから、公開LinkedInのプロフィール、企業、投稿、求人のデータを取得できます。アカウント情報、職歴、企業、コンテンツ、エンゲージメント、求人のフィールドは正規化されています。

Reddit API

既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。

Pinterest API

公開Pinterestプロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。

Threads API

公開Threadsプロフィールの取得、既知の投稿の解決、指定したプロフィールの投稿の取得ができます。アカウント情報、コンテンツ、メディア、エンゲージメント、タイムスタンプのフィールドは正規化されています。

Bluesky API

公開Blueskyプロフィールの取得、既知の投稿URLの解決、アカウントの投稿の1ページ分の取得ができます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントのフィールドは正規化されています。