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をポーリングして、正規化された写真レコードを結果のカーソルページネーションで読み取ります。
- 公開FacebookプロフィールまたはページのURLを1つ以上用意します。
- urls と任意の results_limit を /v1/facebook/profile-photos に POST します。
- status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
- /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が含まれていることを確認してください。
関連API
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から、公開リールをキャプション、投稿者情報、動画メタデータ、表示中のエンゲージメント、取得元の参照情報とともに取得します。