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ページのレコードをカーソルページネーションで読み取ります。
- 公開FacebookページのURLを1つ以上用意します。
- urls と任意の results_limit を /v1/facebook/pages に 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/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を使用してください。
- 別途公開されているドキュメントで明示的にサポートされていない限り、非公開ページ、制限付きの投稿、ログイン後の画面、アカウント所有者のみのデータを前提としたワークフローは設計しないでください。
関連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から、公開リールをキャプション、投稿者情報、動画メタデータ、表示中のエンゲージメント、取得元の参照情報とともに取得します。