抖音视频下载 API

通过一次 POST 将公开抖音视频下载为 MP4。响应返回永久下载 URL 和视频元数据及互动数据。

一次 POST，一个 MP4
永久下载 URL
所有链接形式
包含互动数据
幂等键支持
需要服务器端密钥

请求示例

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 操作将一个公开抖音视频保存为 MP4 文件。您的服务器持有 API 密钥；端点在单次调用中返回永久下载 URL。

一次 POST，一个 MP4

发送 POST /v1/douyin/video/download 和任何公开抖音分享 URL。成功的 200 返回视频标题、作者、互动数据和永久下载 URL——管道所需的一切。

永久下载 URL

URL 指向完全保存的文件，而非过期 CDN 跳转。可从任何服务器、任何 IP、任何时间下载——适合队列工作器、媒体服务器和归档。

所有链接形式

App 分享链接和网页播放器 URL 均解析为同一视频。私密、已删除和受限视频返回结构化错误且不计费。

包含互动数据

响应在媒体 URL 之外携带视频互动计数，研究管道一次调用同时获得媒体和指标，无需两次查询。

幂等键支持

传递 Idempotency-Key 头，网络重试不会触发第二次下载或扣费。网关按键去重。

需要服务器端密钥

端点需要服务器持有的 AgentBody API 密钥。通过后端路由调用；绝不将密钥发到客户端。

使用步骤

三步 API 集成抖音视频下载。

获取 API 密钥

创建免费 AgentBody 账户并从仪表板生成 API 密钥。

POST 分享链接

向 /v1/douyin/video/download 发送 POST 请求和公开抖音分享 URL。包含 Idempotency-Key 头以安全重试。

接收下载链接

200 返回永久 MP4 URL 及标题、作者和互动数据。直接下载或交给存储管道。

常见问题

抖音视频下载 API 如何工作？

向 /v1/douyin/video/download 发送 POST 请求和公开抖音分享 URL。API 将视频保存为 MP4 文件，并返回带标题、作者和互动数据的永久下载 URL。

支持哪些链接格式？

App 分享链接和网页播放器 URL 均可。API 解析所有常见抖音链接形式；私密、已删除和受限视频返回错误且不计费。

响应包含什么？

视频标题和作者、互动数据，以及永久 MP4 下载 URL——一次响应同时获得媒体和指标。

下载 URL 会过期吗？

不会。URL 指向完全保存的文件而非临时 CDN 跳转，调用后可从任何服务器随时使用。

如何计费？

每次成功下载按网关管理价格从您的 AgentBody 余额扣除固定金额。失败不计费；使用 Idempotency-Key 头避免重试重复扣费。

有时长限制吗？

超长视频可能被上游成本保护拒绝，以保持每次下载价格可预测。典型片段正常处理。