抖音主页解析接口 请不要频繁请求 如果不理解参数 请查看请求示例 解析下载 因为系统路由问题 出现了点问题 可以对照键注释 自行通过直链下载
| 参数名 | 类型 | 描述 | 可选值 | 默认值 |
|---|---|---|---|---|
xz |
string | 是否生成 TXT 下载文件 | 0：否/1：是 |
|
msg |
string | 抖音分享短链或完整用户URL | - | https://v.douyin.com/xxxxxx |
uid |
string | 用户 sec_uid（与 msg 二选一） | - | MS4wLjABAAAA... |
proxy |
string | 代理播放视频（内部参数） | - | - |
download |
string | 下载文件（内部参数） | - | - |
quantity |
integer | 抓取作品数量 | 18 |
/s/TiktokIndex?msg=https://v.douyin.com/KPiFtZs3ntI/ 1@3.com :8pm&quantity=1{
"code": 200, // 业务状态码（200=成功）
"msg": "success", // 业务状态描述
"data": [ // 作品列表
{
"code": 200, // 单条作品状态码
"index": 1, // 本次分页中的序号（从1开始）
"aweme_id": "7594646016449681834", // 抖音作品ID
"desc": "来三角洲逆转未来#逆战未来...", // 作品文字描述
"create_time": "2026-01-13 01:05:25", // 发布时间（北京时间）
"share_url": "https://www.douyin.com/video/7594646016449681834", // 官方分享链接
"author": "绾绾samr", // 作者昵称
"author_uid": "4186553560878542", // 作者uid
"author_sec_uid": "MS4wLjABAAAAsz77v4LU3w3b7SvsnRiUANUf_zMoa6kfyVl9NbaLhMTdoMd49JtG7qAx0SPtDYiF", // 作者sec_uid
"type": "video", // 作品类型：video 或 image
"cover": "https://p3-pc-sign.douyinpic.com/...", // 封面图原始URL
"cover_proxy": "https://localhost/s/TiktokIndex?proxy=1&...", // 本地代理封面地址
"video": "https://v5-dy-o-abtest.zjcdn.com/...", // 视频原始播放地址
"video_proxy": "https://localhost/s/TiktokIndex?proxy=1&...", // 本地代理视频流
"download_url": "https://localhost/s/TiktokIndex?download=1&...", // 直链下载地址（MP4）
"duration": 15.906, // 视频时长（秒）
"music_title": "@绾绾samr创作的原声", // 配乐标题
"music_author": "绾绾samr", // 配乐作者
"music_url": "https://sf5-hl-cdn-tos.douyinstatic.com/...", // 配乐原始URL
"music_proxy": "https://localhost/s/TiktokIndex?proxy=1&...", // 本地代理配乐
"music_download": "https://localhost/s/TiktokIndex?download=1&...", // 配乐下载地址（MP3）
"digg_count": 64791, // 点赞数
"comment_count": 225, // 评论数
"share_count": 850, // 分享数
"collect_count": 5725, // 收藏数
"play_count": 0, // 播放数（官方接口常返回0）
"hashtags": [ // 作品内解析出的话题标签
"逆战未来",
"逆战未来正式上线",
"琳琅姐妹花",
"三角洲行动",
"洲妹行动"
]
}
],
"pagination": { // 分页信息
"requested": 1, // 用户请求的作品数量
"fetched": 1, // 实际返回的作品数量
"total": 4, // 已抓取到的总作品数（可能还有更多）
"pages": 1, // 已翻页数
"has_more": true // 是否还有更多作品
},
"performance": { // 性能指标
"execution_time": "2.45s", // 本次请求耗时
"items_per_second": "0.41" // 平均每秒抓取作品数
},
"endpoints": { // 可用子接口提示
"video_proxy": "?proxy=1&url=视频URL", // 代理播放
"video_download": "?download=1&url=视频URL&filename=文件名", // 下载文件
"data_export": "?xz=1&msg=分享链接或uid=用户ID" // 导出 TXT
}
}| 场景 | HTTP 状态 | 错误码 | 消息 | JSON 结构预览 |
|---|---|---|---|---|
| 缺少必要参数 | 400 |
400 |
缺少必要参数（msg 或 uid） | {
"error": {
"code": 400,
"message": "缺少必要参数（msg 或 uid）",
"msg": {
"desc": "抖音分享链接",
"type": "string",
"default": "https://v.douyin.com/xxxxxx"
},
"uid": {
"desc": "用户 sec_uid",
"type": "string",
"default": "MS4wLjABAAAA..."
},
"quantity": {
"desc": "抓取数量",
"enum": [
1,
1000
],
"type": "integer",
"default": 18
}
}
} |
| quantity 超出范围 | 400 |
400 |
quantity 需在 1-1000 之间 | {
"error": {
"code": 400,
"message": "quantity 需在 1-1000 之间",
"quantity": {
"desc": "抓取数量",
"enum": [
1,
1000
],
"type": "integer",
"default": 18
}
}
} |
| 分享链接解析失败 | 400 |
400 |
分享链接无效，未能提取 sec_uid | {
"error": {
"code": 400,
"message": "分享链接无效，未能提取 sec_uid"
}
} |
| 接口维护中 | 503 |
503 |
接口维护中，请稍后再试 | {
"error": {
"code": 503,
"message": "接口维护中，请稍后再试",
"status": "维护"
}
} |
| 接口已下架 | 410 |
410 |
接口已下架 | {
"error": {
"code": 410,
"message": "接口已下架",
"status": "下架"
}
} |
| 接口状态异常 | 503 |
503 |
接口异常，请联系管理员修复！ | {
"error": {
"code": 503,
"message": "接口异常，请联系管理员修复！",
"status": "异常"
}
} |
| QPS 超限被封禁 | 429 |
429 |
请求频繁，请10秒后重试 | {
"error": {
"code": 429,
"message": "请求频繁，请10秒后重试",
"retry_after": 10
}
} |
| Cookie 失效/抓取为空 | 500 |
500 |
未获取到数据，请检查 Cookie 或用户ID | {
"error": {
"code": 500,
"message": "未获取到数据，请检查 Cookie 或用户ID"
}
} |
| 语录文件为空或缺失 | 500 |
500 |
语录文件为空或缺失 | {
"error": {
"code": 500,
"message": "语录文件为空或缺失"
}
} |
| 服务器内部错误 | 500 |
500 |
服务器内部错误 | {
"error": {
"code": 500,
"message": "服务器内部错误"
}
} |