开放 API · Open Platform

把 97盘搜的
搜索能力接入你的产品

一个 Key，聚合六大网盘资源搜索与资源批量导入。每日 1,000 次以内免费，导入不限条数，具体价格联系管理员。

1,000 次/日免费六大网盘官方直连

cURL · Python · Node

# Base: https://pansoo.net
GET /open/v1/search?q=三体&limit=20
Authorization: Bearer ps_live_xxx

# 200 OK · 只返回原始链接
{
  "success": true,
  "data": {
    "total": 1234,
    "items": [
      {
        "resource_id": 123456,
        "original_url": "https://pan.quark.cn/s/..."
      }
    ]
  },
  "quota": { "remaining": 11760 }
}

Capabilities

从搜索到入库，一条 API 链路

聚合搜索

百度、夸克、阿里、迅雷、123、115 六大网盘一次查询，支持分页、筛选、排序和精确搜索。

原始链接

只返回资源入库时的 original_url，不做跳转、转存或实时有效性检测，响应更快、更轻。

资源导入

一次最多 100 条网盘分享链接，异步去重入库；导入不限条数，不做 Key 级 QPS/并发限制。

密钥与配额

每个 Key 独立日搜索配额、IP 白名单、到期时间；停用/轮换即时生效。

Pricing

按日调用阶梯，具体价格联系管理员

每日 1,000 次以内免费；付费版按峰值日调用选档，日上限硬限流，具体报价联系管理员。

邮件咨询价格

免费版

个人工具、验证想法

免费

1,000 次/日以内

1,000 次搜索 / 日

导入不限条数

7 天日志 · 社区支持

免费申请

基础版

小团队、单一产品

联系询价

按日调用上限选档

5,000 次搜索 / 日

导入不限条数

30 天日志 · 邮件支持

邮件咨询

把提示词发给 AI，
自动生成接入代码

复制这段提示词，粘贴到 ChatGPT / Claude / DeepSeek，填上你的语言和框架。AI 会按契约生成 client、错误处理、重试和测试。

包含认证、搜索、导入、批次、错误码

要求处理 429、分页、幂等和 Key 安全

附验收清单，生成后跑 3 个测试即可验证

提示词只使用 <YOUR_API_KEY> 占位；不要把真实 Key 发给公共 AI。泄露后立即在后台轮换。

ai-integration-prompt.md

你是资深 <LANGUAGE> 工程师，请帮我把「97盘搜开放 API」接入一个 <FRAMEWORK> 项目。接入目标：<USE_CASE>。

Base URL: https://pansoo.net/open/v1
认证头: Authorization: Bearer <YOUR_API_KEY>
Key 只能从环境变量读取，绝不能写死在前端、日志或提交记录里。
接入前先调用 GET /me 验证 Key，返回额度/权限/到期；401 就停止。

接口 1：GET /search
参数：q（必填）、page、limit（免费最大 20，付费最大 50）、pan_types、file_type、sort_by、sort_order、exact、time_filter。
返回 data.items[]，字段含 resource_id、title、pan_type、file_size、original_url。
搜索只返回原始链接（original_url），不返回 share_url/share_pwd/verified_status/link_status/expiry_date，也不做有效性检测。
每次请求计 1 次配额，不按条数累加。

接口 2：POST /resources（可选，资源导入）
Body: {"items":[{"url":"https://...","title":"可选"}]}
单次最多 100 条；导入不设日条数上限，也不做 QPS/并发限制。
返回 202 + batch_id；当前版本不做服务端幂等去重，客户端自行避免重复提交。

必须实现：
1. 从环境变量读 PANSO_API_KEY、PANSO_API_BASE_URL，提供 .env.example。
2. 封装 API client：超时、429 退避（读 Retry-After）、错误码映射、request_id 日志。
3. 分页；limit 不超过 50（免费 20）。
4. 处理 401/403/429/503；不要自行判断链接有效性。
5. 不打印完整 Key、Authorization。
6. 前端不要让浏览器直连 API，用后端代理。
7. 输出 3 个测试：成功搜索、401/429、资源导入提交。
先问我最多 3 个必要问题，不要臆造字段；然后给出目录结构、完整代码、.env.example、运行命令、测试和排障说明。

FAQ