一个自行实现的抖音分享链接解析与下载脚本。项目不调用其他第三方解析站接口,而是直接读取抖音分享页中的公开 SSR 数据,并基于抖音播放接口构造可下载的视频地址。
- 从抖音分享文案中自动提取短链接。
- 自动跟随
v.douyin.com跳转并提取aweme_id。 - 解析抖音移动分享页
window._ROUTER_DATA。 - 提取标题、作者、作品 ID、封面、统计信息、图集图片。
- 构造
1080p / 720p / 540p等无水印播放地址。 - 可解析最终签名视频地址和文件大小。
- 支持 JSON 输出、批量解析、下载视频、下载封面、下载图集。
- 仅依赖 Python 与
requests,适合本地命令行使用和二次开发。
当前实现流程:
-
从输入文本中提取 URL。
-
如果是短链,跟随跳转到抖音分享页。
-
从 URL 或页面路径中提取
aweme_id。 -
请求移动分享页:
https://www.iesdouyin.com/share/video/{aweme_id}/ -
从页面脚本中的
window._ROUTER_DATA读取:videoInfoRes.item_list[0] -
从作品数据中取出
video.play_addr.uri。 -
构造抖音播放接口:
https://aweme.snssdk.com/aweme/v1/play/?video_id={video_id}&ratio={ratio}&line=0 -
可选跟随跳转,拿到最终签名 MP4 地址并下载。
要求 Python 3.9+。
git clone https://github.com/FanhuaAwA/douyin-direct-parser.git
cd douyin-direct-parser
python -m pip install -r requirements.txt解析单条分享链接并输出到终端:
python dy_parser.py "https://v.douyin.com/J4IQiholWbo/"解析分享文案并保存 JSON:
python dy_parser.py "7.92 :9pm TLJ:/ u@F.Hi 04/03 爱情公寓|第三季|第257集 https://v.douyin.com/J4IQiholWbo/ 复制此链接,打开Dou音搜索,直接观看视频!" --pretty-json --json-output result.json下载默认清晰度视频:
python dy_parser.py "https://v.douyin.com/J4IQiholWbo/" --download下载探测到的最大文件体积清晰度:
python dy_parser.py "https://v.douyin.com/J4IQiholWbo/" --download --quality best下载指定清晰度:
python dy_parser.py "https://v.douyin.com/J4IQiholWbo/" --download --quality 1080p下载全部构造出的清晰度:
python dy_parser.py "https://v.douyin.com/J4IQiholWbo/" --download --quality all同时下载封面:
python dy_parser.py "https://v.douyin.com/J4IQiholWbo/" --download --quality 1080p --download-cover准备 links.txt,每行一个抖音分享文案或 URL:
https://v.douyin.com/xxxx/
复制此链接,打开Dou音搜索,直接观看视频!https://v.douyin.com/yyyy/
执行:
python dy_parser.py --input-file links.txt --json-output results.json --pretty-json--download 下载选中的视频
--quality main|best|all 选择下载清晰度
--quality 1080p 下载指定清晰度
--ratios 1080p,720p,540p 指定要构造的清晰度列表
--no-resolve 不解析最终签名 MP4 地址,只输出播放接口地址
--download-cover 下载封面
--download-images 下载图集图片
--json-output PATH 保存解析结果为 JSON
--output-dir DIR 下载目录,默认 downloads
--input-file PATH 批量输入文件
--pretty-json 格式化 JSON 输出
--quiet 减少终端输出
JSON 结果包含:
source_url 原始输入 URL
resolved_url 短链跳转后的 URL
aweme_id 抖音作品 ID
title 视频标题
type 内容类型
cover 封面地址
videos 视频地址和多清晰度信息
pics 图集图片地址
author 作者信息
statistics 点赞、评论、收藏等统计字段
raw 抖音页面中的原始作品数据
.
├── dy_parser.py
├── requirements.txt
├── LICENSE
├── README.md
└── dyjiexi
├── __init__.py
├── cli.py # 命令行参数、批量、输出、下载调度
├── client.py # 抖音短链解析、分享页 SSR 解析、播放地址构造
└── downloader.py # 文件名清理和流式下载
测试链接:
https://v.douyin.com/J4IQiholWbo/
已验证:
- 成功解析标题:
爱情公寓|第三季|第257集 - 成功提取作品 ID:
7624728488368732900 - 成功生成
1080p / 720p / 540p视频地址 - 成功下载
1080pMP4 文件 - 下载文件头为标准 MP4:
ftypisom
抖音页面和播放接口可能变化。如果后续失效,优先检查:
window._ROUTER_DATA是否仍存在。videoInfoRes.item_list[0]路径是否变化。video.play_addr.uri是否仍可用于aweme/v1/play。aweme/v1/play是否新增签名、校验或风控参数。
本项目仅用于学习、研究和处理你有权访问与保存的公开内容。视频、图片、音乐等内容版权归原作者或平台所有。请遵守抖音平台规则、版权要求和当地法律法规,不要将本项目用于侵权、批量搬运或商业化滥用。
本项目基于 MIT License 开源。