Facebook Video Transcript
Facebook動画の文字起こしレコードには、公開動画投稿やリールで話されている内容のテキストが含まれ、ソースURL、文字起こしテキスト、形式、収集日時を持ちます。これらのレコードは、音声内容のインデックス化、選定したコンテンツのレビュー、ソースに紐づくアーカイブ、別途取得した投稿メタデータとの組み合わせによるデータ補完に活用できます。
Facebook Video Transcript API の主な機能
- 既知URLの一括文字起こし公開Facebook動画投稿またはリールのURLのリストを受け付け、文字起こしの取得前に完全に一致する重複文字列を除去します。
- ソースに紐づく文字起こしレコード取得できた文字起こしごとに、送信したソースURLと、そのURLをフォールバックとするレコードIDを返します。
- 明示的なテキスト形式返されるテキストが plaintext か WebVTT かを示し、後続の処理に向けて文字起こしの収集日時を含めます。
- 取得できた結果のみを返却送信した公開URLから空でない文字起こしテキストが得られた場合にのみ正規化レコードを作成するため、結果数が入力数より少なくなることがあります。
Facebook Video Transcript API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 既知の公開Facebook動画投稿またはリールのURLです。カンマまたは改行で区切ります。 |
Facebook Video Transcript API の使い方
既知の公開Facebook動画投稿またはリールのURLを送信します。空でない文字起こしテキストがある場合にのみ結果が生成されるため、返されたソースURLを入力と照合してください。
- 既知の公開Facebook動画投稿またはリールのURLを1つ以上用意します。このエンドポイントはFacebookページの動画フィードを探索しません。
- urls を /v1/facebook/video-transcript に POST し、返された task_id を保存します。
- タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は next_cursor をたどります。テキストを保存する際は各レコードの url と format を使用してください。
curl -X POST "https://api.socq.ai/v1/facebook/video-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/reel/1535656380759655"]}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Facebook Video Transcript API の主なユースケース
- 音声内容の検索インデックス: 文字起こしテキストをソースURL、レコードID、形式、収集日時とともにインデックス化し、選定した公開動画を話された言葉で検索できるようにします。
- 選定した動画・リールのレビュー: ソースに紐づく文字起こしテキストを使って、厳選した既知の公開動画投稿やリールのURLで話されている内容を確認します。
- 投稿メタデータの補完: データセットに音声内容と公開投稿のコンテキストの両方が必要な場合、ソースURLをキーにして、別途取得した投稿の詳細と文字起こしテキストを結合します。
Facebook Video Transcript API 活用のヒント
- 各対象にアクセスできることを確認したうえで、既知の公開動画投稿またはリールのURLを送信してください。形式が不正なURL、非公開、削除済み、または未対応のメディアでは、レコードが生成されないことがあります。
- バックエンドが除去するのは完全に一致する重複のみのため、同じ動画がトラッキングパラメータ付きや別形式のURLで現れる可能性がある場合は、まとめて送信する前にURL文字列を正規化してください。
- 成功後は返された url の値を送信したリストと照合し、空でない文字起こしテキストが得られなかったURLもワークフロー上で把握できるようにしてください。
- テキストを解析する前に format を確認してください。webvtt のレコードにはキューのマークアップが残っている場合があり、構造のないプレーンテキストとして処理すべきではありません。
- URLのバッチが複数の結果ページにまたがる場合は、has_more が true の間 results.next_cursor で続きを取得してください。
関連API
Facebook Video Transcript API 以外に別の種類の公開Facebookデータが必要な場合は、これらのAPIをご利用ください。
- Facebook Posts API — 対応するFacebook URLから、公開投稿、メディア、リアクション、コメント、シェアを取得します。
- Facebook Comments API — 投稿URLから、公開コメント、投稿者、エンゲージメント、メディア、元のリンクを取得します。
- Facebook Group Posts API — FacebookグループのURLから公開投稿を取得します。並び順やグループごとの取得上限を指定でき、投稿者情報、動画メディア、表示中のエンゲージメントを返します。
- Facebook Ad Transcript API — Facebook広告ライブラリのURLから、取得可能な音声の文字起こしテキスト、言語、形式、取得元の情報を抽出します。
- Facebook Profile Photos API — プロフィールまたはページのURLから、公開写真をキャプション、投稿者情報、エンゲージメント、画像メタデータ、取得元の参照情報とともに取得します。
- Facebook Reels API — プロフィールまたはページのURLから、公開リールをキャプション、投稿者情報、動画メタデータ、表示中のエンゲージメント、取得元の参照情報とともに取得します。