📊 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编码,无需手动转码