facebook/
profile-photos

1つ以上のURLから公開Facebookプロフィールやページの写真を取得し、キャプション、投稿者情報、エンゲージメント、画像メタデータ、ソースリンクを正規化レコードとして返します。

Facebook Profile Photos API

プロフィールの写真
画像メタデータ
公開データ
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Facebook Profile Photos

Facebookプロフィールの写真は、プロフィールやFacebookページのフィードに掲載された公開画像で、キャプション、投稿者情報、表示中のエンゲージメント、サイズ、ソースリンクを含みます。これらのレコードは、メディアの資産管理、ビジュアルコンテンツのリサーチ、プロフィール単位のモニタリングに活用できます。

Facebook Profile Photos API の主な機能

  • 複数プロフィールの写真フィード1つ以上のFacebookプロフィールまたはページのURLから公開写真のレコードを取得します。指定した上限は入力ごとに個別に適用されます。
  • 正規化された画像メタデータ画像URL、サムネイル、幅、高さ、再生時間のメタデータを、写真IDや正規リンクとあわせて返します。
  • 写真とソースのコンテキストキャプション、公開されている投稿者データ、表示中のエンゲージメント、タイムスタンプ、extra.input_url を保持し、分析や出典の特定に活用できます。
  • カーソルによるフィードの巡回公開写真フィードのカーソルをたどり、入力ごとの上限に達するまでの間、安定したID、URL、画像の同一性で重複レコードを除去します。

Facebook Profile Photos API のパラメータ

パラメータ必須説明
urls必須公開FacebookプロフィールまたはページのURLです。カンマまたは改行で区切ります。
results_limit任意入力URLごとに取得する写真の最大数です。20〜2,000の範囲で指定でき、デフォルトは100です。

Facebook Profile Photos API の使い方

公開プロフィールまたはページのURLを非同期タスクとして送信し、タスクIDをポーリングして、正規化された写真レコードを結果のカーソルページネーションで読み取ります。

  1. 公開FacebookプロフィールまたはページのURLを1つ以上用意します。
  2. urls と任意の results_limit を /v1/facebook/profile-photos に POST します。
  3. status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、保存済みの写真がさらにある場合は results.next_cursor を渡します。
curl -X POST "https://api.socq.ai/v1/facebook/profile-photos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/NASA"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Facebook Profile Photos API の主なユースケース

  • 公開メディアの資産管理: 写真ID、正規リンク、画像URL、サイズ、キャプション、ソースの入力を、プロフィール単位のアセットインデックスとして整理します。
  • ビジュアルコンテンツのリサーチ: キャプション、画像メタデータ、タイムスタンプ、表示中のエンゲージメントを比較し、公開写真の投稿傾向を調べます。
  • プロフィール写真のモニタリング: 選定したプロフィールまたはページのURLで収集を繰り返し、写真の同一性と extra.input_url を使って新たに公開されたレコードを検出します。

Facebook Profile Photos API 活用のヒント

  • 公開写真フィードがある、facebook.com、www.facebook.com、m.facebook.com のプロフィールおよびページのURLを使用してください。ホストの検証だけでは、対象のリソースが適切であることは保証されません。
  • 20〜2,000の上限はURLごとに個別に適用されるため、入力URLの数を考慮して results_limit を設定してください。
  • 複数回の実行結果を統合する際は、正しいソースプロフィールを保持できるよう、写真の id、URL、画像の同一性と extra.input_url を組み合わせて重複排除してください。
  • キャプション、投稿者のフィールド、指標、タイムスタンプ、メディアのサイズは任意項目として扱い、表示やダウンロードの前に media に画像URLが含まれていることを確認してください。

Facebook Profile Photos API 以外に別の種類の公開Facebookデータが必要な場合は、これらのAPIをご利用ください。

  • Facebook Posts API — 対応するFacebook URLから、公開投稿、メディア、リアクション、コメント、シェアを取得します。
  • Facebook Video Transcript API — 既知の公開動画投稿またはリールのURLから、取得可能な文字起こしテキストと形式を抽出します。
  • Facebook Group Posts API — FacebookグループのURLから公開投稿を取得します。並び順やグループごとの取得上限を指定でき、投稿者情報、動画メディア、表示中のエンゲージメントを返します。
  • Facebook Ad Transcript API — Facebook広告ライブラリのURLから、取得可能な音声の文字起こしテキスト、言語、形式、取得元の情報を抽出します。
  • Facebook Profiles API — 既知のFacebook URLから公開プロフィールまたはページを検索し、アカウント情報、プロフィール文、アバター、表示中のカウント、入力情報を返します。
  • Facebook Reels API — プロフィールまたはページのURLから、公開リールをキャプション、投稿者情報、動画メタデータ、表示中のエンゲージメント、取得元の参照情報とともに取得します。

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

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

Facebook Profile Photos API — よくある質問

Facebook Profile Photos APIは、指定したFacebookプロフィールまたはページの公開写真フィードを一貫したメディアレコードとして整理するプログラムインターフェースで、一括での資産管理や継続的な追跡を容易にします。これらのレコードはビジュアルコンテンツのリサーチやプロフィールのモニタリングに活用でき、対象は公開写真フィードからアクセスできるコンテンツに限られます。

facebook.com、www.facebook.com、m.facebook.com 上の公開プロフィールまたはページを使用してください。検証で確認されるのはホストのみのため、別のFacebookリソースを指定した場合は写真フィードが返らないことがあります。

レコードには、写真ID、正規URL、キャプションテキスト、公開されている投稿者情報の元データ、表示中の指標、メディアのURLとサイズ、created_at、collected_at、extra.input_url が含まれる場合があります。

results_limit は20〜2,000の範囲で指定し、デフォルトは100です。上限は送信したURLごとに個別に適用され、上限に達する前にフィードが終了することもあります。

非公開、制限付き、削除済み、ログイン必須、またはその他の理由で利用できない写真は返されません。アルバム構成、コメント、タグ付けされた人物、リアクションの完全な内訳、元ファイルのダウンロードは保証されません。

保存された写真レコード1件につき0.5クレジットで、タスクごとの基本料金はかかりません。見積もりは、URLごとの取得上限に送信したURLの数を掛けて算出されます。