API Reference
Multi-platform video parse API
REQUEST
video-parse-api
ID 43
Parse a shared video link into title, cover, media URL, and author.
REQUEST
https://xiaoapis.com/api/video/videoparse
Overview
- 分享链接解析
- 封面与标题
- 媒体地址
- JSON 返回
Use cases
- 内容采集入库
- AI 视频分析
- AI 剪辑素材接入
- 短视频内容提取
Conventions
- Gateway ·
https://xiaoapis.com - Auth · send
key(query or JSON body, as this API specifies) - Response · JSON. Check the business code and the HTTP status, not only HTTP 200
Authentication
Send the platform API key (query parameter key or JSON field key, as this page specifies). Create one in API key management.
REQUEST https://xiaoapis.com/api/video/videoparse
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
Request example
/api/video/videoparse?key=你的key&url=https://v.douyin.com/xxxxx/
Details
接口说明：
同步解析视频/图文分享链接，立即返回标题、描述、封面、无水印视频直链、图集、作者与互动数据。支持完整 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 |
Response example
{"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"}
Error codes
| 错误码 | 类型 | 说明 |
|---|---|---|
| 403 | int | 没有权限 / 密钥无效 |
| 400 | int | 参数错误、链接无法访问或未能解析到有效内容；点数不足也会返回 400 |
| 500 | int | 服务内部错误，请稍后重试。此类错误不扣费 |
FAQ
什么是视频解析 API？
通过公开分享链接或口令解析视频元数据与可用资源信息，供业务系统采集与二次加工（须遵守版权与平台规则）。
视频解析 API 怎么使用？
使用 API Key 调用接口，传入 url（分享短链或完整链接），同步返回 JSON 结果。
可以获取哪些数据？
通常包括标题、封面、作者及可用媒体地址等，具体字段以文档返回示例为准。
如何获取视频封面？
解析成功后从返回字段中读取封面地址（字段名见文档）。
适合什么场景？
内容审核辅助、爆款拆解、剪辑素材入库、数据分析等上游环节。
是否支持异步？
该接口一般为同步返回；耗时以实际网络与源站为准。
合规要注意什么？
解析能力不等于版权授权；公开传播或商用他人作品须遵守法律法规与原平台规则。
Related APIs
- Short-video script extraction API
- Short-video copy parsing API
- Speech to text with subtitles API
- WeChat Channels video parse API
Full console doc (with the debugger):/doc/43