欢迎访问极媒数据 · 新媒体数据服务平台 登录 免费注册 控制台
新媒体数据
服务平台

文章视频链接 API

微信公众号¥0.15/次每分钟 30 次

用文章链接或文章 sn 提取文内视频,返回视频地址、封面、标题和时长。

从一篇公众号文章里取出视频地址。url、article_url、article_id 三选一。article_id 是链接 /s/ 后面的 sn,会补成完整文章链接。

返回文章 ID、视频地址、封面、标题、时长和视频 ID。文章里没有视频时不会编造地址。

请求地址 POST https://www.xmedi.cn/api/v1/wechat/articles/video-link。调用成功才扣费,参数错误、平台侧失败或超时不扣费。

成功响应的 meta 含数据血缘,说明见 鉴权与计费。

适用场景

  • 归档:把图文里的视频另存播放地址。
  • 转写:先拿到视频地址,再决定是否下载或转写。
  • 核对:确认某篇推送是不是视频稿。

请求参数

字段类型必填说明
article_id string 否 文章 sn,即 /s/ 后面那段。会补成完整链接。
article_url string 否 与 url 等价。
url string 否 文章链接,https://mp.weixin.qq.com/s/… 或带 __biz 的长链。与 article_url、article_id 三选一。

返回 data 字段

字段类型说明
article_idstring文章 ID。
cover_urlstring封面,可能为空。
durationnumber时长,可能为空。
titlestring视频标题,可能为空。
video_idstring视频 ID,可能为空。
video_urlstring视频地址。

调用示例

curl -X POST https://www.xmedi.cn/api/v1/wechat/articles/video-link \
  -H "X-XMEDI-Key: xm_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"http://mp.weixin.qq.com/s?__biz=MjM5MjAxNDM4MA==\u0026mid=2667026902\u0026idx=1\u0026sn=625cd9b1604b0968a3dcb98380a931ff"}'

调试

返回示例

以下为 data 的字段结构示意,实际取值以调用结果为准。

{
  "article_id": "EXAMPLESN",
  "cover_url": "https://example.com/cover.jpg",
  "duration": 60,
  "title": "示例视频",
  "video_id": "wxv_example",
  "video_url": "https://example.com/article.mp4"
}

注意事项

  • 这是文章内视频,不是视频号作品。视频号下载用视频号可下载链接。
  • 视频地址可能有时效,拿到后尽快下载。

常见错误码

codeerror_code含义与处理
40001VALIDATION_ERROR参数校验失败,按返回提示修改请求,不扣费
40100UNAUTHORIZEDAPI Key 缺失、错误或已吊销,到控制台检查 Key
40200INSUFFICIENT_BALANCE余额不足,充值后重试
42900RATE_LIMITED超过每分钟 30 次上限,稍后重试
50000INTERNAL_ERROR服务异常,可稍后重试,不扣费
50300NOT_AVAILABLE接口暂不可用,不扣费

常见问题

纯文字文章会返回什么?
没有视频时调用失败或不给出 video_url,不扣费。不要把空地址当成可播放文件。
短链和长链都可以吗?
可以。mp.weixin.qq.com/s/ 短链和带 __biz 的长链都可以,也可以只传 sn。
调用失败会扣费吗?
文章打不开或文内没有视频时不扣费。

相关接口

需要接入这个接口?

注册后创建 API Key,或留下联系方式获取方案

免费注册
×

微信号 xmedi369