全平台视频元数据解析服务

video-parseGET
GEThttps://v1.apizero.cn/api/video-parse
获取 API Key工作台购买 / 调试

概述

一条 GET：`https://v1.apizero.cn/api/video-parse`。必填 `url`（分享链接或短链），可选 `flat=0/1/2` 控制回包结构。国内平台还可选 cookie（字符串或任意键名的对象，不传则公开解析；海外链接不要传）。平台按链接自动识别，**没有**按抖音/快手拆开的子地址。 仅限解析您本人发布或已获书面授权的内容；禁止解析抖音、快手、小红书、B站等平台上他人的视频/图文，禁止做成下载站或公开传播他人作品。若您仍强制解析他人内容，由此产生的全部法律责任、平台处罚与第三方索赔均由调用方自行承担，与本服务无关。 子接口按真实参数拆：`url`（必填链接）、`flat=2`（推荐，type 三值枚举）、`flat=1`（单层 data）、`flat=0`（双层 data，兼容旧版）。

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。
/aidocs/video-parse/raw.md
打开 Markdown

鉴权

匿名可调用：QPS 1、日 3 次（仅供试用）；登录后：QPS 20、日 5 次；黄金会员：QPS 80、日 20000 次；钻石会员：QPS 80、日 50000 次；企业会员：QPS 120、日 1000000 次。批量查询请控制在QPS 120以内。

获取 API Key

请求头

Authorizationstring必填

必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。

标准调用（url）

GETURL QUERY·APPLICATION/JSON

仅限解析您本人发布或已获书面授权的内容；禁止解析抖音、快手、小红书、B站等平台上他人的视频/图文，禁止做成下载站或公开传播他人作品。若您仍强制解析他人内容，由此产生的全部法律责任、平台处罚与第三方索赔均由调用方自行承担，与本服务无关。 地址只有一条：GET /api/video-parse。必填 url，可选 flat。平台看链接 host，不要自己传 platform。成功包含 work_id（作品 ID，认不出给空字符串）。成功包末尾另有 duration_ms（毫秒）和 duration（秒），没有片长时为 null。

https://v1.apizero.cn/api/video-parse?flat=2&url=https%3A%2F%2Fwww.xiaohongshu.com%2Fdiscovery%2Fitem%2F6a93806c000000002903e620%3Fxsec_token%3DAB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI%3D

url（链接）string必填

必填。待解析的分享链接或短链，最大 2048 字符。只允许您本人发布或已获书面授权的内容；平台由链接自动识别，没有 platform 参数。

例https://www.xiaohongshu.com/discovery/item/6a93806c000000002903e620?xsec_token=AB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI=

flatinteger选填

可选。0=双层 data；1=单层 data，type 保持平台原样；2=单层 data，type 只出 视频 | 图集 | 实况图集。不传按 0。

例2

返回结果

platformstring

平台标识：douyin / kuaishou / xiaohongshu / bilibili / weibo / pipixia / xigua / haokan / tiktok / youtube / instagram / twitter / facebook / doubao / qianwen / kling

typestring

flat=2 全平台只出三个值：视频 | 图集 | 实况图集。有动图就是实况图集；图文别名收成图集

titlestring

标题；没有则为空字符串

descstring

正文 / 描述；没有则为空字符串

work_idstring

作品 ID（抖音 aweme_id、小红书笔记 id、B 站 bvid 等）；识别不到则为空字符串

video_urlstring

最优画质视频直链；纯图集时为空字符串

cover_urlstring

封面；没有时可能回落到第一张静图

audio_urlstring

音频直链；没有则为空字符串

imagelistarray

静图 URL 字符串数组。元素就是字符串，不是对象。动图不在这里

imagelist[]string

单张静图 URL

statsobject

互动与作者信息；缺项为 0 或空字符串

author_namestring

作者昵称

author_avatarstring

作者头像 URL

author_accountstring

作者账号 / 短 ID

author_idstring

作者平台 ID

like_countinteger

点赞数；没有为 0

comment_countinteger

评论数；没有为 0

share_countinteger

转发数；没有为 0

play_countinteger

播放数；没有为 0

collect_countinteger

收藏数；没有为 0

publish_timestring

发布时间；没有为空字符串

video_listarray

全部可下载视频。普通视频是清晰度档，动图 quality 为 动图1/2…

qualitystring

清晰度，或动图序号（动图1/2…）

urlstring

该档直链

sizestring

