TikTok Video Downloader API

公開TikTok動画URLを認証付きPOSTで送信し、直接再生URLと永続ストレージURLをJSONで取得します。

単一のPOSTエンドポイント
永続ストレージURL
TTLを選択可能
標準化されたJSON
予測可能なエラー処理
5言語のリクエスト例

リクエスト例

curl -X POST "https://api.agentbody.io/v1/tiktok/video/download" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"ttl":"1d","url":"YOUR_URL"}'

レスポンス例

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

Downloaded TikTok media links with persistent storage.

{
  "expires_at": "2026-01-08T00:00:00Z",
  "file_size_mb": 15.2,
  "play_url": "https://example.com/play.mp4",
  "storage_url": "https://example.com/storage/video.mp4",
  "ttl": "1w",
  "video_id": "7050551461734042926"
}

機能特徴

TikTok Video Downloader APIで公開動画を取得・保持し、ブラウザ自動化、ストレージへのアップロード、期限切れURL処理の保守を減らせます。

単一のPOSTエンドポイント

POST /v1/tiktok/video/download にBearer API Key、公開TikTok URL 1件、任意のTTLを送ります。処理は個別に課金され、冪等性キーに対応します。

永続ストレージURL

成功時はstorage_urlとplay_urlを返します。アプリは長期保持と即時再生を明確に使い分けられます。

TTLを選択可能

ttlは1d、3d、1w、1m、1y、5yから選択できます。省略時は契約上のデフォルトが使われ、保存・コンプライアンス要件に合わせて選べます。

標準化されたJSON

video_id、play_url、storage_url、ttlと、利用可能な場合はfile_size_mb、expires_atを返します。上流固有フィールドや認証情報は公開しません。

予測可能なエラー処理

400はリクエスト、401はキー、402は残高を修正します。502、503、504の一時エラーはバックオフ付きで再試行できます。

5言語のリクエスト例

OpenAPIからcurl、JavaScript、Python、Java、Goの例を生成し、POST本文と認証ヘッダーを確認できます。

使い方

API Keyを作成し、公開TikTok URL 1件と保存期間を送信し、バックエンドで返されたメディアURLを処理します。

API Keyを作成

AgentBodyのAPI Keyをサーバー環境または承認済みシークレットストアに保存します。ブラウザコードへ組み込まないでください。

公開動画を選択

公開TikTok動画のURLをコピーします。非公開、削除済み、制限中、利用不能な動画は処理できず、TikTokアカウント情報も受け付けません。

POST本文を構築

必須JSONフィールドurlを送ります。特定の保持期間が必要な場合のみttlを追加し、ページの契約例にある値を使用します。

冪等性キーを追加

論理的なダウンロードごとに一意のIdempotency-Keyを付けます。同一リクエストの不確定な失敗を安全に再試行する場合のみ同じキーを使います。

JSONを解析

保持ファイルにはstorage_url、即時アクセスにはplay_urlを使います。video_id、ttl、file_size_mb、expires_atは必要な場合のみ保存します。

失敗を処理

400、401、402は条件を修正してから再試行します。上流エラーやタイムアウトには回数制限付き指数バックオフを使います。

よくある質問

TikTok Video Downloader APIとは？

POST /v1/tiktok/video/downloadとして提供され、公開TikTok動画URL 1件を受け取り、直接再生URLと永続ストレージURLをJSONで返す認証付きAPIです。

リクエスト本文には何が必要ですか？

公開動画URLを入れるurlが必須です。任意のttlは1d、3d、1w、1m、1y、5yを指定できます。

成功レスポンスの項目は？

video_id、play_url、storage_url、ttlを含み、利用可能ならfile_size_mbとexpires_atも含みます。

一括ダウンロードに対応しますか？

配列による一括入力は公開していません。URLごとに1回呼び出し、アプリ側で並列数、間隔、再試行、冪等性を管理してください。

失敗時の再試行方法は？

400、401、402はリクエスト、キー、残高を修正します。502、503、504はバックオフ付きで再試行し、同一の論理リクエストだけ同じ冪等性キーを使います。

ウォーターマークなしを保証しますか？

保証しません。APIはメディアを取得しますが、独自のウォーターマーク除去や再エンコードは約束しません。TikTok規約と制作者の権利を守ってください。