接口基本信息

GET

https://www.soxunleipan.com/api/search

本API可免费调用,欢迎开发者接入使用。请确保您的使用行为遵守相关法律法规,禁止用于任何违法、违规、侵犯他人权益或违反公序良俗的用途。一经发现,将依法依规处理。

请求参数

所有参数均通过URL查询字符串传递。

参数名 类型 是否必须 默认值 说明
keyword string 必需 - 搜索关键词
page int 可选 1 页码,从1开始
pageSize int 可选 30 每页显示数量,最多20条
sort int 可选 - 排序方式:
  • 1: 文件大小降序
  • 2: 文件大小升序
  • 3: 分享日期降序
  • 4: 分享日期升序

返回结果

响应格式

API返回JSON格式的数据。

响应字段说明

字段名 类型 说明
code int 状态码,200表示成功
msg string 操作消息
total int 总记录数
page int 当前页码
size int 每页大小
list array 数据列表

list中的对象字段

字段名 类型 说明
title string 标题
filePath string 文件路径
md5Id string 数据MD5标识
fileExtension string 文件扩展名
size string 文件大小
shareDate string 分享日期
shareId string 分享链接

示例

请求示例
GET /api/search?keyword=电影&page=1&pageSize=10&sort=3
响应示例
{
  "code": 200,
  "msg": "操作成功",
  "total": 9,
  "page": 1,
  "size": 30,
  "totalPages": 1,
  "list": [
    {
      "title": null,
      "filePath": null,
      "md5Id": null,
      "fileExtension": null,
      "size": "未知",
      "shareDate": "0001-01-01",
      "shareId":"https://pan.xunlei.com/s/VOZWoyvE_sI8q4Zki0lsBZaTA1",
    }
  ]
}

错误码

错误码 说明
200 成功
400 参数错误
500 服务器内部错误

API文档版本 1.0 | 最后更新: 2026年