facebook/
profiles

既知のURLから公開Facebookプロフィールやページの詳細を取得し、ID、名前、プロフィール文、アイコン画像、表示中のカウンターを、入力ごとに最大1件の正規化レコードとして返します。

Facebook Profiles API

プロフィール照会
ページ照会
既知のURL
結果1件あたり1.2クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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をポーリングして、正規化されたプロフィールレコードを読み取ります。

  1. facebook.com、www.facebook.com、m.facebook.com 上の公開プロフィールまたはページのURLを1つ以上用意します。
  2. urls を /v1/facebook/profiles に POST します。
  3. status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
  4. /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コンテンツのエンドポイントを使用してください。

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から、公開リールをキャプション、投稿者情報、動画メタデータ、表示中のエンゲージメント、取得元の参照情報とともに取得します。

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

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

Facebook Profiles API — よくある質問

Facebook Profiles APIは、既知のFacebookプロフィールまたはページのURLから公開されている識別情報を取得し、レコードの情報補完や照合を容易にするプログラムインターフェースです。URLの情報補完、エンティティの照合、プロフィールのスナップショットに活用でき、各入力から生成される公開レコードは最大1件で、キーワードによるプロフィール検索は行いません。

facebook.com、www.facebook.com、m.facebook.com 上の空でないURLを送信してください。バリデーターはホストを確認しますが、パスがプロフィールやページを示しているかどうかは確認しません。このエンドポイントはプロフィール検索ではなく、直接照会を行います。

正規化レコードには、id、platform、resource、type、url、name、text、avatar_url、metrics、created_at、collected_at、extra.input_url が含まれます。created_at は現在 null で返されます。

はい。この照会は公開プロフィールまたはページのURLを対象としています。表示されるフィールドはそれぞれ異なるため、すべてのレコードに同じプロフィール文、アイコン画像、カウンターがあるとは想定しないでください。

各URLから生成されるレコードは最大1件で、重複、非公開、ログイン制限、削除済み、入力ミス、利用不可の対象ではレコードが生成されないことがあります。返されたレコードを元のリクエストと照合するには extra.input_url を使用してください。

保存されたプロフィールレコード1件につき1.2クレジットで、タスクごとの基本料金はかかりません。結果が空の場合は結果に対する料金は発生しません。