tiktok/
video-transcript

公開TikTok動画のURLから、任意の言語指定で文字起こしを抽出し、テキスト、言語、形式、ソースリンク、取得日時を正規化レコードとして返します。

TikTok Video Transcript API

動画の文字起こし
言語指定(任意)
プレーンテキストまたはWebVTT
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Video Transcript

TikTok動画の文字起こしレコードには、公開動画から取得できた音声または字幕のテキストが含まれ、言語、プレーンテキストまたはWebVTTの形式、ソースURL、ショートコード、取得日時が付与されます。これらのレコードは、発話内容の検索、キーワードやトピックの分析、アクセシビリティの確認、出典付きの引用調査に活用できます。

TikTok Video Transcript API の主な機能

  • 複数URLの文字起こし検索1つのタスクで1つ以上の公開TikTok動画URLを処理し、各検索に任意の言語指定を渡せます。
  • 正規化されたテキストと出典情報文字起こしテキストを、言語、プレーンテキストまたはWebVTTの形式、ソースURL、レコードID、ショートコード、取得日時とともに一貫した構造で返します。
  • 取得できた結果のみのレコードソースが空でない文字起こしテキストを返した場合にのみ結果を出力するため、プレースホルダー行なしで、文字起こしが取得できた動画を区別できます。

TikTok Video Transcript API のパラメータ

パラメータ必須説明
urls必須解決可能な公開TikTok動画URLを1つ以上指定します。カンマまたは改行で区切ってください。
language任意任意。優先する文字起こしの言語です。en、es、fr のような2文字のコードを使用してください。

TikTok Video Transcript API の使い方

既知の公開TikTok動画URLを非同期タスクとして送信し、タスクIDをポーリングして、正規化された文字起こしレコードを送信したソースと照合します。

  1. 解決可能な公開TikTok動画URLを1つ以上用意し、必要に応じて en のような2文字の言語コードを用意します。
  2. urls と任意の language を /v1/tiktok/video-transcript に POST し、返された task_id を保存します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。成功した場合でも、レコード数が送信したURL数より少ないことがあります。
  4. data.results.items を読み取って各 url を入力リストと照合し、results.has_more が true の間は results.next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/video-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@stoolpresidente/video/7499229683859426602"],"language":"en"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • 発話内容を検索できるアーカイブ: 文字起こしテキストをソースURL、言語、形式、ショートコード、取得日時とともにインデックス化し、選定した公開動画を発話中の語句で検索できるようにします。
  • キーワードとトピックの分析: 既知の動画群の正規化テキストを分析し、繰り返し現れる単語、フレーズ、テーマを見つけます。確認用にソースリンクも保持します。
  • アクセシビリティと引用の確認: 取得できた文字起こしテキストと形式のメタデータを使って読みやすいテキストを用意したり該当箇所を探したりし、リンク先の公開動画と照らし合わせて確認します。

TikTok Video Transcript API 活用のヒント

  • リクエストはTikTokのホストや /video/{id} パスを強制せず空でないURL文字列を受け付けるため、送信前にすべての対象が意図した公開TikTok動画に解決されることを確認してください。
  • 空白除去と重複排除は送信された文字列が完全に一致する場合にしか統合されないため、まとめて送信する前にURLを正規化し、トラッキング用のバリエーションを取り除いてください。
  • 言語を指定する場合は en のような2文字のコードを使用し、指定が反映されたと想定するのではなく、返された language フィールドに基づいて後続の処理を振り分けてください。
  • 成功後は返された url の値を送信したリストと照合し、利用不可、非公開、削除済み、制限付き、字幕なし、発話なしの動画もワークフロー上で把握できるようにしてください。
  • format に応じて解析処理を分岐し、WebVTTのキューがある場合は保持してください。created_at には動画の公開日時が含まれないため、データの来歴には collected_at を使用してください。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Comments API — 公開トップレベルコメント、投稿者、エンゲージメント、メンション、クリエイターとのやり取りを示すフラグを取得します。
  • TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
  • TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
  • TikTok Trending Feed API — 地域ごとの現在の公開動画フィードを取得し、クリエイター、キャプション、カバー、タイムスタンプ、表示中のエンゲージメントの各フィールドを返します。
  • TikTok Song API — クリップIDまたは音楽URLから、公開サウンドのメタデータを取得します。

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

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

TikTok Video Transcript API — よくある質問

TikTok Video Transcript APIは、1つ以上の公開TikTok動画URLから、任意の言語指定で取得可能な文字起こしテキストを抽出するためのプログラムインターフェースです。空でない文字起こしテキストが取得できた場合に、正規化されたテキスト、言語、プレーンテキストまたはWebVTTの形式、ソースURL、ショートコード、取得日時を返します。

空でない urls 配列と、任意で language の文字列を送信してください。results_limit、usernames、検索クエリ、メディアのダウンロード設定、AIによるフォールバックの切り替えには対応していません。

各レコードには、id、platform、resource、type、url、text、null になりうる language、format、created_at、collected_at、extra.shortcode が含まれます。動画の説明文、投稿者、エンゲージメント指標、カバー画像、ダウンロードURL、時間区切りのセグメントオブジェクトは保持されません。

レコードは、ソースが空でない文字起こしテキストを返した場合にのみ作成されます。そのため、取得可能な音声や字幕がない動画や、非公開、削除済み、制限付き、利用不可の対象では、プレースホルダー行も残りません。

保証されません。en、es、fr のような2文字の優先言語を指定したうえで、返された language フィールドを確認してください。利用できる言語と文字起こしの精度は、アクセス可能なソースによって異なります。

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