文件大小；没有为空字符串

resolutionstring

分辨率，如 1080x1920；没有为空字符串

sourceobject

来源、作者与版权说明

platformstring

平台标识，与顶层 platform 相同

platform_labelstring

平台中文名，如 抖音 / 小红书

original_urlstring

原始分享链接

work_idstring

作品 ID，与 data.work_id 相同

author_namestring

作者昵称

author_accountstring

作者账号

author_idstring

作者平台 ID

copyright_noticestring

版权说明

usage_restrictionstring

使用限制

disclaimer_urlstring

免责声明页

dmca_contactstring

侵权投诉邮箱

duration_msinteger

视频片长，单位毫秒。没有片长时为 null，不会写成 0。flat=0/1/2 都有，追加在原有字段后面，旧调用不用改

durationnumber

视频片长，单位秒，最多 3 位小数。与 duration_ms 是同一段时长。没有片长时为 null

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "platform": "xiaohongshu",
    "type": "实况图集",
    "title": "一年级同学你好！！！",
    "desc": "这个小朋友真的成为小学生了，送到校门口老母亲就飙泪[完啦R]希望你在学校开心成长，冲呀！！\n#2026开学季#  #开开心心上学# #深圳小学生# #最美开学季# #新沙小学#",
    "video_url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f055eab4401005003a0502de388_19.mp4?sign=23457ee…",
    "cover_url": "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m004b4pdr0lps2k7du00i0",
    "audio_url": "",
    "imagelist": [
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m004b4pdr0lps2k7du00i0",
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m0g4b4pdr0lps2kh0tt50g",
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m104b4pdr0lps2kupti69o",
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m1g4b4pdr0lps2khisrvoo"
    ],
    "source": {
      "platform": "xiaohongshu",
      "platform_label": "小红书",
      "original_url": "https://www.xiaohongshu.com/discovery/item/6a93806c000000002903e620?xsec_token=AB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI=",
      "author_name": "林俊烨",
      "author_account": "",
      "author_id": "",
      "copyright_notice": "本内容版权归原作者及原平台所有；本服务仅提供 URL 解析技术服务，不存储、不复制、不分发任何原始视频/图片/音频内容。",
      "usage_restriction": "仅供个人备份、内容审核、数据分析、学术研究等合理使用场景；禁止公开传播他人作品、二次商业转售、集成到下载分发站点或用于任何侵犯原作者权益的行为。",
      "disclaimer_url": "https://apizero.cn/marketplace/video-parse",
      "dmca_contact": "1790643379@qq.com"
    },
    "stats": {
      "author_name": "林俊烨",
      "author_avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo324friht1gm0g4b4pdr0lps2kqiam5i0",
      "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": "动图1",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f055eab4401005003a0502de388_19.mp4?sign=23457ee…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图2",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f065ddff301005003a0502de662_19.mp4?sign=653c8b1…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图3",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f07755f9501005003a0502dec16_19.mp4?sign=f2a23c7…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图4",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f085d824c01005003a0502ddb51_19.mp4?sign=6ca866a…",
        "size": "",
        "resolution": ""
      }
    ]
  },
  "request_id": "mtittucxbd00d4b0",
  "tips": "极数本源 · https://apizero.cn"
}

统一枚举（flat=2）

GETURL QUERY·APPLICATION/JSON

仅限解析您本人发布或已获书面授权的内容；禁止解析抖音、快手、小红书、B站等平台上他人的视频/图文，禁止做成下载站或公开传播他人作品。若您仍强制解析他人内容，由此产生的全部法律责任、平台处罚与第三方索赔均由调用方自行承担，与本服务无关。 结构、字段名与 flat=1 相同（单层 data）。只改 type：全平台只出 视频 | 图集 | 实况图集。有动图就是实况图集。末尾另有 duration_ms（毫秒）和 duration（秒），没有片长时为 null。新接入推荐这个。旧字段不用改。

https://v1.apizero.cn/api/video-parse?flat=2&url=https%3A%2F%2Fwww.xiaohongshu.com%2Fdiscovery%2Fitem%2F6a93806c000000002903e620%3Fxsec_token%3DAB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI%3D

url（链接）string必填

必填。待解析的分享链接或短链，最大 2048 字符。只允许您本人发布或已获书面授权的内容；平台由链接自动识别，没有 platform 参数。

例https://www.xiaohongshu.com/discovery/item/6a93806c000000002903e620?xsec_token=AB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI=

