facebook/
pages

1つ以上のFacebookページのURLから公開ページのプロフィールを取得し、正規化された基本情報、連絡先、画像、フォロワー数といいね数、レビュー、評価を返します。

Facebook Pages API

Facebookページ
プロフィール
公開データ
結果1件あたり2.4クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Facebook Pages

Facebookページは、企業、団体、クリエイター、著名人の公開プロフィールで、基本情報、カテゴリ、説明、画像、連絡先、オーディエンスのシグナルを含みます。これらのプロフィールとオーディエンスのフィールドは、ブランドの発見、ディレクトリの情報補完、市場調査、アカウントの比較に活用できます。

Facebook Pages API の主な機能

  • Facebookページの一括取得FacebookページのURLから、1つ以上の公開Facebookページを取得します。
  • ページの基本情報と画像ページ名、カテゴリ、基本データのテキスト、正規URL、プロフィール画像、カバー画像を正規化されたプロフィールフィールドとして返します。
  • 表示中のオーディエンス指標表示中のフォロワー数、ページへのいいね数、レビュー数、評価の指標を一貫した metrics オブジェクトに含めます。
  • 公開されている連絡先公開されているウェブサイト、メールアドレス、電話番号、住所のフィールドを返し、連絡先やディレクトリの情報補完に活用できます。
  • 公開データの範囲結果は一般公開されているページデータに限られ、非公開、制限付き、ログイン必須のコンテンツはレスポンスの対象外です。

Facebook Pages API のパラメータ

パラメータ必須説明
urls必須公開FacebookページのURLです。カンマまたは改行で区切ります。
results_limit任意収集タスクが取得するレコードの最大数です。正の整数で指定してください。

Facebook Pages API の使い方

収集タスクを送信し、処理が完了するまでタスクIDをポーリングして、正規化されたFacebookページのレコードをカーソルページネーションで読み取ります。

  1. 公開FacebookページのURLを1つ以上用意します。
  2. urls と任意の results_limit を /v1/facebook/pages に 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/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}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Facebook Pages API の主なユースケース

  • ブランドページのモニタリング: 自社や競合のFacebookページを追跡するために、公開されているページの基本情報、カテゴリ、連絡先、オーディエンス指標を取得します。
  • ページのベンチマーク用データセット: 選定したページ間で、カテゴリ、説明、連絡先の網羅状況、フォロワー数、評価、その他の表示中のオーディエンスのシグナルを比較します。
  • レポーティングとBIパイプライン: 正規化された公開ページのレコードを、ダッシュボード、スプレッドシート、データウェアハウス、社内レビューツールに送ります。
  • メディアアーカイブのワークフロー: ページURL、画像、説明、連絡先のフィールド、表示中の指標を保存し、後のレビューやレポーティングに活用します。
  • 公開データによるソーシャルリスニング: 公開されているページの基本情報とオーディエンスのシグナルを使って、ソーシャルアカウントのカタログやブランドのデータセットを補完します。

Facebook Pages API 活用のヒント

  • 大規模なバッチを開始する前に、送信するすべてのURLが公開Facebookページに解決されることを確認してください。
  • 結果の取得状況によっては、一部の公開ページで連絡先、画像、評価、オーディエンスのカウンターが含まれない場合があります。
  • ジョブのリトライ、監査、重複排除ができるよう、固定のページIDと正規URLを保持してください。
  • ワークフローでFacebookページやその他の対応URLから公開投稿のレコードが必要な場合は、Facebook Posts APIを使用してください。
  • 別途公開されているドキュメントで明示的にサポートされていない限り、非公開ページ、制限付きの投稿、ログイン後の画面、アカウント所有者のみのデータを前提としたワークフローは設計しないでください。

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

  • Facebook Posts API — 対応するFacebook URLから、公開投稿、メディア、リアクション、コメント、シェアを取得します。
  • Facebook Comments API — 投稿URLから、公開コメント、投稿者、エンゲージメント、メディア、元のリンクを取得します。
  • Facebook Profile Events API — プロフィールまたはページのURLに関連する公開イベントを、名前、日程、場所、メディア、表示中の指標、取得元の情報とともに取得します。
  • Facebook Profile Photos API — プロフィールまたはページのURLから、公開写真をキャプション、投稿者情報、エンゲージメント、画像メタデータ、取得元の参照情報とともに取得します。
  • Facebook Profiles API — 既知のFacebook URLから公開プロフィールまたはページを検索し、アカウント情報、プロフィール文、アバター、表示中のカウント、入力情報を返します。
  • Facebook Reels API — プロフィールまたはページのURLから、公開リールをキャプション、投稿者情報、動画メタデータ、表示中のエンゲージメント、取得元の参照情報とともに取得します。

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

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

Facebook Pages API — よくある質問

Facebook Pages APIは、1つ以上のFacebookページのURLから一般公開されているページのプロフィールを取得するAPIです。正規化された基本情報、カテゴリ、説明、画像、連絡先、フォロワー数といいね数、レビュー、評価を返します。

基本的な公開ページの取得に、Facebookアプリの認証情報やFacebookへのログインは必要ありません。このAPIを、非公開、制限付き、ログイン必須のコンテンツにアクセスできる前提で使用しないでください。

主なフィールドには、ページID、名前、正規URL、カテゴリ、基本データのテキスト、プロフィール画像、カバー画像、フォロワー数といいね数、レビュー、評価、ウェブサイト、メールアドレス、電話番号、住所があります。

はい。公開ページの結果でプロフィール画像とカバー画像のURLが表示されている場合に取得できます。どちらか一方、または両方の画像フィールドがないページにも対応できるようにしてください。

正規化された metrics オブジェクトには、公開結果で表示されている場合、フォロワー数、ページへのいいね数、レビュー数、評価が含まれます。

Facebookのコンテンツは動的で、公開結果の構造は変わることがあります。空のフィールド、タイムアウト、連絡先データの欠落、ブロックされたリクエストは、通常の公開状況やレート負荷によるケースとして扱ってください。

取得上限を小さくし、リクエスト頻度は控えめにして、失敗後はバックオフを行い、大きなページでは処理のタイムアウトを長めに設定してください。同じページからの大量の繰り返し収集は避けてください。