LinkedIn Video Transcript
LinkedInの動画の文字起こしは、動画投稿に付いている字幕の文言をひと続きの文章として書き出し、元の投稿のリンクと結び付けたものです。創業者や経営者、企業が新製品、業績、採用について動画で語る機会は増えており、その言葉をテキストにしておけば、通常のLinkedIn投稿と並べて引用、要約、検索ができるようになります。
LinkedIn Video Transcript API の主な機能
- 共有リンクとアクティビティURLに対応urls は linkedin.com/posts/... 形式の共有リンクと /feed/update/urn:li:activity:... 形式のリンクの両方を受け付け、1回のリクエストで複数の動画投稿を指定できます。
- 動画の字幕から起こしたテキスト各行の text には動画に付いた字幕の言葉が1つの文章として入るため、視聴者が画面上で読む内容と同じ文字起こしになります。
- 文字起こしごとに元の投稿を保持id と url には元の投稿のリンクが入るので、文字起こしからいつでも動画にたどれ、同じ投稿に関するほかのデータとも結合しやすくなります。
LinkedIn Video Transcript API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 動画を含むLinkedIn投稿のリンクを1つ以上指定します。/posts/... 形式または /feed/update/urn:li:activity:... 形式に対応しています。 |
LinkedIn Video Transcript API の使い方
LinkedIn動画投稿のリンクを送信し、動画ごとに1つの字幕の文字起こしを読み取ります。
- {"urls": ["https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go"]} を /v1/linkedin/post-transcript に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items から文字起こしを読み取り、has_more が true の場合は results.next_cursor で次のページを取得します。
curl -X POST "https://api.socq.ai/v1/linkedin/post-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go"]}'LinkedIn Video Transcript API の主なユースケース
- 経営者が動画で語った発言の引用: text から正確な一文を抜き出し、投稿の url を出典として添えれば、CEOの動画メッセージの発言を元の動画と照らし合わせて確認できます。
- 動画投稿とテキスト投稿の横断分析: LinkedIn投稿のテキストに使っているキーワード、トピック、感情分析のパイプラインに text を流し込み、動画での発信もテキスト投稿と同じ基準で集計します。
- 製品デモや決算報告動画の要約メモ: text を要約モデルに渡し、長いデモ動画や決算のまとめ動画を、投稿へのリンク付きの短いメモにまとめます。
LinkedIn Video Transcript API 活用のヒント
- text を処理する前に format を確認してください。plaintext ならそのまま使え、webvtt の場合は字幕のタイミング情報が残っているので、削除するか字幕ファイルとして再利用します。
- language が null のときは、翻訳や言語別モデルに回す前に text から言語を判定してください。
- 投稿者、投稿日時、リアクションも必要な場合は、同じ投稿URLを LinkedIn Posts API にも送り、投稿URLをキーに2つの結果を結合してください。
関連API
LinkedIn Video Transcript API 以外に別の種類の公開LinkedInデータが必要な場合は、これらのAPIをご利用ください。
- LinkedIn Profiles API — プロフィールURLから、公開プロフィールの人物情報、役職、所在地、表示中のオーディエンス数、職歴、学歴、スキルを正規化して返します。
- LinkedIn Companies API — 公開企業の説明、Webサイト、ロゴ、表示中のオーディエンス数と従業員数、業種、所在地、専門分野を正規化して返します。
- LinkedIn Posts API — 対応するURLから、公開投稿のテキスト、投稿者、表示中のエンゲージメント、メディア、公開日時、種類、ハッシュタグを取得します。
- LinkedIn Company Posts API — LinkedInの企業ページURLから公開投稿を探し、テキスト、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。
- LinkedIn Post Comments API — 既知のLinkedIn投稿に表示される公開コメントを取得し、テキスト、投稿者情報、タイムスタンプ、関連ID、表示中のいいね数と返信数を返します。
- LinkedIn Profile Posts API — LinkedInのプロフィールURLに関連する公開投稿を探し、投稿者情報、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを返します。