flatinteger选填

2=单层 data，type 只出 视频 | 图集 | 实况图集

例2

返回结果

platformstring

平台标识：douyin / kuaishou / xiaohongshu / bilibili / weibo / pipixia / xigua / haokan / tiktok / youtube / instagram / twitter / facebook / doubao / qianwen / kling

typestring

flat=2 全平台只出三个值：视频 | 图集 | 实况图集。有动图就是实况图集；图文别名收成图集

titlestring

标题；没有则为空字符串

descstring

正文 / 描述；没有则为空字符串

work_idstring

作品 ID（抖音 aweme_id、小红书笔记 id、B 站 bvid 等）；识别不到则为空字符串

video_urlstring

最优画质视频直链；纯图集时为空字符串

cover_urlstring

封面；没有时可能回落到第一张静图

audio_urlstring

音频直链；没有则为空字符串

imagelistarray

静图 URL 字符串数组。元素就是字符串，不是对象。动图不在这里

imagelist[]string

单张静图 URL

statsobject

互动与作者信息；缺项为 0 或空字符串

author_namestring

作者昵称

author_avatarstring

作者头像 URL

author_accountstring

作者账号 / 短 ID

author_idstring

作者平台 ID

like_countinteger

点赞数；没有为 0

comment_countinteger

评论数；没有为 0

share_countinteger

转发数；没有为 0

play_countinteger

播放数；没有为 0

collect_countinteger

收藏数；没有为 0

publish_timestring

发布时间；没有为空字符串

video_listarray

全部可下载视频。普通视频是清晰度档，动图 quality 为 动图1/2…

qualitystring

清晰度，或动图序号（动图1/2…）

urlstring

该档直链

sizestring

文件大小；没有为空字符串

resolutionstring

分辨率，如 1080x1920；没有为空字符串

sourceobject

来源、作者与版权说明

platformstring

平台标识，与顶层 platform 相同

platform_labelstring

平台中文名，如 抖音 / 小红书

original_urlstring

原始分享链接

work_idstring

作品 ID，与 data.work_id 相同

author_namestring

作者昵称

author_accountstring

作者账号

author_idstring

作者平台 ID

copyright_noticestring

版权说明

usage_restrictionstring

使用限制

disclaimer_urlstring

免责声明页

dmca_contactstring

侵权投诉邮箱

duration_msinteger

视频片长，单位毫秒。没有片长时为 null，不会写成 0。flat=0/1/2 都有，追加在原有字段后面，旧调用不用改

durationnumber

视频片长，单位秒，最多 3 位小数。与 duration_ms 是同一段时长。没有片长时为 null

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "platform": "xiaohongshu",
    "type": "实况图集",
    "title": "一年级同学你好！！！",
    "desc": "这个小朋友真的成为小学生了，送到校门口老母亲就飙泪[完啦R]希望你在学校开心成长，冲呀！！\n#2026开学季#  #开开心心上学# #深圳小学生# #最美开学季# #新沙小学#",
    "video_url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f055eab4401005003a0502de388_19.mp4?sign=23457ee…",
    "cover_url": "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m004b4pdr0lps2k7du00i0",
    "audio_url": "",
    "imagelist": [
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m004b4pdr0lps2k7du00i0",
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m0g4b4pdr0lps2kh0tt50g",
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m104b4pdr0lps2kupti69o",
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m1g4b4pdr0lps2khisrvoo"
    ],
    "source": {
      "platform": "xiaohongshu",
      "platform_label": "小红书",
      "original_url": "https://www.xiaohongshu.com/discovery/item/6a93806c000000002903e620?xsec_token=AB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI=",
      "author_name": "林俊烨",
      "author_account": "",
      "author_id": "",
      "copyright_notice": "本内容版权归原作者及原平台所有；本服务仅提供 URL 解析技术服务，不存储、不复制、不分发任何原始视频/图片/音频内容。",
      "usage_restriction": "仅供个人备份、内容审核、数据分析、学术研究等合理使用场景；禁止公开传播他人作品、二次商业转售、集成到下载分发站点或用于任何侵犯原作者权益的行为。",
      "disclaimer_url": "https://apizero.cn/marketplace/video-parse",
      "dmca_contact": "1790643379@qq.com"
    },
    "stats": {
      "author_name": "林俊烨",
      "author_avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo324friht1gm0g4b4pdr0lps2kqiam5i0",
      "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": "动图1",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f055eab4401005003a0502de388_19.mp4?sign=23457ee…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图2",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f065ddff301005003a0502de662_19.mp4?sign=653c8b1…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图3",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f07755f9501005003a0502dec16_19.mp4?sign=f2a23c7…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图4",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f085d824c01005003a0502ddb51_19.mp4?sign=6ca866a…",
        "size": "",
        "resolution": ""
      }
    ]
  },
  "request_id": "mtittucxbd00d4b0",
  "tips": "极数本源 · https://apizero.cn"
}

