迅雷网盘高级转存接口

最后更新:2025-10-10

接口介绍

高级转存接口:迅雷网盘分享链接的高级转存处理工具,集成了文件转存、分享、广告过滤、广告添加、去重处理等多种功能。适用于需要批量处理和自动化管理的场景。

特色功能

智能去重处理:5种去重方式,灵活处理重复文件

广告文件过滤:异步过滤广告,支持全局/Cookie级别规则

广告文件添加:支持添加广告文件到转存目录

文件夹创建:单文件支持自动创建文件夹

使用场景

内容净化:过滤掉不需要的广告和推广文件

推广管理:在转存的同时添加自己的推广文件

批量处理:大量文件的智能过滤和处理

内容分发:为转存的内容添加推广信息

使用网盘Cookie提取工具获取

下载并打开:网盘Cookie提取工具

按照工具提示登录迅雷网盘

自动获取Cookie并复制

在用户中心的Cookie管理页面中,将复制的Cookie粘贴到添加Cookie输入框,保存即可

注意:迅雷网盘Cookie只能走软件抓取(若软件打不开请联系站长协助),有效期理论永久,Cookie托管到平台以后在本地浏览器上尽量不要登录了,可以使用APP或者软件管理,过期需要重新获取。

接口信息

接口地址:https://api.ccnccn.cn/xunlei_senior?

请求方式:GET

返回格式:JSON

调用频率:1/1S

接口状态:正常运行中

请求参数

参数名必选类型说明
tokenstring用户调用接口token,在用户中心-个人信息获取
cookieint值为cookie管理中的ID,请注意对应关系,填写迅雷的cookie ID
urlstring迅雷网盘分享链接,例如:https://pan.xunlei.com/s/xxxxx&pwd=xxxx
fidstring保存到指定目录的ID,Cookie管理-刷新目录内获取,默认保存到根目录“/”
privboolean是否允许转存特权文件(24小时加速下载的文件,没有收益),true或false,默认true
shareboolean是否创建分享链接,true或false,默认false
timestring分享有效期,-1(永久)或1-7(天数),默认-1,仅在share=true时有效
repeatint去重方式,1-5之间的整数,默认1。详见下方说明
ad_scopestring广告过滤范围,all/cookie/global。详见下方说明
ad_matchstring广告匹配模式,fuzzy/exact。详见下方说明
add_adboolean是否添加广告文件,true或false,默认false
create_folderboolean单文件是否创建文件夹,true或false,默认false

去重方式说明

去重方式说明
方式11删除原文件后再转存(默认)
方式22修改原文件名后再转存
方式33将原文件移动到待删除目录后再转存
方式44忽略删除原文件的错误,继续转存
方式55纯转存模式,不检测重复文件,不记录到数据库

广告过滤说明

广告过滤功能"默认开启"且使用"异步处理模式"以确保响应速度。

参数选项说明
ad_scopeall使用全局+Cookie级别的广告规则(默认)
ad_scopeglobal仅使用全局广告规则
ad_scopecookie仅使用Cookie级别的广告规则
ad_matchfuzzy模糊匹配(包含关键词即匹配,默认)
ad_matchexact精确匹配(文件名完全相同才匹配)

响应参数

参数名类型说明
successboolean请求是否成功
messagestring提示信息
dataobject返回数据
data.file_namestring文件名称
data.fs_idstring文件ID(仅转存时返回)
data.share_urlstring分享链接(仅share=true时返回)
data.pwdstring提取码(仅share=true时返回)
data.timestring分享有效期(仅share=true时返回)
data.ad_filter_modestring广告过滤模式,固定为async
data.ad_filter_task_idstring广告过滤任务ID
data.ad_filter_detailsobject广告过滤详细信息,包含规则数量和规则示例
data.ad_files_infoobject添加广告文件的详细信息
data.skipped_filestring跳过的重复文件名

示例请求

基础转存(删除重复文件)

https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX

转存并分享7天

https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX&share=true&time=7

转存并分享7天(过滤广告,模糊匹配)

https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX&share=true&time=7&ad_match=fuzzy

仅使用全局广告规则过滤 + 添加广告文件

https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX&add_ad=true&ad_scope=global

纯转存模式(不记录历史)

https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX&repeat=5

单文件创建文件夹 + 重命名去重

https://api.ccnccn.cn/xunlei_senior?token=your_token&cookie=1&url=https://pan.xunlei.com/s/VOCNXH9-XXXXXXXXX&create_folder=true&repeat=2

示例响应

仅转存成功

{

"success": true,

"message": "转存成功",

"data": {

"file_name": "测试文件合集",

"fs_id": "VOS9VSWs-BcLGG6oEI73hJVLA1"

}

}

转存并分享 + 广告过滤成功

