API Reference
全平台视频解析 API
REQUEST
video-parse-api
ID 43
销豹视频解析 API 通过视频分享链接获取标题、封面、媒体地址与作者等信息，用于分析、剪辑与内容生产上游。
REQUEST
https://apis.xiaobao.ink/api/video/videoparse
概述
- 分享链接解析
- 封面与标题
- 媒体地址
- JSON 返回
适用场景
- 内容采集入库
- AI 视频分析
- AI 剪辑素材接入
- 短视频内容提取
调用约定
- 网关 ·
https://apis.xiaobao.ink - 鉴权 · 请求携带
key（Query 或 JSON Body，以本接口为准） - 回包 · JSON；请同时校验业务码与 HTTP 状态，不要只看 200
鉴权
请求需携带平台 API Key（查询参数 key 或 JSON 字段 key，以本接口说明为准）。在控制台 API Key 管理 创建密钥。
REQUEST https://apis.xiaobao.ink/api/video/videoparse
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
请求示例
/api/video/videoparse?key=你的key&url=https://v.douyin.com/xxxxx/
详细说明
接口说明：
同步解析视频/图文分享链接，立即返回标题、描述、封面、无水印视频直链、图集、作者与互动数据。支持完整 URL、短链，以及带链接的分享口令（自动提取其中的 http(s) 地址）。解析失败不扣费。
支持平台：抖音、快手、小红书、哔哩哔哩、微博、皮皮虾、西瓜视频、好看视频、TikTok、YouTube、Instagram、Twitter/X、Facebook、豆包、千问、可灵。
本接口仅提供链接元数据解析，不存储、不复制、不分发原始内容。解析结果版权归原作者及原平台所有，仅供个人备份、内容审核、数据分析、学术研究等合理使用；禁止公开传播他人作品、二次商业转售或集成到下载分发站点。
请求HEADER：
| 名称 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded;charset:utf-8; 或 application/json |
请求参数说明：
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| key | 是 | string | 35kj5jnlj53453kl5j43nj5 | 接口密钥,在控制台->密钥管理查看 |
| url | 是 | string | https://v.douyin.com/xxxxx/ | 待解析链接，完整 URL 或分享短链，最大 2048 字符。兼容 content、link；可直接粘贴带网址的分享口令，接口会自动提取链接 |
| flat | 否 | int | 2 | 出参结构。2=单层 data，type 只出 视频 / 图集 / 实况图集（默认，推荐）；1=单层 data，保留平台原始 type；0=兼容旧版双层 data |
GET / POST / JSON 均可。同步接口，一般 2～5 秒返回。每次成功解析扣 1 点（约 0.01 元）；参数错误或解析失败不扣费。
返回参数说明：
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200 表示成功 |
| msg | string | 状态信息 |
| data | object | 解析结果 |
| data.platform | string | 平台标识：douyin / kuaishou / xiaohongshu / bilibili / weibo / pipixia / xigua / haokan / tiktok / youtube / instagram / twitter / facebook / doubao / qianwen / kling |
| data.type | string | flat=2 时为：视频、图集、实况图集（含动图即为实况图集）。flat=1 时可能为平台原始类型 |
| data.title | string | 标题；没有则为空字符串 |
| data.desc | string | 正文 / 描述；没有则为空字符串 |
| data.video_url | string | 最优画质视频直链；纯图集时为空字符串 |
| data.cover_url | string | 封面；没有时可能回落到第一张静图 |
| data.audio_url | string | 音频直链；没有则为空字符串 |
| data.imagelist | array | 静图 URL 字符串数组。元素就是字符串，不是对象。动图不在这里 |
| data.images | array | 同 imagelist，便于直接使用 |
| data.author | string | 作者昵称（从 stats / source 提升到顶层） |
| data.author_avatar | string | 作者头像 URL |
| data.author_id | string | 作者平台 ID |
| data.author_account | string | 作者账号 / 短 ID |
| data.video_format | string | 视频格式：mp4 / hls，无法判断时为空字符串 |
| data.request_url | string | 本次实际解析的链接 |
| data.stats | object | 互动与作者信息；缺项为 0 或空字符串 |
| data.stats.author_name | string | 作者昵称 |
| data.stats.author_avatar | string | 作者头像 URL |
| data.stats.author_account | string | 作者账号 / 短 ID |
| data.stats.author_id | string | 作者平台 ID |
| data.stats.like_count | int | 点赞数；没有为 0 |
| data.stats.comment_count | int | 评论数；没有为 0 |
| data.stats.share_count | int | 转发数；没有为 0 |
| data.stats.play_count | int | 播放数；没有为 0 |
| data.stats.collect_count | int | 收藏数；没有为 0 |
| data.stats.publish_time | string | 发布时间；没有为空字符串 |
| data.video_list | array | 全部可下载视频。普通视频是清晰度档，动图 quality 为 动图1/2… |
| data.video_list[].quality | string | 清晰度，或动图序号（动图1/2…） |
| data.video_list[].url | string | 该档直链 |
| data.video_list[].size | string | 文件大小；没有为空字符串 |
| data.video_list[].resolution | string | 分辨率，如 1080x1920；没有为空字符串 |
| data.source | object | 来源、作者与版权说明。调用方应在最终用户可见界面展示来源信息 |
| data.source.platform | string | 平台标识，与顶层 platform 相同 |
| data.source.platform_label | string | 平台中文名，如 抖音 / 小红书 |
| data.source.original_url | string | 原始分享链接 |
| data.source.author_name | string | 作者昵称 |
| data.source.author_account | string | 作者账号 |
| data.source.author_id | string | 作者平台 ID |
| data.source.copyright_notice | string | 版权说明 |
| data.source.usage_restriction | string | 使用限制 |
| exec_time | float | 执行耗时 |
| ip | string | 客户端IP |
返回示例
{"code":200,"msg":"success","data":{"platform":"xiaohongshu","type":"视频","title":"一年级同学你好！！！","desc":"这个小朋友真的成为小学生了，送到校门口老母亲就飙泪","video_url":"https://sns-video-hs.xhscdn.com/example.mp4","cover_url":"https://sns-img-hw.xhscdn.com/example","audio_url":"","imagelist":["https://sns-img-hw.xhscdn.com/example"],"images":["https://sns-img-hw.xhscdn.com/example"],"author":"示例作者","author_avatar":"https://sns-avatar-qc.xhscdn.com/avatar/example","author_id":"","author_account":"","video_format":"mp4","request_url":"https://www.xiaohongshu.com/discovery/item/example","stats":{"author_name":"示例作者","author_avatar":"https://sns-avatar-qc.xhscdn.com/avatar/example","author_account":"","author_id":"","like_count":40,"comment_count":23,"share_count":4,"play_count":0,"collect_count":9,"publish_time":"2026-08-30 08:59:24"},"video_list":[{"quality":"高清","url":"https://sns-video-hs.xhscdn.com/example.mp4","size":"","resolution":"1080x1920"}],"source":{"platform":"xiaohongshu","platform_label":"小红书","original_url":"https://www.xiaohongshu.com/discovery/item/example","author_name":"示例作者","author_account":"","author_id":"","copyright_notice":"本内容版权归原作者及原平台所有；本服务仅提供 URL 解析技术服务，不存储、不复制、不分发任何原始视频/图片/音频内容。","usage_restriction":"仅供个人备份、内容审核、数据分析、学术研究等合理使用场景；禁止公开传播他人作品、二次商业转售、集成到下载分发站点或用于任何侵犯原作者权益的行为。","disclaimer_url":""}},"exec_time":2.18,"ip":"1.2.3.4"}
错误码
| 错误码 | 类型 | 说明 |
|---|---|---|
| 403 | int | 没有权限 / 密钥无效 |
| 400 | int | 参数错误、链接无法访问或未能解析到有效内容；点数不足也会返回 400 |
| 500 | int | 服务内部错误，请稍后重试。此类错误不扣费 |
常见问题
什么是视频解析 API？
通过公开分享链接或口令解析视频元数据与可用资源信息，供业务系统采集与二次加工（须遵守版权与平台规则）。
视频解析 API 怎么使用？
使用 API Key 调用接口，传入 url（分享短链或完整链接），同步返回 JSON 结果。
可以获取哪些数据？
通常包括标题、封面、作者及可用媒体地址等，具体字段以文档返回示例为准。
如何获取视频封面？
解析成功后从返回字段中读取封面地址（字段名见文档）。
适合什么场景？
内容审核辅助、爆款拆解、剪辑素材入库、数据分析等上游环节。
是否支持异步？
该接口一般为同步返回；耗时以实际网络与源站为准。
合规要注意什么？
解析能力不等于版权授权；公开传播或商用他人作品须遵守法律法规与原平台规则。
相关接口
完整控制台文档（含调试台）：/doc/43