单层结构（flat=1）

GETURL QUERY·APPLICATION/JSON

仅限解析您本人发布或已获书面授权的内容；禁止解析抖音、快手、小红书、B站等平台上他人的视频/图文，禁止做成下载站或公开传播他人作品。若您仍强制解析他人内容，由此产生的全部法律责任、平台处罚与第三方索赔均由调用方自行承担，与本服务无关。 单层 data。title / desc / work_id / video_url / cover_url / audio_url / imagelist / stats / video_list / source 在 data 顶层，末尾追加 duration_ms（毫秒）和 duration（秒）。没有片长时为 null。type 保持平台原样。现网已接 flat=1 的项目不用改原有字段。

https://v1.apizero.cn/api/video-parse?flat=1&url=https%3A%2F%2Fwww.xiaohongshu.com%2Fdiscovery%2Fitem%2F6a93806c000000002903e620%3Fxsec_token%3DAB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI%3D

url（链接）string必填

必填。待解析的分享链接或短链，最大 2048 字符。只允许您本人发布或已获书面授权的内容；平台由链接自动识别，没有 platform 参数。

例https://www.xiaohongshu.com/discovery/item/6a93806c000000002903e620?xsec_token=AB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI=

flatinteger选填

1=单层 data；type 保持平台原样

例1

返回结果

platformstring

平台标识：douyin / kuaishou / xiaohongshu / bilibili / weibo / pipixia / xigua / haokan / tiktok / youtube / instagram / twitter / facebook / doubao / qianwen / kling

typestring

内容类型。flat=0/1 保持平台原样：视频 / 图集；抖音图集可能是「动图集」或「实况图集」。要三值枚举请用 flat=2

titlestring

标题；没有则为空字符串

descstring

正文 / 描述；没有则为空字符串

work_idstring

作品 ID（抖音 aweme_id、小红书笔记 id、B 站 bvid 等）；识别不到则为空字符串

video_urlstring

最优画质视频直链；纯图集时为空字符串

cover_urlstring

封面；没有时可能回落到第一张静图

audio_urlstring

音频直链；没有则为空字符串

imagelistarray

静图 URL 字符串数组。元素就是字符串，不是对象。动图不在这里

imagelist[]string

单张静图 URL

statsobject

互动与作者信息；缺项为 0 或空字符串

author_namestring

作者昵称

author_avatarstring

作者头像 URL

author_accountstring

作者账号 / 短 ID

author_idstring

作者平台 ID

like_countinteger

点赞数；没有为 0

comment_countinteger

评论数；没有为 0

share_countinteger

转发数；没有为 0

play_countinteger

播放数；没有为 0

collect_countinteger

收藏数；没有为 0

publish_timestring

发布时间；没有为空字符串

video_listarray

全部可下载视频。普通视频是清晰度档，动图 quality 为 动图1/2…

qualitystring

清晰度，或动图序号（动图1/2…）

urlstring

该档直链

sizestring

文件大小；没有为空字符串

resolutionstring

分辨率，如 1080x1920；没有为空字符串

sourceobject

来源、作者与版权说明

platformstring

平台标识，与顶层 platform 相同

platform_labelstring

平台中文名，如 抖音 / 小红书

original_urlstring

原始分享链接

work_idstring

作品 ID，与 data.work_id 相同

author_namestring

作者昵称

author_accountstring

作者账号

author_idstring

作者平台 ID

copyright_noticestring

版权说明

usage_restrictionstring

使用限制

disclaimer_urlstring

免责声明页

dmca_contactstring

侵权投诉邮箱

duration_msinteger

视频片长，单位毫秒。没有片长时为 null，不会写成 0。flat=0/1/2 都有，追加在原有字段后面，旧调用不用改

durationnumber

