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をポーリングして、正規化された文字起こしレコードを送信したソースと照合します。
- 解決可能な公開TikTok動画URLを1つ以上用意し、必要に応じて en のような2文字の言語コードを用意します。
- urls と任意の language を /v1/tiktok/video-transcript に POST し、返された task_id を保存します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。成功した場合でも、レコード数が送信したURL数より少ないことがあります。
- 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 trueTikTok Video Transcript API の主なユースケース
- 発話内容を検索できるアーカイブ: 文字起こしテキストをソースURL、言語、形式、ショートコード、取得日時とともにインデックス化し、選定した公開動画を発話中の語句で検索できるようにします。
- キーワードとトピックの分析: 既知の動画群の正規化テキストを分析し、繰り返し現れる単語、フレーズ、テーマを見つけます。確認用にソースリンクも保持します。
- アクセシビリティと引用の確認: 取得できた文字起こしテキストと形式のメタデータを使って読みやすいテキストを用意したり該当箇所を探したりし、リンク先の公開動画と照らし合わせて確認します。
TikTok Video Transcript API 活用のヒント
- リクエストはTikTokのホストや /video/{id} パスを強制せず空でないURL文字列を受け付けるため、送信前にすべての対象が意図した公開TikTok動画に解決されることを確認してください。
- 空白除去と重複排除は送信された文字列が完全に一致する場合にしか統合されないため、まとめて送信する前にURLを正規化し、トラッキング用のバリエーションを取り除いてください。
- 言語を指定する場合は en のような2文字のコードを使用し、指定が反映されたと想定するのではなく、返された language フィールドに基づいて後続の処理を振り分けてください。
- 成功後は返された url の値を送信したリストと照合し、利用不可、非公開、削除済み、制限付き、字幕なし、発話なしの動画もワークフロー上で把握できるようにしてください。
- format に応じて解析処理を分岐し、WebVTTのキューがある場合は保持してください。created_at には動画の公開日時が含まれないため、データの来歴には collected_at を使用してください。
関連API
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 Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API