请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
url |
string | 是 | 短视频链接，或包含第一个短视频链接的整段分享文案 |
请求示例
GET 调试示例
/api/video_parse?url=https%3A%2F%2Fv.douyin.com%2FhaL5HkKS1G4%2F
POST JSON 请求示例
POST /api/video_parse
Content-Type: application/json
{
"url": "7.69 [email protected] 03/31 RKj:/ :2pm 第99集｜吴敬中死保余则成翠平撤退未成功# 潜伏# 谍战剧 https://v.douyin.com/haL5HkKS1G4/ 复制此链接，打开Dou音搜索，直接观看视频！"
}
分场景示例
皮皮搞笑视频
GET
https://h5.ippzone.com/spacey/post/880066845921?mid=8679005021507&pid=880066845921&type=post
type=video，url/video_url 返回视频地址
皮皮搞笑图集
GET
https://h5.ippzone.com/spacey/post/705718038949?mid=8679005021507&pid=705718038949&type=post
type=image，images 返回图片列表
汽水音乐视频
GET
https://qishui.douyin.com/s/iQ8Dybpo/
type=video，url/video_url 返回视频地址；音轨分享会返回 type=audio
快手图集 / live
GET
https://v.kuaishou.com/KdaxRrgI
type=image，images 返回图片列表；网页分享页可能只暴露 atlas 图集和 m4a 音频，不一定暴露 live 视频片段
好看视频
GET
https://haokan.baidu.com/v?vid=17831460188721240800&pd=pcshare
type=video，url/video_url 返回视频地址
绿洲视频 / 图集
GET
https://m.oasis.weibo.cn/v1/h5/share?sid=5298109040822721
视频返回 type=video；图集返回 type=image
最右视频 / 图集
GET
https://share.xiaochuankeji.cn/hybrid/share/post?pid=420933345
视频返回 type=video；混合内容会同时返回 images
返回示例
{
"code": 200,
"msg": "解析成功",
"data": {
"type": "video",
"title": "第99集｜吴敬中死保余则成翠平撤退未成功#潜伏#谍战剧",
"desc": "第99集｜吴敬中死保余则成翠平撤退未成功#潜伏#谍战剧",
"author": {
"name": "剧忆优新",
"id": "2553478630618670",
"avatar": "https://example.com/avatar.jpg"
},
"cover": "https://example.com/cover.jpg",
"url": "https://example.com/video.mp4",
"duration": 216500,
"video_backup": [
"https://example.com/video-backup-1.mp4"
],
"images": [],
"live_photo": [],
"music": {
"title": "原声",
"author": "剧忆优新",
"url": "https://example.com/music.mp3",
"cover": "https://example.com/music-cover.jpg"
},
"video_id": "7624339362917948787"
}
}
返回字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
code |
integer | 业务状态码，200 表示解析成功 |
msg |
string | 响应提示信息 |
data.platform |
string | 识别到的平台，例如 douyin、kuaishou、xiaohongshu、bilibili、weibo、toutiao、pipigx、pipixia、qishui、quanmin、haokan、weishi、pearvideo、acfun、huya、lvzhou、meipai、sixroom、zuiyou |
data.type |
string | 内容类型：video 视频、image 图集、live 实况内容、audio 音频 |
data.title |
string | 内容标题 |
data.desc |
string | 内容描述或正文 |
data.author |
object | 作者信息，包含 id、name、avatar |
data.cover |
string|null | 封面图片地址 |
data.url |
string|null | 主资源地址，视频内容通常为视频直链 |
data.video_url |
string|null | 视频地址，和 url 保持一致，便于调用方语义化读取 |
data.images |
array | 图集图片地址列表 |
data.image_count |
integer | 图片数量 |
data.live_photo |
array | 实况图片段列表，每项通常包含 image 和 video |
data.duration_ms |
integer|null | 视频时长，单位毫秒 |
data.source_url |
string | 用户提交或提取出的原始链接 |
data.normalized_url |
string | 系统跟随短链跳转后得到的规范链接 |
字段说明根据返回示例自动推断；复杂字段以真实接口返回为准。
请求示例 URL
https://api.116818.xyz/api/video_parse?url=%3Curl%3E
常见状态码
| 状态码 | 说明 |
|---|---|
400 |
缺少 url、链接格式无效，或平台暂不支持 |
404 |
平台内容不存在、已失效，或解析不到有效内容 ID |
429 |
请求频率超限，请稍后重试 |
502 |
上游平台请求失败、返回异常，或解析器未拿到有效 JSON |
500 |
服务端配置或运行环境异常 |
调用提示
- GET 适合直接传单个链接；POST JSON 适合传包含 # 话题、换行、中文文案的完整分享口令。
- 响应头 X-Cache-Status 为 HIT 表示命中缓存，MISS 表示本次重新解析。
- 图集类内容主要读取 images；视频类内容主要读取 url 或 video_url；实况图可额外读取 live_photo。
- 汽水音乐普通 UGC 分享按视频解析；音轨分享会按 audio 返回，主音频地址仍读取 url。
- 快手 atlas/live 网页分享页当前稳定返回 images 和 music.url；live 视频片段需等待二阶段接口确认，排查记录见 video_parser/docs/kuaishou-live.md。