facebook/
video-transcript

公開Facebook動画投稿やリールのURLから利用可能な文字起こしテキストを抽出し、ソースリンク、形式、収集日時を正規化レコードとして返します。

Facebook Video Transcript API

動画の文字起こし
既知のURL
ソースに紐づくテキスト
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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を入力と照合してください。

  1. 既知の公開Facebook動画投稿またはリールのURLを1つ以上用意します。このエンドポイントはFacebookページの動画フィードを探索しません。
  2. urls を /v1/facebook/video-transcript に POST し、返された task_id を保存します。
  3. タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
  4. 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=50

Facebook 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 で続きを取得してください。

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から、公開リールをキャプション、投稿者情報、動画メタデータ、表示中のエンゲージメント、取得元の参照情報とともに取得します。

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

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

Facebook Video Transcript API — よくある質問

Facebook Video Transcript APIは、既知の公開Facebook動画投稿またはリールのURLから、利用可能な文字起こしテキストを抽出するためのプログラムインターフェースです。空でない文字起こしテキストが得られた場合、ソースURL、テキスト、出力形式、収集日時を返します。

既知の公開Facebook動画投稿またはリールのURLを含む、空でない urls 配列を送信してください。Facebookページ名、検索クエリ、言語の指定、文字起こし形式、results_limit は受け付けません。

各正規化レコードには、id、platform、resource、type、url、text、null になり得る language、format、created_at、collected_at、extra が含まれます。動画タイトル、投稿者、再生時間、サムネイル、エンゲージメント、セグメントごとのタイムスタンプは、レスポンスで標準化されていません。

結果は、ソースから空でない文字起こしテキストが返された場合にのみ保存されます。そのため、非公開、削除済み、未対応、利用不可、または文字起こしのないメディアでは、プレースホルダーの行も残りません。

このエンドポイントでは言語パラメータを受け付けません。正規化スキーマには null になり得る language フィールドが用意されていますが、現在のFacebookコレクターは言語の選択に対応しておらず、ソース言語のラベルも保証しません。

返された正規化文字起こし結果1件につき0.7クレジットです。現在の空結果ポリシーでは、結果が得られなかった入力URLに結果単位の料金はかかりません。