参数名	类型	必填	说明	示例
key	string	是	接口调用密钥
url	string	是	分享链接	http://v.douyin.com/6SoNdw8dl_Q/

抖音解析

接口说明

本接口提供无水印的抖音视频与图集解析功能，支持获取原画直链及图片资源。适用于需要集成抖音内容解析能力的开发者与应用程序用户。

调用地址

https://api.vsaa.cn/api/parser/douyin/index.php

请求方式

支持 GET 和 POST 两种请求方法。调用时需将参数附加在请求 URL 的查询字符串中（GET）或请求体中（POST）。

鉴权说明

本接口必须携带密钥才能调用。请在请求中添加 Query 参数 key，其值为您的专属接口调用密钥。例如：?key=您的密钥。未提供有效密钥或密钥错误时，接口将拒绝处理请求。

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥，需通过 Query 参数传递。
url	string	是	抖音分享链接，支持视频及图集链接。示例：`http://v.douyin.com/6SoNdw8dl_Q/`

参数补充说明

传递方式：所有参数均通过 URL Query String 方式附加在请求地址末尾。
url 取值：
- 支持标准抖音分享短链接（如 v.douyin.com 域名）。
- 支持包含 iesdouyin.com 域名的完整链接。
- 系统会自动识别链接类型，无需额外指定是视频还是图集。
频率限制：单个密钥每分钟调用上限约为 60 次，超过限制可能返回繁忙或限流错误。

成功响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "aweme_id": "7684870416817466018",
    "type": "note",
    "desc": "示例文案内容",
    "author": {
      "uid": "1",
      "nickname": "示例作者",
      "signature": "示例签名",
      "avatar": "https://example.com/avatar.jpg"
    },
    "create_time": 1757713326,
    "statistics": {
      "digg_count": 404758,
      "comment_count": 1980,
      "share_count": 64128,
      "play_count": 0,
      "collect_count": 0
    },
    "images": [
      {
        "index": 1,
        "uri": "tos-cn-i-0813c001/xxx",
        "width": 2160,
        "height": 3840,
        "url": "https://example.com/image_high_quality.webp",
        "url_webp": "https://example.com/image_light.webp",
        "watermark_url": "https://example.com/image_watermark.webp"
      }
    ]
  }
}

响应字段说明

字段路径	类型	说明
`code`	integer	状态码。0 表示请求成功。
`msg`	string	状态描述信息，成功时为 "ok"。
`data`	object	解析结果数据主体。
`data.aweme_id`	string	作品唯一标识 ID。
`data.type`	string	媒体类型。`note` 表示图集，`video` 表示视频。
`data.desc`	string	视频或图集的文案描述。
`data.author`	object	作者信息对象。
`data.author.uid`	string	作者用户 ID。
`data.author.nickname`	string	作者昵称。
`data.author.signature`	string	作者个性签名。
`data.author.avatar`	string	作者头像 URL。
`data.create_time`	integer	作品创建时间戳（Unix 时间）。
`data.statistics`	object	统计信息对象。
`data.statistics.digg_count`	integer	点赞数量。
`data.statistics.comment_count`	integer	评论数量。
`data.statistics.share_count`	integer	分享数量。
`data.statistics.play_count`	integer	播放数量。
`data.statistics.collect_count`	integer	收藏数量。
`data.images`	array	图集媒体数组，仅当 `type` 为 `note` 时存在。
`data.images[].index`	integer	图片序号。
`data.images[].uri`	string	图片原始 URI 标识。
`data.images[].width`	integer	图片宽度（像素）。
`data.images[].height`	integer	图片高度（像素）。
`data.images[].url`	string	最高画质无水印原图直链。
`data.images[].url_webp`	string	轻量级 WebP 格式图片直链。
`data.images[].watermark_url`	string	带水印版本图片直链。
`data.video`	object	视频媒体对象，仅当 `type` 为 `video` 时存在。
`data.video.url`	string	视频地址（可能包含水印）。
`data.video.play_url`	string	最高画质无水印视频地址，推荐用于播放。
`data.video.download_url`	string	官方下载地址。
`data.video.origin_url`	string	原画直链地址。
`data.video.quality`	string	画质标识。
`data.video.width`	integer	视频宽度（像素），0 表示未知。
`data.video.height`	integer	视频高度（像素），0 表示未知。
`data.video.ratio`	string	视频宽高比。
`data.video.duration`	integer	视频时长（毫秒）。
`data.video.music`	object	背景音乐信息。
`data.video.music.id`	string	音乐 ID。
`data.video.music.title`	string	音乐标题。
`data.video.music.author`	string	音乐作者。
`data.video.music.duration`	integer	音乐时长（毫秒）。

错误响应示例

当接口调用出现业务逻辑错误、鉴权失败或系统异常时，API 将返回统一的 JSON 结构。成功时 code 为 0，出错时 code 保持 0 或特定值（视具体网关实现，但本站标准错误结构如下），关键状态指示在 errcode 字段中。

{
  "code": 0,
  "msg": "密钥错误",
  "errcode": 11002
}

字段说明：

code: 固定为 0，表示接口响应结构正常，非 HTTP 状态码。
msg: 人类可读的错误描述信息。
errcode: 业务错误码，用于程序化识别具体错误类型。

