x/
post-transcript

ポストのURLから、Xの動画内の音声を文字起こしします。話された言葉をプレーンテキストで、各動画の長さ(秒)とともに返し、1回のリクエストで複数のポストを処理できます。

Twitter Video Transcript API

ポストURLを入力
プレーンテキストの文字起こし
秒単位の長さ
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Twitter Video Transcript

X(旧Twitter)の動画では、インタビュー、発表、製品デモ、解説が音声で語られており、文字起こしはその音声をプレーンテキストにして、クリップの長さ(秒)と組み合わせます。文字にすれば、その発言を正確に引用したり、要約や翻訳をしたり、テキストのポストと同じキーワードやトピックの手法で検索したりできます。

Twitter Video Transcript API の主な機能

  • URLで動画ポストを指定動画付きポストの x.com/{username}/status/{post_id} リンクを1つ以上渡すと、動画ごとにポストの id と url を含む1行が返ります。
  • 連続したプレーンテキストの発話内容text には動画内で話された言葉が1つのプレーンテキストのまとまりとして入り、format は "text" で、話者が使った言語で書かれます。
  • 文字起こしごとの動画の長さduration_seconds は動画の再生時間で、クリップを長さで並べ替えたり、動画内の発話の密度を測ったりするのに役立ちます。

Twitter Video Transcript API のパラメータ

パラメータ必須説明
urls必須/{username}/status/{post_id} 形式のXポストURLを1つ以上指定します。いずれも動画を含むポストを指すURLです。

Twitter Video Transcript API の使い方

動画ポストのURLを送信し、動画ごとに1つの文字起こしを読み取ります。

  1. {"urls": ["https://x.com/NASA/status/2119833829389041896"]} を /v1/x/post-transcript に POST します。
  2. GET /v1/tasks/{task_id} をポーリングします。status が succeeded になると文字起こしの準備が完了します。
  3. results.items から各文字起こしを読み取り、has_more が true の場合は results.next_cursor で残りを取得します。
curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/NASA/status/2119833829389041896"]}'

# Videos up to 2 minutes cost 0.7 credits; longer ones cost 4 credits per started minute.

Twitter Video Transcript API の主なユースケース

  • クリップ内の発言を引用: text から正確な文を写し、ポストの url を出典として添えると、インタビューや報道クリップからの引用を元の情報と照らし合わせて確認できます。
  • 動画ポストの要約と翻訳: text を要約や翻訳のモデルに送り、長い動画ポストを短いメモにまとめたり、他の言語に変換したりします。
  • 多数の動画で話された内容を検索: クリエイターやブランドの動画ポストの文字起こしをインデックス化し、製品、人物、トピックに言及しているクリップをすべて見つけます。
  • 動画のテキスト版を公開: 記事、ニュースレター、ヘルプページで動画の下に text を置き、音を消したままでも読者が内容を追えるようにします。

Twitter Video Transcript API 活用のヒント

  • 長い録画は別枠で予算を組んでください。2分以内の動画は0.7クレジットですが、10分の録画は40クレジットで、全体の長さに対して開始した1分ごとに課金されます。
  • 各文字起こしは動画内で話された言語で書かれるため、翻訳に回す前に text の言語を判定してください。
  • どのポストに動画があるかわからない場合は、ポストURLを混在させて送信してください。動画ポストは文字起こしを返し、それ以外は0クレジットです。テキストや画像のポストだけで構成されたリストは失敗し、全額返金されます。

Twitter Video Transcript API 以外に別の種類の公開Xデータが必要な場合は、これらのAPIをご利用ください。

  • Twitter Tweet Scraper API — x.comまたはtwitter.comのステータスURLから、公開ポストのテキスト、投稿者、エンゲージメント、メディア、ハッシュタグ、メンション、会話の関係を取得します。
  • Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
  • X Post Quotes API — 既知のステータスURLについて公開引用ポストを取得し、コメント、投稿者、エンゲージメント、メディア、タイムスタンプ、元のポストの情報を返します。
  • X Post Replies API — XのポストURLから公開返信を取得します。並び順を指定でき、返信テキスト、投稿者、表示中のエンゲージメント、メディア、親ポストの情報を返します。
  • Twitter Mentions API — 指定したアカウントをメンションしている公開ポストを取得します。
  • Twitter Media Scraper API — アカウントが投稿した画像・動画・GIFのポストを、最高画質のメディアファイルとともに取得します。

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

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

Twitter Video Transcript API — よくある質問

Twitter Video Transcript APIは、動画を含むポストのURLから、Xの動画内の音声をテキストに変換するためのプログラムインターフェースです。動画ごとにプレーンテキストの文字起こしと、動画の長さ(秒)を返します。

ポストのリンクをコピーして urls に追加し(1回のリクエストで複数のリンクを指定できます)、タスクが成功したら text から文字起こしを読み取ります。

いいえ。各動画は format が "text" のプレーンテキストの文字起こし1つと、動画全体の duration_seconds を返します。行ごとのタイミングはありません。

2分以内の動画は0.7クレジットです。それより長い動画は全体の長さに対して開始した1分ごとに4クレジットかかるため、3分の動画は12クレジットです。

文字起こしは動画内で話されている言語で書かれます。結果に言語ラベルは含まれないため、ワークフローで必要な場合は text から判定してください。

動画のないポストは行を返さず、課金もされません。送信したポストのいずれにも動画がない場合、タスクは失敗し全額返金されます。