抖音短视频无水印解析API文档

抖音（Douyin）是全球领先的短视频平台，其分享链接蕴含丰富的视频元数据，如标题、作者、封面、视频URL等，广泛应用于内容聚合、数据分析和媒体播放场景。开发者需要一款简单高效的工具来解析这些链接，提取结构化信息。抖音短视频解析API，通过输入抖音视频分享链接，开发者即可获取详细的抖音无水印的视频及元数据，包括作者信息、视频标题、封面、点赞数、发布时间等。该API设计轻量，响应快速，兼容多种编程语言和平台。

API地址：https://short-video.joyb.cc/api/douyin.php

核心功能：

• 全面解析：提取视频标题、作者、封面、视频URL、点赞数等丰富信息。
• 易于集成：GET请求接口，响应数据结构清晰，适合Web、移动端和后端开发。
• 高性能：优化服务确保低延迟和高可用性。
• 多场景适用：支持短视频聚合、社交媒体工具、内容分析等应用。

无论你是开发短视频播放器、社交媒体分析工具，还是进行用户行为研究，抖音短视频解析API都能为你提供强大支持。以下是详细的使用教程和开发文档，助你快速上手！

---

使用教程：如何调用抖音短视频解析API

1. 获取抖音视频分享链接

在抖音App中，找到目标视频，点击分享按钮，复制分享链接，选择其中的分享链接https://v.douyin.com/mqgYyZTjTfY/部分。例如：

7.41 jCU:/ 03/09 K@W.mD 我们不会再见面了，这就是分别的意义  https://v.douyin.com/mqgYyZTjTfY/ 复制此链接，打开Dou音搜索，直接观看视频！

2. 构造API请求

API使用GET方法，请求格式如下：

https://short-video.joyb.cc/api/douyin.php?url={分享链接}

分享链接需进行URL编码，确保特殊字符正确处理。例如：

https://short-video.joyb.cc/api/douyin.php?url=https%3A%2F%2Fv.douyin.com%2FmqgYyZTjTfY%2F

3. 发送请求并处理响应

你可以通过浏览器、Postman、cURL或编程语言发送请求。API返回JSON格式的数据，包含视频元数据。以下是实际响应示例：

{
    "code": 200,
    "msg": "解析成功",
    "data": {
        "author": "咸鱼.",
        "uid": 36730981451,
        "avatar": "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_de91c3493daaad63841bfe1c9db46a8e.jpeg?from=327834062",
        "like": 44097,
        "time": 1746850885,
        "title": "我们不会再见面了，这就是分别的意义",
        "cover": "https://p3-sign.douyinpic.com/tos-cn-i-0813c001/ooqAAHoQ9bgDUCGogoDetfEUFAA9AAH0hA9HAI~tplv-dy-resize-walign-adapt-aq:720:q75.webp?lk3s=138a59ce&x-expires=1748116800&x-signature=UYShbnC9cYOeOh42iZJI5ppPAUM%3D&from=327834062&s=PackSourceEnum_DOUYIN_REFLOW&se=false&sc=cover&biz_tag=aweme_video&l=2025051104091178070B26FF08AF666E7B",
        "url": "https://aweme.snssdk.com/aweme/v1/play/?video_id=v0300fg10000d0fd3ffog65jm9dsqcqg&ratio=720p&line=0",
        "music": {
            "author": "痛定思痛.",
            "avatar": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_8e8d7abe338b888149813368ba391612.jpeg?from=327834062"
        }
    }
}

字段说明：

• code：状态码，200表示成功。
• msg：状态信息，如“解析成功”。
• data：视频元数据。
  • author：视频作者昵称。
  • uid：作者唯一ID。
  • avatar：作者头像URL（100×100像素）。
  • like：视频点赞数。
  • time：视频发布时间（Unix时间戳，秒）。
  • title：视频描述或标题。
  • cover：视频封面图片URL（720p质量）。
  • url：视频播放URL（720p，支持直接播放）。
  • music：背景音乐信息。
    • author：音乐作者昵称。
    • avatar：音乐作者头像URL（1080×1080像素）。

4. 示例代码

以下是几种编程语言调用API的示例代码，展示如何解析响应数据：

import requests
import urllib.parse
from datetime import datetime

# 分享链接
share_url = "https://v.douyin.com/mqgYyZTjTfY/"
# URL编码
encoded_url = urllib.parse.quote(share_url)
# 构造API请求
api_url = f"https://short-video.joyb.cc/api/douyin.php?url={encoded_url}"