视频片长，单位秒，最多 3 位小数。与 duration_ms 是同一段时长。没有片长时为 null

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "platform": "xiaohongshu",
    "type": "图集",
    "title": "一年级同学你好！！！",
    "desc": "这个小朋友真的成为小学生了，送到校门口老母亲就飙泪[完啦R]希望你在学校开心成长，冲呀！！\n#2026开学季#  #开开心心上学# #深圳小学生# #最美开学季# #新沙小学#",
    "video_url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f055eab4401005003a0502de388_19.mp4?sign=23457ee…",
    "cover_url": "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m004b4pdr0lps2k7du00i0",
    "audio_url": "",
    "imagelist": [
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m004b4pdr0lps2k7du00i0",
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m0g4b4pdr0lps2kh0tt50g",
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m104b4pdr0lps2kupti69o",
      "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m1g4b4pdr0lps2khisrvoo"
    ],
    "source": {
      "platform": "xiaohongshu",
      "platform_label": "小红书",
      "original_url": "https://www.xiaohongshu.com/discovery/item/6a93806c000000002903e620?xsec_token=AB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI=",
      "author_name": "林俊烨",
      "author_account": "",
      "author_id": "",
      "copyright_notice": "本内容版权归原作者及原平台所有；本服务仅提供 URL 解析技术服务，不存储、不复制、不分发任何原始视频/图片/音频内容。",
      "usage_restriction": "仅供个人备份、内容审核、数据分析、学术研究等合理使用场景；禁止公开传播他人作品、二次商业转售、集成到下载分发站点或用于任何侵犯原作者权益的行为。",
      "disclaimer_url": "https://apizero.cn/marketplace/video-parse",
      "dmca_contact": "1790643379@qq.com"
    },
    "stats": {
      "author_name": "林俊烨",
      "author_avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo324friht1gm0g4b4pdr0lps2kqiam5i0",
      "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": "动图1",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f055eab4401005003a0502de388_19.mp4?sign=23457ee…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图2",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f065ddff301005003a0502de662_19.mp4?sign=653c8b1…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图3",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f07755f9501005003a0502dec16_19.mp4?sign=f2a23c7…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图4",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f085d824c01005003a0502ddb51_19.mp4?sign=6ca866a…",
        "size": "",
        "resolution": ""
      }
    ]
  },
  "request_id": "mtitttzsebd0d489",
  "tips": "极数本源 · https://apizero.cn"
}

兼容旧版（flat=0）

GETURL QUERY·APPLICATION/JSON

仅限解析您本人发布或已获书面授权的内容；禁止解析抖音、快手、小红书、B站等平台上他人的视频/图文，禁止做成下载站或公开传播他人作品。若您仍强制解析他人内容，由此产生的全部法律责任、平台处罚与第三方索赔均由调用方自行承担，与本服务无关。 双层 data.data，兼容旧客户端。字段集合与 flat=1 相同，只是 title / desc / work_id / video_url 等在内层。duration_ms / duration 在成功包根级和 data.data 里各有一份，没有片长时为 null。不传 flat 时网关按 0 处理。新接入请用 flat=2。旧字段不用改。

https://v1.apizero.cn/api/video-parse?flat=0&url=https%3A%2F%2Fwww.xiaohongshu.com%2Fdiscovery%2Fitem%2F6a93806c000000002903e620%3Fxsec_token%3DAB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI%3D

url（链接）string必填

必填。待解析的分享链接或短链，最大 2048 字符。只允许您本人发布或已获书面授权的内容；平台由链接自动识别，没有 platform 参数。

例https://www.xiaohongshu.com/discovery/item/6a93806c000000002903e620?xsec_token=AB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI=

flatinteger选填

0=双层 data（不传 flat 时的默认）

例0

返回结果

data.platformstring

平台标识（与 flat=1 的 platform 相同）

data.typestring

与 flat=1 相同，保持平台原样；要三值枚举用 flat=2

data.data.titlestring

标题（flat=0 在内层）

data.data.descstring

正文 / 描述

data.data.work_idstring

作品 ID；识别不到则为空字符串

data.data.video_urlstring

最优画质视频直链

data.data.cover_urlstring

封面

data.data.audio_urlstring

音频直链

data.data.imagelistarray

静图 URL 字符串数组。元素就是字符串，不是对象

data.data.imagelist[]string

单张静图 URL

data.statsobject

互动与作者信息，字段与 flat=1 的 stats 相同

author_namestring

作者昵称

author_avatarstring

作者头像 URL

author_accountstring

作者账号 / 短 ID

author_idstring

