AgentBodyAgentBody
ログイン

Douyin 動画ダウンロード API

1回の POST で公開 Douyin 動画を MP4 としてダウンロード。レスポンスは永久的なダウンロード URL と動画メタデータ・エンゲージメント統計を返します。

  • 1回の POST、1つの MP4
  • 永久的なダウンロード URL
  • すべてのリンク形式
  • エンゲージメント統計付属
  • 冪等キーサポート
  • サーバーサイドキー必須
ツール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.video_download 操作は1つの公開 Douyin 動画を MP4 ファイルとして保存します。サーバーが API キーを保持；エンドポイントは1回の呼び出しで永久的なダウンロード URL を返します。

1回の POST、1つの MP4

POST /v1/douyin/video/download に公開 Douyin 共有 URL を送信します。成功した 200 は動画タイトル、作成者、エンゲージメント統計、永久的なダウンロード URL を返します。

永久的なダウンロード URL

URL は期限切れの CDN リダイレクトではなく、完全に保存されたファイルを指しています。どのサーバー、どの IP、いつでもダウンロード可能です。

すべてのリンク形式

アプリ共有リンクとウェブプレーヤー URL はすべて同じ動画に解決されます。非公開、削除済み、制限された動画は構造化されたエラーを返し、課金されません。

エンゲージメント統計付属

レスポンスはメディア URL とともに動画のエンゲージメント数を運ぶため、リサーチパイプラインは2回ではなく1回の呼び出しでメディアとメトリクスを取得できます。

冪等キーサポート

Idempotency-Key ヘッダーを渡すと、ネットワーク再試行が2回目のダウンロードや課金をトリガーしません。ゲートウェイはキーで重複を排除します。

サーバーサイドキー必須

エンドポイントはサーバーが保持する AgentBody API キーが必要です。バックエンド経由で呼び出しをルーティングし、キーをクライアントバンドルに出荷しないでください。

使い方

3ステップで API に Douyin 動画ダウンロードを統合。

01

API キーを取得

無料 AgentBody アカウントを作成し、ダッシュボードから API キーを生成します。

02

共有リンクを POST

/v1/douyin/video/download に POST リクエストと公開 Douyin 共有 URL を送信します。安全な再試行のために Idempotency-Key ヘッダーを含めます。

03

ダウンロードリンクを受信

200 は永久的な MP4 URL とタイトル、作成者、エンゲージメント統計を返します。直接ダウンロードするか、ストレージパイプラインに渡します。

よくある質問

Douyin 動画ダウンロード API はどのように動作しますか？

/v1/douyin/video/download に POST リクエストと公開 Douyin 共有 URL を送信します。API は動画を MP4 ファイルとして保存し、タイトル、作成者、エンゲージメント統計付きの永久的なダウンロード URL を返します。

どのリンク形式がサポートされていますか？

アプリ共有リンクとウェブプレーヤー URL の両方が動作します。API はすべての一般的な Douyin リンク形式を解決します；非公開、削除済み、制限された動画はエラーを返し、課金されません。

レスポンスには何が含まれますか？

動画のタイトルと作成者、エンゲージメント統計、および永久的な MP4 ダウンロード URL——1つのレスポンスでメディアとメトリクスの両方。

ダウンロード URL は期限切れになりますか？

いいえ。URL は一時的な CDN リダイレクトではなく完全に保存されたファイルを指しているため、呼び出し後はどのサーバーからでもいつでも機能します。

課金はどのように行われますか？

各成功したダウンロードは、ゲートウェイ管理価格で AgentBody 残高から固定金額を消費します。失敗は課金されません；再試行時の重複課金を避けるために Idempotency-Key ヘッダーを使用してください。

長さの制限はありますか？

非常に長い動画は、毎回のダウンロードを予測可能な固定価格に保つ上流のコストガードによって拒否される場合があります。一般的なクリップは問題なく処理されます。