TikTok Transcript API

認証付き GET リクエスト 1 回で、公開 TikTok 動画の既存字幕トラックを JSON として抽出——全文、言語、タイミング付きセグメントをそのままアプリケーションに。

単一の REST エンドポイント
構造化 JSON 出力
タイミング付き字幕セグメント
言語の指定
転写の前に抽出
明確な利用不可シグナル

リクエスト例

curl "https://api.agentbody.io/v1/tiktok/transcript?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&language=en" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>"

レスポンス例

OpenAPI 仕様に記載されたレスポンス。

Existing captions or explicitly requested audio transcription.

{
  "caption_type": "manual",
  "language": "example_value",
  "segments": [],
  "text": "example_value",
  "video_id": "example_value"
}

機能特徴

TikTok Transcript API を使って公開 TikTok 動画の既存字幕トラックを構造化 JSON として抽出し、調査パイプライン、コンテンツ分析、動画対応製品に活用します。

単一の REST エンドポイント

Bearer API キーと公開 TikTok 動画の URL を付けて GET /v1/tiktok/transcript を呼び出します。TikTok 字幕 API はドキュメント化された HTTP リクエスト 1 回で動画の既存字幕トラックを返すため、ブラウザ駆動スクレイパーや非公式クライアント SDK を維持せずに字幕抽出を追加できます。

構造化 JSON 出力

予測可能な JSON レスポンスで、caption_type、language、video_id、完全な字幕テキスト、タイミング付きセグメントを受け取ります。字幕の保存、テキストの索引化、動画対応検索の構築、字幕データの分析パイプラインへの供給に適した構造です。

タイミング付き字幕セグメント

各セグメントには字幕テキストとタイミング情報が含まれます。検索結果、引用、生成された参照を、TikTok 動画の字幕を構造のないテキストの塊として扱うのではなく、元の公開動画の正確な瞬間に結び付けられます。

言語の指定

オプションの language パラメータに en や zh などの BCP 47 タグを渡すと、希望する字幕言語をリクエストできます。指定しなければソース言語が使われます。API が読み取るのは動画が公開しているトラックのみで、翻訳も利用不可な言語の合成も行いません。

転写の前に抽出

API 契約は明確です。別途課金される音声転写の前に、この既存字幕操作を試してください。字幕抽出は低コストで正直な第一歩であり、転写は意図的にリクエストする別の操作で、黙ってのフォールバックは決してありません。

明確な利用不可シグナル

公開動画に字幕トラックがない場合、API はテキストを捏造せず 422 を返します。それをその URL に対する最終的な利用可否シグナルとして扱い、同じ URL を再試行するのではなく、別のリソースを選ぶか、転写ワークフローの明示的な承認を得てください。

使い方

次の 6 ステップで TikTok Transcript API を呼び出し、公開動画の URL を渡して、タイミング付きセグメントの字幕テキストをアプリケーションで処理します。

API キーを作成

AgentBody アカウントを作成し、コンソールで API キーを生成します。キーはサーバー環境または承認されたシークレットストアに保存し、Bearer トークンとして送信します。本番キーをブラウザコード、公開リポジトリ、クライアント側バンドルに置かないでください。

公開動画を選ぶ

字幕が必要な公開 TikTok 動画を選び、完全な URL をコピーします。動画には公開済みの字幕トラックが必要です。非公開の動画、削除済みの動画、字幕のない動画は、字幕ではなく利用不可シグナルを返します。

GET リクエストを構築

URL クエリパラメータを付けて /v1/tiktok/transcript に認証付き GET リクエストを送信します。このページの生成例は curl、JavaScript、Python、Java、Go でのリクエストを示しているため、サービスが使っている言語と HTTP クライアントにそのまま合わせられます。

字幕言語を選択

希望する字幕言語が必要な場合は、オプションの language パラメータに en や zh などの BCP 47 値を追加します。API が返すのは、送信された動画が実際に公開しているトラックのみです。翻訳の生成も、利用不可な言語トラックの提供も行いません。

JSON レスポンスを解析

返された caption_type、language、video_id、完全なテキスト、セグメントを読み取ります。追跡可能な引用、タイムスタンプ付き検索結果、RAG コンテキストが必要な場合はセグメントのタイミングを保持してください。保存するのは製品に必要なフィールドのみとし、保持期間はプライバシーポリシーに合わせます。

422 を正しく処理

422 はその動画に利用可能な字幕トラックがないことを意味します。これは一時的な障害ではないため、同じ URL をそのまま再試行しないでください。別の公開リソースを選ぶか、その動画に対して別途課金される転写操作を呼び出す前に明示的な承認を得てください。

よくある質問

TikTok Transcript API とは何ですか？

TikTok Transcript API は、認証付き GET エンドポイント /v1/tiktok/transcript で、公開 TikTok 動画から既存の字幕トラックを抽出します。公開動画の URL とオプションの希望言語を送ると、成功時のレスポンスは字幕メタデータ、完全なテキスト、タイミング付きセグメントを JSON で返します。

字幕がない動画でも字幕を生成しますか？

いいえ。このエンドポイントが抽出するのは、動画がすでに公開している字幕トラックのみです。字幕トラックが存在しない場合は、最終シグナルとして 422 を返します。音声転写——実際に音声を聞いてテキストを生成すること——は別途課金される操作であり、明示的にリクエストする必要があり、黙ってのフォールバックは決してありません。

TikTok 字幕スクレイパーとの違いは？

字幕スクレイパーは通常、ブラウザセッションを駆動し、レンダリングされた字幕を解析します。この API は安定した JSON フィールドを返すドキュメント化された REST エンドポイントのため、ブラウザ自動化、プロキシ回転、解析コードの維持は不要です。読み取るのは公開字幕データのみです。

特定の字幕言語をリクエストできますか？

はい。オプションの language パラメータに en や zh などの BCP 47 タグを渡してください。API が返すのは、送信された動画が実際に公開しているトラックのみで、字幕の翻訳も、ソース動画が提供していない言語トラックの作成も行いません。

422 レスポンスは何を意味しますか？

422 はその動画の字幕が利用不可であることを意味します。これは一時的なエラーではなく最終シグナルであり、同じ URL を再試行しても字幕は得られません。別の公開動画を選ぶか、別途課金される転写操作の使用前に明示的な承認を得てください。

他の API エラーはどう処理すればよいですか？

400 はリクエストの形を修正し、401 は有効な Bearer キーを設定してください。一時的な 502、503、504 はバックオフ付きでリトライします。リトライ前にステータスとエラーコードを記録し、パイプラインが利用可否の問題（422）と一時的な上流の障害を区別できるようにしてください。