作者平台 ID

like_countinteger

点赞数；没有为 0

comment_countinteger

评论数；没有为 0

share_countinteger

转发数；没有为 0

play_countinteger

播放数；没有为 0

collect_countinteger

收藏数；没有为 0

publish_timestring

发布时间；没有为空字符串

data.video_listarray

全部可下载视频，字段与 flat=1 的 video_list 相同

qualitystring

清晰度，或动图序号（动图1/2…）

urlstring

该档直链

sizestring

文件大小；没有为空字符串

resolutionstring

分辨率；没有为空字符串

data.sourceobject

来源与版权，字段与 flat=1 的 source 相同

platformstring

平台标识

platform_labelstring

平台中文名

original_urlstring

原始分享链接

work_idstring

作品 ID；识别不到则为空字符串

author_namestring

作者昵称

author_accountstring

作者账号

author_idstring

作者平台 ID

copyright_noticestring

版权说明

usage_restrictionstring

使用限制

disclaimer_urlstring

免责声明页

dmca_contactstring

侵权投诉邮箱

data.duration_msinteger

视频片长毫秒，在 flat=0 成功包根级（与 stats 同级）。没有片长时为 null

data.durationnumber

视频片长秒，最多 3 位小数，与 data.duration_ms 是同一段时长。没有片长时为 null

data.data.duration_msinteger

视频片长毫秒，与 video_url 同在 data.data。没有片长时为 null

data.data.durationnumber

视频片长秒，最多 3 位小数，与 data.data.duration_ms 是同一段时长。没有片长时为 null

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "code": 200,
    "platform": "xiaohongshu",
    "type": "图集",
    "data": {
      "title": "一年级同学你好！！！",
      "desc": "这个小朋友真的成为小学生了，送到校门口老母亲就飙泪[完啦R]希望你在学校开心成长，冲呀！！\n#2026开学季#  #开开心心上学# #深圳小学生# #最美开学季# #新沙小学#",
      "video_url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f055eab4401005003a0502de388_19.mp4?sign=23457ee…",
      "cover_url": "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m004b4pdr0lps2k7du00i0",
      "audio_url": "",
      "imagelist": [
        "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m004b4pdr0lps2k7du00i0",
        "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m0g4b4pdr0lps2kh0tt50g",
        "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m104b4pdr0lps2kupti69o",
        "https://sns-img-hw.xhscdn.com/1040g3k0324fneca50m1g4b4pdr0lps2khisrvoo"
      ],
      "source": {
        "platform": "xiaohongshu",
        "platform_label": "小红书",
        "original_url": "https://www.xiaohongshu.com/discovery/item/6a93806c000000002903e620?xsec_token=AB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI=",
        "author_name": "林俊烨",
        "author_account": "",
        "author_id": "",
        "copyright_notice": "本内容版权归原作者及原平台所有；本服务仅提供 URL 解析技术服务，不存储、不复制、不分发任何原始视频/图片/音频内容。",
        "usage_restriction": "仅供个人备份、内容审核、数据分析、学术研究等合理使用场景；禁止公开传播他人作品、二次商业转售、集成到下载分发站点或用于任何侵犯原作者权益的行为。",
        "disclaimer_url": "https://apizero.cn/marketplace/video-parse",
        "dmca_contact": "1790643379@qq.com"
      }
    },
    "stats": {
      "author_name": "林俊烨",
      "author_avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo324friht1gm0g4b4pdr0lps2kqiam5i0",
      "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": "动图1",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f055eab4401005003a0502de388_19.mp4?sign=23457ee…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图2",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f065ddff301005003a0502de662_19.mp4?sign=653c8b1…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图3",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f07755f9501005003a0502dec16_19.mp4?sign=f2a23c7…",
        "size": "",
        "resolution": ""
      },
      {
        "quality": "动图4",
        "url": "http://sns-video-v3.xhscdn.com/stream/1/10/19/01ea937f085d824c01005003a0502ddb51_19.mp4?sign=6ca866a…",
        "size": "",
        "resolution": ""
      }
    ],
    "source": {
      "platform": "xiaohongshu",
      "platform_label": "小红书",
      "original_url": "https://www.xiaohongshu.com/discovery/item/6a93806c000000002903e620?xsec_token=AB60s-_zXR2joXHMgEjMYY5sVepyHwtTOHkttVszo99RI=",
      "author_name": "林俊烨",
      "author_account": "",
      "author_id": "",
      "copyright_notice": "本内容版权归原作者及原平台所有；本服务仅提供 URL 解析技术服务，不存储、不复制、不分发任何原始视频/图片/音频内容。",
      "usage_restriction": "仅供个人备份、内容审核、数据分析、学术研究等合理使用场景；禁止公开传播他人作品、二次商业转售、集成到下载分发站点或用于任何侵犯原作者权益的行为。",
      "disclaimer_url": "https://apizero.cn/marketplace/video-parse",
      "dmca_contact": "1790643379@qq.com"
    }
  },
  "request_id": "mtittto167097287",
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/video-parse?url=https%3A%2F%2Fwww.bilibili.com%2Fvideo%2FBV1gY411A7y7&flat=1"

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快（QPS）

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
按次付费 · 点数包 · 月套餐
QPS 限制
QPS 20
登录免费额度
5 次（已认证）
匿名每日额度
3 次（无 API Key）
黄金会员
每天 20,000 次 · QPS 80
钻石会员
每天 50,000 次 · QPS 80
企业会员
本接口约 399,000 次/月 · QPS 120

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

  • v1.62026-09-23

    成功包追加视频片长：duration_ms（毫秒）和 duration（秒，最多 3 位小数）。没有片长时为 null。flat=0/1/2 都有，原有字段名和顺序不变，旧调用不用改。

  • v1.52026-09-17

    成功包新增 work_id（作品 ID）：抖音 aweme_id、小红书笔记 id、B 站 bvid 等。认不出给空字符串。source.work_id 与之相同。

  • v1.42026-09-01

    用真实解析刷新 flat=0/1/2 与各平台响应示例。同一条小红书实况笔记：flat=0/1 type=图集，flat=2 type=实况图集。

  • v1.32026-09-01

    新增 flat=2：结构同 flat=1，但 type 全平台只出 视频 | 图集 | 实况图集。flat=0/1 的 type 保持平台原样，老项目不用改字段。返回字段展开 imagelist[] / stats.* / video_list[].* / source.*。

  • v1.22026-09-01

    全平台成功包字段对齐：data 固定 title/desc/video_url/cover_url/audio_url/imagelist；imagelist 仍是 URL 字符串数组（兼容老前端）；动图进 video_list（quality 为 动图1/2…）；stats/source 字段固定。去掉豆包/千问独立 data 结构。

  • v1.12026-06-25

    新增豆包、千问内容分享解析（视频 / 图集），按链接自动识别，输出兼容 flat。

