facebook/
reels

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

Facebook Reels API

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

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

README

SocQ 編集 · 更新

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

  1. リールフィードが公開されている、公開FacebookプロフィールまたはページのURLを1つ以上用意します。
  2. urls と任意の results_limit を /v1/facebook/reels に 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/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に送信してください。

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

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

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

Facebook Reels API — よくある質問

Facebook Reels APIは、指定したFacebookプロフィールまたはページの公開リールフィードからショート動画のレコードを取得するプログラムインターフェースで、一括での一覧管理や継続的な観察を容易にします。コンテンツチームはこれらのレコードをアカウントのモニタリングや比較リサーチに活用できますが、対象は対象の公開フィードからアクセスできるリールに限られます。

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

レコードには、リールID、正規URL、キャプションテキスト、公開されている投稿者情報の元データ、表示中の指標、動画URL、サムネイル、サイズ、再生時間、created_at、collected_at、extra.input_url が含まれる場合があります。

返しません。リールレコードにはキャプションと動画メタデータが含まれます。取得可能な音声のテキストは、対応するリールURLについて専用のFacebook Video Transcript APIで扱います。

できません。このエンドポイントは既知の公開プロフィールまたはページのURLのリールフィードを読み取るもので、キーワード検索、トレンドの発見、音源による探索には対応していません。

results_limit は20〜2,000の範囲で指定し、デフォルトは100です。上限は送信したURLごとに個別に適用されます。

いいえ。収集はURLごとの上限、取得可能なフィードの末尾、またはフィード100ページのいずれかで終了します。また、非公開、制限付き、削除済み、ログイン必須、またはその他の理由で利用できないリールは含まれないことがあります。

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