facebook/
profile-events

FacebookのプロフィールまたはページのURLに関連する公開イベントを取得し、イベント名、説明、日程、開催場所、メディア、表示中の指標、ソースのコンテキストを正規化レコードとして返します。

Facebook Profile Events API

プロフィールのイベント
URLの一括指定
公開データ
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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をポーリングして、正規化されたイベントレコードをカーソルページネーションで読み取ります。

  1. FacebookのプロフィールまたはページのURLを1つ以上用意し、必要に応じてURLごとに20〜2,000の範囲で results_limit を指定します。
  2. urls と任意の results_limit を /v1/facebook/profile-events に POST します。
  3. status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
  4. /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で重複排除してください。
  • レコードをアプリケーションにマッピングする際は、説明文、開催場所、終了日時、メディア、個々の指標の値を任意項目として扱ってください。

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から公開プロフィールまたはページを検索し、アカウント情報、プロフィール文、アバター、表示中のカウント、入力情報を返します。

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

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

Facebook Profile Events API — よくある質問

Facebook Profile Events APIは、指定したFacebookプロフィールまたはページに関連する公開イベントをまとめて取得するプログラムインターフェースで、イベントを1件ずつ探す手間を省けます。主催者カレンダー、イベント一覧、ページ間の比較に活用でき、対象は個別のイベントURLではなく公開イベントのソースです。

facebook.com、www.facebook.com、m.facebook.com でホストされているURLを1つ以上送信してください。検証で確認されるのはホストのみのため、公開イベントフィードに適したプロフィールまたはページを対象にしてください。

results_limit はデフォルトが100で、20〜2,000の整数を指定できます。上限は送信したURLごとに個別に適用され、ソースにそれ以上の公開イベントがない場合は収集が早めに終了することがあります。

Facebookのホストが有効であっても、対象が対応する公開イベントフィードを公開しているとは限りません。また、利用できない、削除済み、古い、非公開、ログインが必要なイベントは含まれないことがあります。

返されたタスクIDを status が succeeded になるまでポーリングし、その後タスク結果のエンドポイントから保存されたイベントレコードを読み取ってください。

保存されたイベントレコード1件につき0.6クレジットで、タスクごとの基本料金はかかりません。そのため、完了した結果が空の場合は結果ベースの料金は発生しません。