免责声明

使用限制（请先读）

本接口仅供解析、备份您本人发布或已获原作者书面授权的视频/图文。

禁止用本接口解析抖音、快手、小红书、B站、微博、TikTok 等平台上他人的作品；禁止做成下载站、聚合搬运、公开传播或二次商业转售。

调用即视为确认：该 url 对应内容为您本人所有或已获授权。若您仍强制解析他人内容，由此产生的全部法律责任、平台处罚与第三方索赔均由调用方自行承担，与本服务无关。

本服务只做 URL 元数据解析，不存储、不复制、不分发原始音视频文件。返回的媒体地址来自第三方平台 CDN，可能随时失效。

用户协议与免责声明

服务名称：聚合短视频解析 PRO（以下简称“本服务”） 运营主体：极数本源（福州）科技有限公司（以下简称“我们”或“本公司”） 服务地址：https://v1.apizero.cn/api/video-parse 联系邮箱：1790643379@qq.com 生效日期：2026 年 5 月 28 日 最近更新：2026 年 5 月 28 日 版本：v1.0

重要声明（请在调用 API 前完整阅读）

您（包括但不限于个人开发者、企业开发者及其下游用户，以下统称“调用方”或“您”）一旦开始调用本服务的任何接口，即视为已完整阅读、充分理解并接受本协议的全部条款，且自愿受其法律约束。

如果您不同意本协议的任何条款，请立即停止使用本服务。

一、服务说明（中性专业）

本服务（以下简称 "本服务" 或 "本平台"）由 极数本源（福州）科技有限公司（以下简称 "我们"）以 API 形式提供，用于将用户已能通过合法途径访问的视频/图集分享链接解析为可读结构化数据（标题、封面、作者、原始 URL 等元信息）。

