开放 API 文档
盘搜索 的索引库通过 HTTP API 免费开放查询与回传。所有接口无需注册（采集回传除外）。
Base URL
https://www.pansousuo.comGET/api/search资源搜索
查询索引库中的资源，支持多维筛选与分页。命中内容安全词时返回空结果与 blocked 标记。
| Query 参数 | 类型 | 说明 |
|---|---|---|
| q | string | 关键词，支持 "精确短语" 与 -排除词（最长 60 字） |
| pan | string | 网盘类型：quark / baidu / aliyun / xunlei / uc / tianyi / 115 / 123 / mobile / other |
| cat | string | 类目：movie / tv / anime / book / novel / software / course / music / doc / other |
| sort | string | 排序：latest（默认）/ hot / year / size |
| mode | string | 匹配模式：fuzzy（默认）/ exact / dedupe |
| year | int | 年份精确筛选（1800-2100） |
| since | string | 入库时间：30d / 365d |
| size | string | 体积档位：s(<1GB) / m(1-10GB) / l(10-50GB) / xl(>50GB) |
| quality | string | 画质：4k / 1080p / 720p |
| tag | string | 标签包含匹配（最长 24 字） |
| p | int | 页码，默认 1 |
| src | string | remote = 先实时聚合全网盘再查索引库（需配置采集引擎） |
示例试一下
/api/search?q=三国演义&pan=quark&sort=hot响应
{ "items": [{ "id": 1, "title": "…", "pan": "quark", "share_url": "…", "access_code": "…" }], "total": 42, "page": 1, "pageSize": 30, "totalPages": 2, "aggregated": 0, "aggregateEnabled": false }GET/api/suggest搜索联想
热搜词 + 作品名前缀匹配，默认返回 JSON 数组；format=os 输出 OpenSearch Suggestions 格式。
| Query 参数 | 类型 | 说明 |
|---|---|---|
| q * | string | 前缀关键词 |
| format | string | os = OpenSearch [q, [...]] 格式 |
示例试一下
/api/suggest?q=三国&format=os响应
["三国", ["三国演义", "三国志"]]GET/api/resources/[id]资源详情
按 ID 获取资源详情与同作品相关推荐。
示例试一下
/api/resources/1响应
{ "item": { "id": 1, "title": "…" }, "related": [{ "id": 2, "title": "…" }] }GET/api/stats收录统计
收录总量、今日新增、按网盘与类目的分布（60s 缓存）。
示例试一下
/api/stats响应
{ "total": 1234, "today": 56, "byPan": { "quark": 800 }, "byCategory": { "movie": 300 } }POST/api/submit用户投稿
提交网盘分享链接收录，自动识别网盘类型并校验域名，按 share_url 去重（10 次/IP/小时）。
| Body 字段 | 类型 | 说明 |
|---|---|---|
| title * | string | 资源标题（2-100 字） |
| share_url * | string | 网盘官方域名分享链接 |
| pan * | string | 网盘类型（需与链接域名匹配） |
| access_code | string | 提取码 |
| category | string | 类目 |
示例
curl -X POST -H "Content-Type: application/json" -d '{"title":"示例","share_url":"https://pan.quark.cn/s/xxx","pan":"quark"}' https://www.pansousuo.com/api/submit响应
{ "ok": true, "id": 123, "existed": false }POST/api/feedback反馈与版权申诉
type=dead_link/wrong_info/other 为资源反馈；type=copyright 为版权删除申请（content 必填 10-2000 字，5 次/IP/小时）。
| Body 字段 | 类型 | 说明 |
|---|---|---|
| resource_id | int | 资源 ID（版权申诉可空） |
| type * | string | dead_link / wrong_info / other / copyright |
| content | string | 说明（copyright 必填） |
| contact | string | 联系方式（选填，最长 100 字） |
示例
curl -X POST -H "Content-Type: application/json" -d '{"resource_id":1,"type":"dead_link"}' https://www.pansousuo.com/api/feedback响应
{ "ok": true }POST/api/admin/resources采集回传
爬虫 / PanSou 兼容采集引擎批量回传（Bearer 鉴权，单批最多 500 条，字段校验失败自动剔除，按 share_url 去重）。
| Body 字段 | 类型 | 说明 |
|---|---|---|
| resources * | array | 资源数组：title / pan / share_url 必填，category / tags / size_text / year / access_code 选填 |
示例
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"resources":[{"title":"…","pan":"quark","share_url":"…"}]}' https://www.pansousuo.com/api/admin/resources响应
{ "ok": true, "imported": 480, "skipped": 20 }订阅与协议
- /feed.xml·RSS 订阅最新收录 30 条；?q=关键词 订阅指定词的最新资源
- /opensearch.xml·OpenSearch浏览器将本站添加为默认搜索引擎，联想走 /api/suggest?format=os
- /sitemap.xml·Sitemap静态入口 + 最新 500 条资源详情页
- /llms.txt·llms.txt面向 LLM / AI 搜索引擎的站点说明
使用限制
请合理控制调用频率，禁止用于抓取违规内容或对本站进行压力测试；商业用途或大批量调用请先通过版权与联系渠道沟通。