Facebook Reels
Facebookリールは、プロフィールやFacebookページのフィードで公開されているショート動画で、キャプション、投稿者情報、再生関連のメタデータ、タイムスタンプ、表示中のエンゲージメントを含みます。これらのレコードは、コンテンツの一覧管理、ショート動画のリサーチ、フィードのモニタリング、比較分析に活用できます。
Facebook Reels API の主な機能
- 複数プロフィールのリールフィード1つ以上のFacebookプロフィールまたはページのURLから公開リールのレコードを取得します。指定した上限は入力ごとに適用され、出典の特定用に extra.input_url を保持します。
- 正規化された動画メディア動画URL、サムネイル、サイズ、再生時間のメタデータを、リールIDや公開ソースリンクとあわせて返します。
- クリエイターとエンゲージメントのコンテキスト正規化された各リールについて、キャプション、公開されている投稿者情報の元データ、表示中のいいね数・コメント数・閲覧数・再生数・シェア数、投稿日時を保持します。
- 安定したフィードの巡回プロフィールごとのカーソルをたどり、入力ごとの上限に達するまでの間、ID、投稿ID、URLで重複するリールを除去します。
Facebook Reels API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 公開FacebookプロフィールまたはページのURLです。カンマまたは改行で区切ります。 |
results_limit | 任意 | 入力URLごとに取得するリールの最大数です。20〜2,000の範囲で指定でき、デフォルトは100です。 |
Facebook Reels API の使い方
公開プロフィールまたはページのURLを非同期タスクとして送信し、タスクIDをポーリングして、正規化されたリールレコードを結果のカーソルページネーションで読み取ります。
- リールフィードが公開されている、公開FacebookプロフィールまたはページのURLを1つ以上用意します。
- urls と任意の results_limit を /v1/facebook/reels に 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/reels" \
-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 Reels API の主なユースケース
- プロフィールのリール一覧: リールID、ソースリンク、キャプション、動画への参照、タイムスタンプ、extra.input_url を、プロフィール単位のコンテンツインデックスとして整理します。
- ショート動画のフォーマット調査: 再生時間、サイズ、サムネイル、キャプション、表示中のエンゲージメントを比較し、公開リールがどのように構成され、どう受け止められているかを調べます。
- リールフィードのモニタリング: 選定したプロフィールまたはページのURLで収集を繰り返し、安定したリールの識別情報と投稿日時を使って新たに公開されたレコードを検出します。
Facebook Reels API 活用のヒント
- 公開リールフィードがある、facebook.com、www.facebook.com、m.facebook.com のプロフィールおよびページのURLを使用してください。ホストの検証だけでは、対象のリソースが適切であることは保証されません。
- 20〜2,000の上限はURLごとに個別に適用されるため、入力URLの数を考慮して results_limit を設定してください。
- 繰り返し実行した結果を統合する際は、正しいソースプロフィールを保持できるよう、リールID、投稿ID、URLと extra.input_url を組み合わせて重複排除してください。
- キャプション、投稿者のフィールド、指標、タイムスタンプ、メディアのメタデータは任意項目として扱い、表示やダウンロードの前に media に動画URLが含まれていることを確認してください。
- 話された内容のテキストが必要な場合は、リールレコードに文字起こしを期待するのではなく、既知のリールURLをFacebook Video Transcript APIに送信してください。
関連API
Facebook Reels API 以外に別の種類の公開Facebookデータが必要な場合は、これらのAPIをご利用ください。
- Facebook Posts API — 対応するFacebook URLから、公開投稿、メディア、リアクション、コメント、シェアを取得します。
- Facebook Comments API — 投稿URLから、公開コメント、投稿者、エンゲージメント、メディア、元のリンクを取得します。
- Facebook Video Transcript API — 既知の公開動画投稿またはリールのURLから、取得可能な文字起こしテキストと形式を抽出します。
- Facebook Group Posts API — FacebookグループのURLから公開投稿を取得します。並び順やグループごとの取得上限を指定でき、投稿者情報、動画メディア、表示中のエンゲージメントを返します。
- Facebook Ad Transcript API — Facebook広告ライブラリのURLから、取得可能な音声の文字起こしテキスト、言語、形式、取得元の情報を抽出します。
- Facebook Profiles API — 既知のFacebook URLから公開プロフィールまたはページを検索し、アカウント情報、プロフィール文、アバター、表示中のカウント、入力情報を返します。