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

可下载链接 API

视频号¥0.15/次每分钟 30 次

用分享短链、作品 ID 或 export_id 获取可直接播放的视频地址。短链成功率最高;只传 export_id 需先换成作品 ID。

获取视频号作品的可播放地址。url、feed_id、export_id 三选一,优先传分享短链 url(https://weixin.qq.com/sph/…),成功率最高。只传 export_id 时请先用 ID 互转换成 feed_id。

返回 download_url。链接带时效,expires_at 经常为空,拿到后尽快下载。

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

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

适用场景

  • 存档:从运营转发的分享短链直接取 MP4。
  • 批量:已有作品 ID 时用 feed_id 取地址;取不到再改用短链。
  • 质检:确认作品文件能播放,而不是只有标题。

请求参数

字段类型必填说明
export_id string 否 导出 ID。本接口不直接认,请先换成 feed_id。
feed_id string 否 作品 ID,纯数字。部分作品用作品 ID 换不到短链。
url string 否 视频号分享短链 https://weixin.qq.com/sph/…。与 feed_id、export_id 三选一,优先用它。

返回 data 字段

字段类型说明
download_urlstring可播放的视频地址。
expires_atstring失效时间。平台经常不给,为空时请尽快下载。

调用示例

curl -X POST https://www.xmedi.cn/api/v1/wechat/channels/feeds/download \
  -H "X-XMEDI-Key: xm_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"feed_id":"14991460993520372260"}'

调试

返回示例

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

{
  "download_url": "https://example.com/channels.mp4",
  "expires_at": ""
}

注意事项

  • feed_id 取不到时,先用视频号短链接接口拿到短链,再把短链作为 url 传入。
  • 作品不存在时不扣费。

常见错误码

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

常见问题

为什么 feed_id 有时失败?
一部分作品无法从作品 ID 换出短链。改传分享短链 url。
地址能放多久?
带时效,但经常没有 expires_at。不要长期保存这个地址,应马上下载。
调用失败会扣费吗?
作品不存在或三种 ID 都无效时不扣费。

相关接口

需要接入这个接口?

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

免费注册
×

微信号 xmedi369