{

"success": true,

"message": "转存并分享成功,广告文件过滤任务已提交(异步处理中)",

"data": {

"file_name": "测试文件合集",

"share_url": "https://pan.xunlei.com/s/xxxxxx",

"pwd": "3eyq",

"time": "7",

"ad_filter_mode": "async",

"ad_filter_task_id": "task_12345",

"ad_filter_details": {

"ad_rules_count": 15,

"ad_rules": ["广告", "推广", "QQ群", "微信", "链接"]

}

}

}

转存 + 广告过滤 + 添加广告文件成功

{

"success": true,

"message": "转存成功,广告文件过滤任务已提交(异步处理中),成功添加2个广告文件,失败0个",

"data": {

"file_name": "测试文件合集",

"fs_id": "VOS9VSWs-BcLGG6oEI73hJVLA1",

"ad_filter_mode": "async",

"ad_filter_task_id": "task_12345",

"ad_filter_details": {

"ad_rules_count": 20,

"ad_rules": ["广告.txt", "推广.url", "QQ群.txt", "微信.txt", "链接.txt"]

},

"ad_files_info": {

"copied_ad_files": 2,

"failed_ad_files": 0,

"input_ad_file_ids": ["VO1qjfCD8MQZ19WbsUPMwpQhA1", "VO2rjgDE9NRa20XctVQNxqRiB2"]

}

}

}

调用接口报错

{

"success": false,

"message": "错误信息",

"data": null

}

错误码说明(持续更新)

错误信息说明解决方案
参数错误: 缺少token参数未提供用户token在用户中心获取token
参数错误: 缺少cookie参数,请指定要使用的cookie ID未提供Cookie ID检查cookie参数是否正确传递
参数错误: 缺少url参数未提供分享链接检查url参数是否正确传递
参数错误: priv参数只能是true或falsepriv参数值错误修正参数值为true或false
参数错误: share参数只能是true或falseshare参数值错误修正参数值为true或false
参数错误: filter_ad参数只能是true或falsefilter_ad参数值错误修正参数值为true或false
参数错误: ad_scope参数只能是all、cookie或globalad_scope参数值错误使用正确的广告过滤范围
参数错误: ad_match参数只能是fuzzy或exactad_match参数值错误使用正确的广告匹配模式
分享时间格式不正确,只能是-1(永久)或1-7(天)中的一个分享时间参数错误设置正确的分享有效期
去重方式不正确,只能是1\2\3\4\5中的一个repeat参数值错误使用正确的去重方式
ID为X的Cookie类型错误,应为迅雷网盘(xunlei),实际为YCookie类型不匹配确保使用的是迅雷网盘Cookie
ID为X的迅雷网盘Cookie不存在,请到Cookie管理检查Cookie不存在在Cookie管理中添加对应的Cookie
ID为X的迅雷网盘Cookie已失效,请到Cookie管理重新设置Cookie已失效重新获取并更新Cookie
无效的分享链接格式,请提供正确的迅雷网盘分享链接分享链接格式错误检查分享链接是否正确
未设置要添加的广告文件ID,请先在Cookie管理中设置广告文件ID(用于向文件夹添加广告文件)广告文件ID未设置在Cookie管理中设置广告文件ID
未设置广告文件过滤规则,请先在Cookie管理中设置广告文件规则(用于识别和过滤广告文件)广告过滤规则未设置在Cookie管理中设置广告过滤规则
分享内容为单文件或多个独立文件不支持添加广告文件,只有文件夹才支持分享内容不支持添加广告文件使用create_folder=true创建文件夹,或转存包含文件夹的分享
未设置待删除目录,请先在Cookie管理中设置待删除目录未设置在Cookie管理中设置待删除目录(去重方式3需要)
Token无效或账号已被封禁token错误或账号状态异常检查token是否有效,或联系客服
调用次数已用完或已过期超出调用限制或已过期联系站长加次数和时间
转存失败: XXX转存过程出错检查参数重试
分享失败: XXX分享过程出错检查参数重试
去重失败: XXX去重处理失败检查去重设置或重试

注意事项

使用过滤广告功能,需要在Cookie管理中预先设置过滤规则。

使用添加广告功能,需要先在Cookie管理中设置广告文件ID。

请确保Cookie有效,检测状态正常,否则可能导致调用失败。

异步过滤操作在后台进行,接口不会立即返回过滤结果。

过滤广告文件不可恢复,请谨慎设置过滤规则避免删掉需要的文件。

使用浏览器调用时,请勿给参数里带#(浏览器会忽略#后面的所有参数导致调用失败)

每个账号有调用次数和有效期限制,可联系站长购买套餐。

更新日志

2025-11-08:完善API文档,增强用户体验

2025-11-07:移除同步过滤模式,统一使用异步模式,确保接口时效性

2025-10-08:优化处理逻辑,加快响应速度

2025-09-28:接口上线,使用分散架构设计