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つの文字起こしを読み取ります。
- {"urls": ["https://x.com/NASA/status/2119833829389041896"]} を /v1/x/post-transcript に POST します。
- GET /v1/tasks/{task_id} をポーリングします。status が succeeded になると文字起こしの準備が完了します。
- 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クレジットです。テキストや画像のポストだけで構成されたリストは失敗し、全額返金されます。
関連API
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のポストを、最高画質のメディアファイルとともに取得します。
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- X User Replies API
- Twitter Follow Checker API