Facebook Profiles
FacebookのプロフィールとFacebookページは公開されたアカウント情報の画面で、名前、プロフィール文や基本データ、アイコン画像、正規リンク、表示中のオーディエンスや活動のカウンターを含みます。これらの識別フィールドと公開シグナルは、URLの情報補完、エンティティの照合、メタデータのスナップショット、比較リサーチに活用できます。
Facebook Profiles API の主な機能
- 既知URLの直接照会複数の公開FacebookプロフィールまたはページのURLを送信し、入力ごとに最大1件の正規化プロフィールレコードを受け取れます。
- 正規化された識別フィールドFacebook ID、正規URL、表示名、レコード種別、元の入力URLを一貫した構造で返します。
- 公開プロフィールの表示内容公開されているプロフィール文、自己紹介、説明、基本データのテキストを、取得可能なプロフィールまたはページのアイコン画像とあわせて取得します。
- 表示中のプロフィールのカウンター対象で表示されている一般的なフォロワー数、フォロー数、投稿数、いいね数、コメント数、閲覧数、再生数、シェア数のカウンターを正規化します。
Facebook Profiles API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。公開FacebookプロフィールまたはページのURLです。対応ホストは facebook.com、www.facebook.com、m.facebook.com で、複数の値はカンマまたは改行で区切ります。 |
Facebook Profiles API の使い方
プロフィールまたはページのURLを非同期タスクとして送信し、タスクIDをポーリングして、正規化されたプロフィールレコードを読み取ります。
- facebook.com、www.facebook.com、m.facebook.com 上の公開プロフィールまたはページのURLを1つ以上用意します。
- urls を /v1/facebook/profiles に POST します。
- status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
- /v1/tasks/{task_id}?limit=50 から data.results.items を読み取り、results.has_more が true の間は results.next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/facebook/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"]}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.items.Facebook Profiles API の主なユースケース
- プロフィール・ページのカタログ補完: 既知のFacebook URLのカタログに、正規化されたID、名前、正規リンク、プロフィール文、アイコン画像、表示中のカウンターを追加します。
- 既知URLによるエンティティ照合: 返されたID、正規URL、名前、extra.input_url を使って、送信したリンクを既存のエンティティレコードと結び付けます。
- 公開メタデータのスナップショット: 取得できたプロフィールのテキスト、アイコン画像、カウンターとともに collected_at を保存し、収集の実行ごとに公開メタデータを比較します。
Facebook Profiles API 活用のヒント
- リクエストの検証で確認されるのはFacebookのホストのみで、リソースのパスは確認されないため、各URLが意図したプロフィールまたはページを指していることを確認してください。
- 重複した入力や利用できない入力によって、返されるレコードが送信したURLより少なくなることがあるため、複数URLのタスクを照合する際は extra.input_url を保持してください。
- 個人プロフィールとFacebookページでは公開されるフィールドが異なるため、名前、プロフィールのテキスト、アイコン画像、個々の指標の値は null になり得るものとして扱ってください。
- プロフィール単位のメタデータではなく、投稿、写真、リール、イベント、レビューが必要な場合は、対応するFacebookコンテンツのエンドポイントを使用してください。
関連API
Facebook Profiles API 以外に別の種類の公開Facebookデータが必要な場合は、これらのAPIをご利用ください。
- Facebook Pages API — 公開Facebookページのプロフィール、連絡先、画像、表示中のユーザー評価を取得します。
- Facebook Posts API — 対応するFacebook URLから、公開投稿、メディア、リアクション、コメント、シェアを取得します。
- Facebook Comments API — 投稿URLから、公開コメント、投稿者、エンゲージメント、メディア、元のリンクを取得します。
- Facebook Profile Events API — プロフィールまたはページのURLに関連する公開イベントを、名前、日程、場所、メディア、表示中の指標、取得元の情報とともに取得します。
- Facebook Profile Photos API — プロフィールまたはページのURLから、公開写真をキャプション、投稿者情報、エンゲージメント、画像メタデータ、取得元の参照情報とともに取得します。
- Facebook Reels API — プロフィールまたはページのURLから、公開リールをキャプション、投稿者情報、動画メタデータ、表示中のエンゲージメント、取得元の参照情報とともに取得します。