专利数据查询 API · 接口说明

#接入地址

线上地址如下；本地调试用 http://localhost:3001。

BASE URL

https://api.shanchuanlingyu.cn

所有接口均为 GET，无需鉴权。请求频率限制为每个 IP 每秒 5 次，超限返回 429。

#单个专利查询

按完整专利号返回该专利的价格与状态详情。

GET /api/patent/{patentNo}

专利号必须是 13 位数字，可带 CN 前缀。传入其他长度会直接返回 400 并提示补全。

参数	位置	说明
`patentNo`	path	13 位专利号，或 `CN` + 13 位。示例：`2026112415465`、`CN2026112415465`

请求示例

curl "https://api.shanchuanlingyu.cn/api/patent/CN2026112415465"

响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "patent_no": "2026112415465",
    "patent_name": "一种基于组串结构指纹的光伏电站地图构建及智能运维方法及系统",
    "patent_type": 2,
    "patent_type_text": "发明下证",
    "field": "光伏电站 新能源",
    "guide_price": 15000,
    "guide_price_text": "15000 元",
    "high_tech": 1,
    "high_tech_text": "是",
    "payment_date": "新授权",
    "remarks": "特价（缴费下证中）",
    "reservation_deadline": null,
    "is_reserved": false
  },
  "Remark": "如对以上专利感兴趣 可对接 韩经理 tel:13115103626 苏州科瑞特知识产权代理有限公司 本服务免费 请勿频繁请求"
}

#专利名称匹配

输入专利名称查询对应专利。有 100% 一致的名称时只返回该条；否则模糊匹配，多个结果按最接近程度排序，最多返回 10 条。

GET /api/patent/name/{专利名称}

参数	位置	说明
`name`	path	专利名称（需 URL 编码），≤120 字。输入中的空格、标点、多余前后缀（如末尾数字）会被自动容错

匹配规则：输入先做清洗（去除空白与标点）；先尝试完全匹配（match_type=exact，返回 1 条），未命中再模糊匹配（match_type=fuzzy，最多 10 条）；都不命中返回 404。

请求示例

curl "https://api.shanchuanlingyu.cn/api/patent/name/一种水泥电杆生产用泥沙筛洗器"

响应示例

{
  "code": 0,
  "message": "ok",
  "match_type": "exact",
  "match_type_text": "完全匹配",
  "data": [
    {
      "patent_no": "202522650214X",
      "patent_name": "一种水泥电杆生产用泥沙筛洗器",
      "patent_type": 3,
      "patent_type_text": "实用未下证",
      "field": "水泥杆，电线杆，建筑，电力，电网",
      "guide_price": 4299,
      "guide_price_text": "4299 元",
      "high_tech": 1,
      "high_tech_text": "是",
      "payment_date": "2026-12-14",
      "remarks": null,
      "reservation_deadline": "2026-10-29T00:48:00.000Z",
      "is_reserved": true
    }
  ],
  "Remark": "如对以上专利感兴趣 可对接 韩经理 tel:13115103626 苏州科瑞特知识产权代理有限公司 本服务免费 请勿频繁请求"
}

#筛选检索（分页）

不传任何筛选条件即全库检索；多个条件之间为 AND 关系。

GET /api/patents

参数	类型	说明
`keyword`	string	关键词，≤120 字。默认全库检索：专利号、专利名称、领域、备注
`scope`	enum	`all` 全库（默认）｜`name` 仅专利名称
`patent_type`	string	`invention`=发明（1、2）｜`utility`=实用（3、4）｜也可直接传 1-4。支持重复参数或逗号分隔
`high_tech`	string	高企申报：`是` / `否`（也接受 1 / 0）
`min_price`	number	最低价格（元），≥0
`max_price`	number	最高价格（元），≥0
`field`	string	领域关键词，≤100 字，模糊匹配
`page`	number	页码，默认 1。每页固定 10 条，不支持 20 / 30

分页说明：响应中的 pagination.total 为命中总数，totalPages 为总页数；超出末页返回空数组。

请求示例：发明 + 高企 + 1 万到 3 万 + 领域“光伏”

curl "https://api.shanchuanlingyu.cn/api/patents?patent_type=invention&high_tech=是&min_price=10000&max_price=30000&field=光伏&page=1"

响应示例

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "patent_no": "2026112415465",
      "patent_name": "一种基于组串结构指纹的光伏电站地图构建及智能运维方法及系统",
      "patent_type": 2,
      "patent_type_text": "发明下证",
      "field": "光伏电站 新能源",
      "guide_price": 15000,
      "guide_price_text": "15000 元",
      "high_tech": 1,
      "high_tech_text": "是",
      "payment_date": "新授权",
      "remarks": "特价（缴费下证中）",
      "reservation_deadline": null,
      "is_reserved": false
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 10,
    "total": 1,
    "totalPages": 1
  },
  "Remark": "如对以上专利感兴趣 可对接 韩经理 tel:13115103626 苏州科瑞特知识产权代理有限公司 本服务免费 请勿频繁请求"
}

#返回字段

后端已做类型清洗：价格转数字、空值得空、日期统一格式，并附带中文说明字段。

字段	类型	中文说明
`patent_no`	string	专利号（13 位，不含 CN 前缀）
`patent_name`	string	专利名称
`patent_type`	number	类型代码：1 发明未下证、2 发明下证、3 实用未下证、4 实用下证
`patent_type_text`	string	类型中文名
`field`	string	技术领域
`guide_price`	number \| null	指导价格（元），`null` 表示面议
`guide_price_text`	string	价格显示文本，如 “15000 元” / “面议”
`high_tech`	number	高企申报：1 是、2 否
`high_tech_text`	string	高企申报中文：是 / 否 / 未标注
`payment_date`	string \| null	缴费日期，可能为“新授权”等文本
`remarks`	string	备注
`reservation_deadline`	string \| null	预留截止时间，ISO 8601（UTC）
`is_reserved`	boolean	是否已有预留（存在预留截止时间即为 true）
`Remark`	string	固定附带的联系信息，两个接口的所有响应（含 400 / 404 / 429）都包含

#错误码

错误同样返回 JSON，HTTP 状态码与 code 一致。

状态码	含义
`400`	参数不合法（专利号长度、价格区间等）
`404`	专利不存在，或接口路径错误
`429`	超过 5 QPS 限制
`500`	服务器内部错误

错误示例

{
  "code": 400,
  "message": "请输入完整的13位专利号，或 CN+13位专利号（例如：CN2026112415465）"
}