Facebook Profile Events
Facebookプロフィールのイベントは、プロフィールやFacebookページに関連付けられた公開イベント情報で、イベント名、説明、開催場所、開始・終了日時、メディア、表示中の指標を含みます。日程とソースのコンテキストは、主催者カレンダーの情報補完、イベント一覧のリサーチ、ページ間の比較に活用できます。
Facebook Profile Events API の主な機能
- プロフィールとページのイベントフィード送信した1つ以上のFacebookプロフィールまたはページのURLに関連する公開イベント情報を取得します。
- イベントの基本情報と日程イベントID、公開URL、イベント名、説明、開催場所、正規化された開始日時と終了日時を返します。
- メディアと表示中の指標各イベントに付随する、正規化された公開画像・動画への参照と、一般的な表示中の指標を保持します。
- 正規化されたソースのコンテキスト各正規化レコードに送信したソースURLを付与し、同じソースフィード内ではIDまたはURLで重複するイベントを除去します。
Facebook Profile Events API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | facebook.com、www.facebook.com、m.facebook.com 上の、FacebookのプロフィールまたはページのURLを1つ以上指定します。 |
results_limit | 任意 | 入力URLごとに取得するイベントレコードの最大数です。20〜2,000の範囲で指定でき、デフォルトは100です。 |
Facebook Profile Events API の使い方
プロフィールまたはページのURLを非同期タスクとして送信し、タスクIDをポーリングして、正規化されたイベントレコードをカーソルページネーションで読み取ります。
- FacebookのプロフィールまたはページのURLを1つ以上用意し、必要に応じてURLごとに20〜2,000の範囲で results_limit を指定します。
- urls と任意の results_limit を /v1/facebook/profile-events に POST します。
- status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
- /v1/tasks/{task_id}?limit=50 を読み取り、results.has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/facebook/profile-events" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Facebook Profile Events API の主なユースケース
- 主催者カレンダーの情報補完: イベント名、説明、開催場所、開始・終了日時を使って、既知の公開主催者ページから作成したカレンダーの情報を補完します。
- ページ横断のイベント一覧: 正規化されたイベントIDとURLを input_url ごとにまとめ、選定したプロフィールやページの公開イベント情報を比較します。
- イベント詳細の取得キュー: 返されたイベントURLを使って、より詳しいイベント詳細を取得するための重複のないキューを作成します。
- 公開スケジュールのレポーティング: 日程のフィールド、メディア参照、表示中の指標を組み合わせ、追跡している公開ソースに関連するイベントのレポートを作成します。
Facebook Profile Events API 活用のヒント
- イベントフィードが公開されているプロフィールまたはページを送信してください。ホストの検証だけでは、そのFacebook URLが適切なソースであるかどうかは確認できません。
- 上限と結果ベースの見積もりコストはURLごとに個別に適用されるため、入力URLの数を考慮して results_limit を設定してください。
- 同じイベントが送信した複数のソースに関連付けられている可能性がある場合は、統合した結果をイベントIDまたは公開URLで重複排除してください。
- レコードをアプリケーションにマッピングする際は、説明文、開催場所、終了日時、メディア、個々の指標の値を任意項目として扱ってください。
関連API
Facebook Profile Events API 以外に別の種類の公開Facebookデータが必要な場合は、これらのAPIをご利用ください。
- Facebook Pages API — 公開Facebookページのプロフィール、連絡先、画像、表示中のユーザー評価を取得します。
- Facebook Posts API — 対応するFacebook URLから、公開投稿、メディア、リアクション、コメント、シェアを取得します。
- Facebook Comments API — 投稿URLから、公開コメント、投稿者、エンゲージメント、メディア、元のリンクを取得します。
- Facebook Video Transcript API — 既知の公開動画投稿またはリールのURLから、取得可能な文字起こしテキストと形式を抽出します。
- Facebook Event Details API — 既知の公開イベントURLから、正規化されたメタデータ、日程、場所、メディア、表示中のエンゲージメントを取得します。
- Facebook Profiles API — 既知のFacebook URLから公開プロフィールまたはページを検索し、アカウント情報、プロフィール文、アバター、表示中のカウント、入力情報を返します。