📊 API累计有效搜索调用次数:加载中...
网盘短剧资源搜索 API 接口文档
一、基础接口地址
GET 请求地址:https://pan.shurongshequ.com/api.php
接口仅支持 GET 方式调用,跨域开放,可直接在前端、第三方站点请求
二、请求参数说明
| 参数名 |
是否必填 |
类型 |
说明 |
| token |
必填 |
字符串 |
接口访问密钥,固定值:pan |
| kw |
必填 |
字符串 |
搜索关键词,中文/英文均可,自动模糊匹配标题、关键词字段 |
| page |
选填 |
数字 |
分页页码,默认 1,最小 1 |
| page_size |
选填 |
数字 |
每页条数,默认20,最大限制50,超过50自动截断 |
三、完整调用示例
示例:搜索关键词「修仙」第1页,每页20条
https://pan.shurongshequ.com/api.php?token=pan&kw=%E4%BF%AE%E4%BB%99&page=1&page_size=20
四、返回数据结构说明
外层通用字段
| 字段 |
含义 |
| code |
状态码:0=成功;负数=错误 |
| msg |
状态描述文字 |
| debug.fulltext_used |
内部调试字段,true=全文索引、false=兼容LIKE模糊查询 |
| data.total |
匹配资源总条数 |
| data.page |
当前页码 |
| data.page_size |
每页返回条数 |
| data.total_page |
总页数 |
资源分组 merged_by_type
| 分组key |
说明 |
| quark |
夸克网盘资源数组 |
| baidu |
百度网盘资源数组(当前主要数据) |
| xunlei |
迅雷网盘资源数组 |
单条资源字段
| 字段 |
含义 |
| note |
资源标题 |
| url |
网盘完整分享链接(含提取码) |
| vod_pic |
封面图片地址,无数据为空字符串 |
| vod_content |
资源简介描述 |
| description |
配套搜索关键词 |
| datetime |
资源入库时间 |
五、成功返回示例(kw=修仙)
{
"code": 0,
"msg": "success",
"debug": {
"fulltext_used": false
},
"data": {
"total": "165",
"page": 1,
"page_size": 20,
"total_page": 9,
"merged_by_type": {
"quark": [],
"baidu": [
{
"note": "修仙归来,我即至尊(84集)胡耀&叶一宁",
"url": "https:\/\/pan.baidu.com\/s\/1YqyzQohGmfWwwGseJyzizQ?pwd=6666",
"vod_pic": "",
"vod_content": "",
"description": "",
"datetime": "2026‑08‑04 22:45:29"
}
],
"xunlei": []
}
}
}
六、错误码对照表
调用异常时返回 code 不为0,msg 给出文字提示
| code |
错误信息 |
解决办法 |
| -1 |
token错误,禁止访问 |
token参数必须传入 pan |
| -2 |
kw搜索关键词不能为空 |
补全kw参数,不能空 |
| -3 |
数据库连接失败 |
检查数据库账号密码、服务状态 |
错误返回示例(token错误)
{
"code": -1,
"msg": "token错误,禁止访问"
}
七、调用注意事项
1. 接口无IP限制,第三方网站、小程序、前端均可直接调用
2. page_size最大50,传入超过50会自动限制为50
3. 无结果时对应分组数组为空 []
4. 数据量大后可开启Redis缓存,大幅降低数据库压力
5. 关键词为中文时浏览器会自动URL编码,无需手动转码