业务错误码说明

下表列出了抖音解析接口可能返回的所有业务错误码及其含义。客户端应根据 errcode 进行针对性的错误处理。

errcode	含义说明
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	***地址无效
11015	***地址不允许
11016	***请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前IP不在白名单内
11020	启用出口代理须提供有效密钥
11021	未配置可用出口代理
11022	出口代理不可用
11023	密钥已过期
11024	令牌分配积分不足

常见错误场景示例：

密钥缺失或错误

{
 "code": 0,
 "msg": "密钥错误",
 "errcode": 11002
}

频率限制触发
当每分钟请求次数超过 60 次时，可能返回：
```
{
 "code": 0,
 "msg": "请求过于频繁",
 "errcode": 11005
}
```
积分不足
对于收费接口，若账户余额无法扣除本次调用费用：
```
{
 "code": 0,
 "msg": "积分余额不足",
 "errcode": 11004
}
```

解析失败
当第三方返回异常或链接失效时：

{
 "code": 0,
 "msg": "***请求失败",
 "errcode": 11016
}

调用示例

终端 curl（bash）

curl -X GET "https://api.vsaa.cn/api/parser/douyin/index.php?key=YOUR_KEY&url=http://v.douyin.com/6SoNdw8dl_Q/"

PHP

$key = 'YOUR_KEY';
$url = 'http://v.douyin.com/6SoNdw8dl_Q/';
$apiUrl = "https://api.vsaa.cn/api/parser/douyin/index.php?key=" . urlencode($key) . "&url=" . urlencode($url);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Accept: application/json"]);

$response = curl_exec($ch);
$err = curl_error($ch);
curl_close($ch);

if ($err) {
    die("cURL Error: " . $err);
}

$data = json_decode($response, true);
if ($data['code'] === 0) {
    print_r($data['data']);
} else {
    echo "Error: " . $data['msg'];
}

注意事项

密钥安全：key 参数必须通过 Query 字符串传递。严禁将密钥硬编码在前端代码、移动端 App 或任何可被公开访问的客户端中，以防止密钥泄露导致额度被盗用或资金损失。
频率限制：本接口实行速率限制，每分钟调用次数上限约为 60 次。若业务需要高频请求，请在客户端实现队列机制或令牌桶算法进行节流，避免因触发限流导致请求失败或服务降级。
HTTPS 强制：所有请求必须通过 https:// 协议发起，以确保传输层加密安全。禁止使用 http:// 发起请求。
参数有效性：url 参数需为有效的抖音分享链接（如 http://v.douyin.com/...）。若链接失效、非抖音域名或内容已下架，接口将返回非 0 的 code 错误码，请根据 msg 字段进行容错处理。
数据时效性：返回的视频/图集资源链接（如 play_url、url）具有时效性，建议在获取后立即发起下载请求，不要长期缓存直接下载链接。若链接过期，需重新调用接口获取最新有效地址。

免责声明

欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。

1. 本平台仅提供**技术接口与数据聚合服务**，不存储、不生产、不拥有任何原始数据内容。 2. 本平台所返回的数据均来源于公开网络或第三方接口，仅作**技术学习、研究与交流**之用。 3. 本平台不保证任何接口的**持续可用性、准确性、完整性或及时性**，接口可能因第三方原因随时变更、中断或停止。 1. 使用者应遵守中华人民共和国相关法律法规，以及其所在地的所有适用法律。 2. **禁止**将本平台接口用于任何违法违规用途，包括但不限于： - 侵犯他人知识产权、隐私权或其他合法权益； - 从事网络攻击、数据爬取滥用、恶意刷量等行为； - 传播违法、有害、虚假或不良信息； - 用于任何商业转售、二次分发而未获授权的情形。 3. 使用者应自行承担因使用本平台服务而产生的一切后果与法律责任。 1. 本平台**不收集、不存储**使用者的个人敏感信息。 2. 使用者通过接口提交的查询参数，仅用于当次请求处理，不做持久化留存。 3. 若接口涉及第三方数据，其版权与解释权归原数据方所有，本平台不承担相关争议责任。 1. 本平台以**“现状”**和**“现有”**为基础提供服务，不对服务作出任何明示或暗示的担保。 2. 因使用或无法使用本平台服务而导致的任何**直接、间接、偶然或必然损失**，本平台及其运营者均不承担任何责任。 3. 因不可抗力、网络故障、第三方服务中断、政策调整等原因导致的服务异常，本平台不承担责任。 1. 本平台的接口设计、文档、代码及相关标识，其知识产权归本平台所有。 2. 未经书面许可，任何单位或个人不得复制、修改、传播或用于商业用途。 1. 本平台有权随时修改本免责声明，修改后的内容将在本页面公布，不再另行通知。 2. 使用者应定期查阅本声明，继续使用即视为接受变更后的条款。 1. 本声明的最终解释权归 **万象数据API** 所有。 2. 如您不同意本声明的任何内容，请立即停止使用本平台服务。 3. 如因本声明产生争议，双方应友好协商解决；协商不成的，可提交本平台运营者所在地有管辖权的人民法院裁决。

最后更新日期：2026年10月6日

抖音解析

接口信息

请求参数

返回示例

详细文档

抖音解析

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

懒懒听书