# 发送请求
try:
    response = requests.get(api_url, timeout=5)
    response.raise_for_status()  # 检查HTTP状态
    data = response.json()
    if data["code"] == 200:
        print("视频标题:", data["data"]["title"])
        print("作者:", data["data"]["author"])
        print("视频URL:", data["data"]["url"])
        print("点赞数:", data["data"]["like"])
        print("发布时间:", datetime.fromtimestamp(data["data"]["time"]).strftime("%Y-%m-%d %H:%M:%S"))
        print("背景音乐作者:", data["data"]["music"]["author"])
    else:
        print("解析失败:", data["msg"])
except requests.RequestException as e:
    print("请求失败:", str(e))

const axios = require('axios');
const encodeUrl = require('encodeurl');

const shareUrl = "https://v.douyin.com/mqgYyZTjTfY/";
const encodedUrl = encodeUrl(shareUrl);
const apiUrl = `https://short-video.joyb.cc/api/douyin.php?url=${encodedUrl}`;

axios.get(apiUrl)
  .then(response => {
    if (response.data.code === 200) {
      console.log("视频标题:", response.data.data.title);
      console.log("作者:", response.data.data.author);
      console.log("视频URL:", response.data.data.url);
      console.log("点赞数:", response.data.data.like);
      console.log("背景音乐作者:", response.data.data.music.author);
    } else {
      console.log("解析失败:", response.data.msg);
    }
  })
  .catch(error => {
    console.error("请求失败:", error.message);
  });

curl "https://short-video.joyb.cc/api/douyin.php?url=https%3A%2F%2Fv.douyin.com%2FmqgYyZTjTfY%2F"

5. 错误处理

API可能返回以下错误（基于响应和常见API行为）：

• code: 400：分享链接格式错误，请检查URL是否正确。
• code: 404：视频资源不存在，可能链接已失效或视频被删除。
• code: 500：服务器内部错误，请稍后重试。

建议在代码中检查code字段和HTTP状态码，确保程序鲁棒性。

---

开发文档：抖音短视频解析API

API概述

• 端点：https://short-video.joyb.cc/api/douyin.php
• 方法：GET
• 参数：
  • url（必填）：抖音视频分享链接，需URL编码。
• 响应格式：JSON
• 限速：暂无明确限速，建议每秒不超过5次请求。

请求示例

GET https://short-video.joyb.cc/api/douyin.php?url=https%3A%2F%2Fv.douyin.com%2FmqgYyZTjTfY%2F

响应字段

字段	类型	描述
code	int	状态码，200表示成功
msg	string	状态信息，如“解析成功”
data	object	视频元数据
data.author	string	视频作者昵称
data.uid	int	作者唯一ID
data.avatar	string	作者头像URL（100×100像素）
data.like	int	视频点赞数
data.time	int	视频发布时间（Unix时间戳，秒）
data.title	string	视频描述或标题
data.cover	string	视频封面图片URL（720p）
data.url	string	视频播放URL（720p）
data.music	object	背景音乐信息
data.music.author	string	音乐作者昵称
data.music.avatar	string	音乐作者头像URL（1080×1080像素）

错误码

错误码	描述
200	解析成功
400	分享链接格式错误
404	视频资源不存在
500	服务器内部错误

集成注意事项

1. URL编码：分享链接必须URL编码，避免特殊字符导致请求失败。
2. 视频URL有效期：url字段的视频URL可能有时间限制，建议解析后尽快使用。
3. 版权合规：使用解析数据时，需遵守抖音的版权和内容使用政策，仅限合法用途。
4. 时间戳处理：time字段为Unix时间戳，需转换为本地时间（如代码示例中的Python实现）。
5. 请求超时：建议设置5秒超时，处理网络不稳定情况。
6. 频率控制：避免高频请求，保持合理调用频率（建议每秒不超过5次）。
7. 音乐信息扩展：当前music字段仅包含作者和头像，未来可能增加音乐标题或URL，建议关注文档更新。

常见问题

Q：API是否需要认证？
A：当前无需认证，直接调用即可。

Q：视频URL可以直接下载吗？
A：可以，但需注意URL可能有有效期，建议及时使用。

Q：支持解析其他平台视频吗？
A：当前仅支持抖音视频分享链接。

Q：如何处理时间戳？
A：time字段为Unix时间戳（秒），可使用编程语言的日期函数转换为可读格式（如Python的datetime.fromtimestamp）。