AgentBodyAgentBody
ログイン

Douyin 動画ダウンロード API

認証付き POST 1 回で公開 Douyin 動画 URL を保存済み MP4 に——直接動画リンクと正規化メタデータ（タイトル、投稿者、エンゲージメント）をきれいな JSON で。

  • 単一 REST エンドポイント
  • すべてのリンク形式
  • 正規化メタデータ
  • エンゲージメント内蔵
  • 冪等な課金書き込み
  • 予測可能なエラーコード
ツールAPIAgent

リクエスト例

API ドキュメントを見る 完全な API リファレンス 
curl -X POST "https://api.agentbody.io/v1/douyin/video/download" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"url":"YOUR_URL"}'

レスポンス例

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

Downloaded Douyin media link and normalized public video metadata.

{
  "author_name": "盗月社食遇记",
  "collect_count": 855021,
  "comment_count": 162235,
  "digg_count": 4037193,
  "duration_seconds": 1082.5,
  "id": "7577614489533680959",
  "share_count": 5135670,
  "text": "这个贵州五线小城市…",
  "title": "贵州美食探店",
  "url": "https://www.douyin.com/video/7577614489533680959",
  "video_content_type": "video/mp4",
  "video_size_bytes": 215476832,
  "video_url": "https://api.apify.com/v2/key-value-stores/example/records/7577614489533680959.mp4"
}

機能特徴

Douyin 動画ダウンロード API をコンテンツ保存、越境調査パイプライン、メディア業務に使う——URL を入れ、MP4 リンクと統計を得る。

単一 REST エンドポイント

bearer API キーと公開動画 URL を付けて POST /v1/douyin/video/download を呼びます。API は MP4 を保存し直接動画リンクを返します。署名リバースエンジニアリングもデバイスファームもスクレイピング基盤も不要です。

すべてのリンク形式

url フィールドは douyin.com 動画 URL、iesdouyin 共有リンク、v.douyin.com 短縮リンク、裸の数字動画 ID を受け付けます。統合側でユーザーが貼るものすべてが解決し、正規化ステップが 1 つ減ります。

正規化メタデータ

毎回のレスポンスは video_url に id、title、text、author_name、再生時間、コンテンツタイプ、ファイルサイズを組み合わせます。リクエストごとのパースなしで保存できる安定フィールドです。

エンゲージメント内蔵

レスポンスはファイルリンクに加えて digg_count、comment_count、share_count、collect_count を運びます。同じリクエストで動画とそのパフォーマンススナップショットを保存できます。

冪等な課金書き込み

動画保存は従量課金の操作です。再試行時に Idempotency-Key ヘッダーを送ると、中断されたレスポンスが同じ動画の二重課金になりません。同一キーの同一リクエストは元の結果を返します。

予測可能なエラーコード

ドキュメント化されたステータスコードで失敗を処理します。400 は無効なリクエスト、401 はキーの不足または誤り、409 は冪等性の競合、502/503/504 は一時的な上流の問題。各クラスは明確な修正または再試行アクションに対応します。

使い方

次のステップで Douyin 動画ダウンロード API を呼び出します。キーを作成し、POST リクエストを構築し、返された MP4 リンクを処理します。

01

API キーを作成

AgentBody アカウントを作成し、コンソールで API キーを生成します。キーはサーバー環境または承認されたシークレットストアに保管し bearer トークンとして送信します。

02

リクエストを構築

必須の url——douyin.com リンク、iesdouyin 共有リンク、v.douyin.com 短縮リンク、または数字動画 ID——を付けて /v1/douyin/video/download に POST を送信します。生成例は 5 つの言語での正確なリクエストを示します。

03

冪等キーを追加

再試行する可能性のあるすべてのダウンロードに Idempotency-Key ヘッダーを付けます。タイムアウト、接続切断、ワーカー再起動。同一キーの同一リクエストは元のレスポンスを返し、再課金しません。

04

キーはサーバー側に

バックエンド、サーバーレス関数、定期ジョブからエンドポイントを呼びます。エンドユーザーがダウンロードをトリガーする場合は独自エンドポイントでプロキシしてください。

05

JSON レスポンスをパース

返された video_url、id、title、author_name、再生時間、サイズ、エンゲージメントカウントを読み取ります。リンクとメタデータを一緒に保存するか、URL をそのままストレージ層に渡します。

06

エラーを正しく処理

400 はリクエストを修正し、401 は有効なキーを設定し、409 はドキュメント化された冪等キーの動作に従います。502/503/504 は同じキーの下でバックオフ付きで再試行します。

よくある質問

Douyin 動画ダウンロード API とは何ですか？

認証付き POST エンドポイント /v1/douyin/video/download です。公開 Douyin 動画 1 本を MP4 として保存し、直接動画リンクと正規化メタデータ——id、タイトル、投稿者、再生時間、ファイルサイズ、エンゲージメント数——を構造化 JSON で返します。

Douyin ダウンロード API の料金はどうなっていますか？

各動画保存はアカウントのクレジットで実行される従量課金の操作です。価格はこのページの固定数値ではなくゲートウェイが管理します。コンソールで現在の費用を確認し、冪等キーで再試行の二重課金を防いでください。

Douyin API はどの URL 形式を受け付けますか？

url フィールドは douyin.com 動画 URL、iesdouyin 共有リンク、v.douyin.com 短縮リンク、裸の数字動画 ID を受け付けます。ユーザーが貼るものすべてが同じリクエスト構造で解決します。

非公開の Douyin 動画をダウンロードできますか？

いいえ。エンドポイントは公開動画のみを読み取ります。非公開、友達限定、削除済みの動画は解決せず、制限を回避するための Douyin 認証情報も要求されません。

動画リンクにはどんなメタデータが付きますか？

id、url、title、text、author_name、duration_seconds、video_content_type、video_size_bytes、および digg、コメント、シェア、コレクトの各カウント。動画とそのパフォーマンススナップショットを一緒に保存するのに十分です。

API エラーの処理方法は？

400 はリクエストボディを修正し、401 は bearer キーを修正し、409 はドキュメント化された冪等キーの動作に従います。502、503、504 は一時的な上流の障害として、同じキーの下でバックオフ付きで再試行してください。