1.1 服务性质

  • 本服务是技术工具，不是内容分发平台。
  • 本服务不存储、不复制、不缓存任何原始视频、图片、音频内容；仅在内存中保留最长 30 分钟的元数据缓存以提升响应速度。
  • 本服务不提供下载功能；返回的视频/图片 URL 均为第三方平台的公开 CDN 直链，由第三方平台直接对用户提供。
  • 本服务与抖音、小红书、哔哩哔哩、快手、微博等任何第三方平台均无关联，不代表任何第三方平台的官方立场。

1.2 服务定位

本服务面向开发者 / 企业客户提供，典型应用场景包括但不限于：

  • 个人内容备份：用户备份自己发布或合法授权的内容
  • 内容审核：MCN 机构、品牌方对委托发布的内容进行审核
  • 学术研究：高校、研究机构进行内容传播规律研究
  • 市场分析：合法范围内的公开数据聚合分析
  • 数据迁移：用户在自己拥有的多个账号间迁移内容

二、使用许可与禁止行为

2.1 许可范围

您（"调用方"）在同意本协议后，可在以下范围内使用本服务：

  • 解析您本人发布或已获原作者书面授权的内容
  • 解析公开领域内容（已进入公共版权领域、知识共享授权 CC0 等）
  • 在符合"合理使用"原则的范围内进行学术引用、新闻评论、个人学习

2.2 严格禁止的行为

调用方明确同意不进行以下行为，否则由调用方独立承担全部法律责任：

| 序号 | 禁止行为 | |------|----------| | 1 | 公开传播、二次发布他人受版权保护的视频/图片/音频内容 | | 2 | 将解析结果集成到视频下载站、聚合下载工具等以提供内容下载为主要功能的产品 | | 3 | 用于侵犯他人著作权、肖像权、隐私权、商业秘密的任何用途 | | 4 | 二次商业转售本服务的解析结果或将其作为自有产品的核心数据源对外销售 | | 5 | 对第三方平台进行大规模爬取、自动化抓取（单 API Key 调用频率超过本服务规定的限额） | | 6 | 用于违反国家法律法规、社会公序良俗的任何用途（涉黄、涉政、涉暴、涉恐、诈骗、传销等） | | 7 | 解析私密内容、付费会员专享内容、企业内部内容、未公开内容 | | 8 | 通过本服务收集、聚合、出售任何形式的他人个人信息 | | 9 | 冒充原作者、移除原作者署名或来源标识 | | 10 | 对本服务进行反向工程、压力测试、攻击行为（不含我们书面授权的渗透测试） |

2.3 调用方责任承诺

调用方在每次调用 API 时即视为再次确认：

  • 调用方对其下游用户的使用行为承担全部连带责任
  • 调用方将向其下游用户清晰展示本协议核心条款及来源标注信息
  • 调用方对违反本协议造成的任何第三方索赔，将独立承担、不可追溯至本服务
  • 若您仍强制解析他人内容，由此产生的全部法律责任、平台处罚与第三方索赔均由调用方自行承担，与本服务无关

三、知识产权声明

3.1 内容版权归属

所有解析结果中涉及的视频、图片、音频、文字内容，其版权均归原作者或原发布平台所有。本服务仅作为技术中转，不主张任何版权权益。

3.2 强制来源标注

本服务在每次成功响应中强制返回 `source` 字段，包含：

  • 原平台名称（platform_label）
  • 原始分享链接（original_url）
  • 原作者名称（author_name）
  • 版权声明（copyright_notice）
  • 使用限制（usage_restriction）

调用方必须在最终用户可见的界面上清晰展示这些来源信息，移除或隐藏这些字段视为严重违反本协议。

3.3 本服务自身权利

本服务自有的代码、文档、API 设计、解析算法、缓存策略等知识产权归 极数本源（福州）科技有限公司 所有。未经书面许可，不得抄袭、再分发或商业利用。

四、数据处理与隐私

4.1 数据最小化原则

本服务严格遵循《个人信息保护法》《数据安全法》等法律法规要求：

  • 不收集调用方及其下游用户的个人身份信息、设备指纹、生物特征
  • 不存储调用方提交的原始 URL（仅日志中保留 SHA-256 哈希值用于审计）
  • 不存储解析结果（仅在内存缓存 ≤ 30 分钟）
  • 不分析调用方的使用模式用于商业推广

4.2 日志保留

为安全审计、合规检查、故障排查需要，本服务保留调用时间、API Key 标识、目标 URL 的哈希与响应状态，用于安全审计与故障排查。

全平台视频元数据解析服务 接入文档｜极数本源