[P081]专利/论文智能检索

post
https://connect.zhihuiya.com/search-agent/rag/v4/search
在体验中心中试用

专利与学术论文智能混合检索接口。支持三种检索策略的自由组合：语义检索（semantic）、关键词检索（keyword）、结构化过滤（filter）。每次请求指定单一数据源（patent或paper），返回按相关性排序的文档列表，支持分页。

支持语义检索、关键词检索和结构化过滤的混合检索。每次请求只能指定一个数据源（patent 或 paper），若需同时检索两者请分别调用。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
search_strategy
array[ "keyword", "filter", "semantic" ]
检索策略组合。允许值：'semantic'、'keyword'、'filter'。 策略与参数绑定严格： - 'semantic' 在策略中 → 必须提供 semantic_query - 'keyword' 在策略中 → 必须提供 keywords - 'filter' 在策略中 → 必须提供 filters（至少设置1个字段） 默认值：['keyword']
semantic_query
stringHow to improve lithium-ion battery cathode material cycle stability and rate performance through material modification
自然语言语义查询句。必须为完整句子，不能是关键词列表。仅当 search_strategy 包含 'semantic' 时提供。
keywords
array[ "6G", "毫米波", "beamforming", "massive MIMO" ]
BM25关键词列表，推荐3-8个独立技术术语。仅当 search_strategy 包含 'keyword' 时提供。不要超过15个关键词。
filters
objectPlease check the form: Filter
结构化过滤条件。仅当 search_strategy 包含 'filter' 时提供，且至少设置一个字段。只设置用户明确指定的字段，不要推测。
assignees
array[ "华为", "Huawei" ]
专利申请人或论文机构名称。注意避免包含关系冗余：'华为' 已匹配 '华为技术有限公司'。
jurisdiction
array[ "CN", "US" ]
专利受理局国家代码（ISO 3166-1 两字母）。常用：CN, US, EP, WO, JP, KR, GB。
ipc
array[ "H04W72/04" ]
IPC分类号，支持大类或具体分类号。常见：H04W（无线通信）、A61K（医药）、H01L（半导体）。
legal_status
array[ "active" ]
专利法律状态。允许值：'active'（有效）、'inactive'（失效）、'pending'（审查中）。
date_from
integer<int32>20230101
起始日期（含），格式YYYYMMDD。不得晚于date_to。
date_to
integer<int32>20241231
截止日期（含），格式YYYYMMDD。不得早于date_from。
date_type
stringpublication
过滤的日期字段类型。允许值：'publication'（公开日，默认）、'application'（申请日）、'granted'（授权日）、'priority'（优先权日）、'expired'（失效日）。
inventors
array[ "张伟", "John Smith" ]
发明人（专利）或作者（论文）名称，支持中英文。
cited_min
integer<int32>50
最低被引次数，用于筛选高影响力专利。
source
必填
stringpatent
数据源选择（必填，单值）。允许值：'patent'（全球专利数据）、'paper'（学术论文）。每次请求只能指定一个数据源，若需同时检索请分别调用。
limit
integer<int32>20
每页返回结果数量，范围1-100，默认10。与offset配合实现分页，约束：offset + limit ≤ 1000。
offset
integer<int32>-
分页偏移量，跳过前N条结果，默认0。约束：offset + limit ≤ 1000（Vespa分页深度限制）。

响应结构

API 响应数据的结构说明

字段名类型示例描述
data
object{ "docs": [ { "id": "da3c349f-cbb2-43a0-9d39-29e6d48c966c", "doi": "10.1109/ACCESS.2023.1234567", "ipc": "H04B7/15", "url": "https://eureka.zhihuiya.com/view/#/fullText'figures/?patentId=ee0e5dbb-b43a-4eae-84e1-b58afd583a34", "text": "本发明提供一种定向天线及含有外接天线接口的终端设备...", "score": 0.85, "title": "一种定向天线及含有外接天线接口的终端设备", "authors": [ "Zhang Wei", "Li Ming" ], "assignees": [ "KT CORPORATION" ], "inventors": [ "LEE, JONG-SIK", "PYUN, SUNG-YEOP" ], "org_names": [ "Tsinghua University", "MIT" ], "datasource": "patent", "cited_count": 2, "expired_date": 20380707, "granted_date": 20200901, "journal_name": "IEEE Access", "jurisdiction": "US", "legal_status": "active", "patent_number": "CN121537748A", "priority_date": 20160707, "application_date": 20170707, "publication_date": 20200901 } ], "total_hits": 1250, "returned_count": 20 }
检索结果数据
docs
array[ { "id": "da3c349f-cbb2-43a0-9d39-29e6d48c966c", "doi": "10.1109/ACCESS.2023.1234567", "ipc": "H04B7/15", "url": "https://eureka.zhihuiya.com/view/#/fullText'figures/?patentId=ee0e5dbb-b43a-4eae-84e1-b58afd583a34", "text": "本发明提供一种定向天线及含有外接天线接口的终端设备...", "score": 0.85, "title": "一种定向天线及含有外接天线接口的终端设备", "authors": [ "Zhang Wei", "Li Ming" ], "assignees": [ "KT CORPORATION" ], "inventors": [ "LEE, JONG-SIK", "PYUN, SUNG-YEOP" ], "org_names": [ "Tsinghua University", "MIT" ], "datasource": "patent", "cited_count": 2, "expired_date": 20380707, "granted_date": 20200901, "journal_name": "IEEE Access", "jurisdiction": "US", "legal_status": "active", "patent_number": "CN121537748A", "priority_date": 20160707, "application_date": 20170707, "publication_date": 20200901 } ]
检索结果文档列表，按相关性评分降序排列
id
必填
stringda3c349f-cbb2-43a0-9d39-29e6d48c966c
文档唯一标识，专利为uuid格式的patent_id，论文为内部vector_id
doi
string10.1109/ACCESS.2023.1234567
论文DOI唯一标识
ipc
stringH04B7/15
专利IPC主分类号
url
stringhttps://eureka.zhihuiya.com/view/#/fullText'figures/?patentId=ee0e5dbb-b43a-4eae-84e1-b58afd583a34
文档详情页链接
text
string本发明提供一种定向天线及含有外接天线接口的终端设备...
文档摘要或正文片段
score
number0.85
相关性评分（经RRF归一化，最高1.0）
title
string一种定向天线及含有外接天线接口的终端设备
专利或论文标题
authors
array[ "Zhang Wei", "Li Ming" ]
论文作者列表
assignees
array[ "KT CORPORATION" ]
专利申请人列表
inventors
array[ "LEE, JONG-SIK", "PYUN, SUNG-YEOP" ]
专利发明人列表
org_names
array[ "Tsinghua University", "MIT" ]
论文机构名称列表
datasource
stringpatent
数据来源类别：patent、paper
cited_count
integer2
被引用次数
expired_date
integer20380707
专利失效日，格式YYYYMMDD
granted_date
integer20200901
专利授权日，格式YYYYMMDD
journal_name
stringIEEE Access
论文期刊名称
jurisdiction
stringUS
专利受理局
legal_status
stringactive
专利法律状态: active, inactive, pending
patent_number
stringCN121537748A
专利号码
priority_date
integer20160707
专利最早优先权日，格式YYYYMMDD
application_date
integer20170707
专利申请日，格式YYYYMMDD
publication_date
integer20200901
专利公开日，格式YYYYMMDD
total_hits
integer1250
检索命中文档总数
returned_count
integer20
实际返回的文档数量，取决于limit参数
status
stringsuccess
检索结果状态，success: 成功，error: 失败
error_message
stringInvalid search strategy combination
错误提示信息，仅当 status=error 时有效

成功响应示例

成功调用 API 的响应示例

JSON 
{
  "data": {
    "docs": [
      {
        "id": "da3c349f-cbb2-43a0-9d39-29e6d48c966c",
        "doi": "10.1109/ACCESS.2023.1234567",
        "ipc": "H04B7/15",
        "url": "https://eureka.zhihuiya.com/view/#/fullText'figures/?patentId=ee0e5dbb-b43a-4eae-84e1-b58afd583a34",
        "text": "本发明提供一种定向天线及含有外接天线接口的终端设备...",
        "score": 0.85,
        "title": "一种定向天线及含有外接天线接口的终端设备",
        "authors": [
          "Zhang Wei",
          "Li Ming"
        ],
        "assignees": [
          "KT CORPORATION"
        ],
        "inventors": [
          "LEE, JONG-SIK",
          "PYUN, SUNG-YEOP"
        ],
        "org_names": [
          "Tsinghua University",
          "MIT"
        ],
        "datasource": "patent",
        "cited_count": 2,
        "expired_date": 20380707,
        "granted_date": 20200901,
        "journal_name": "IEEE Access",
        "jurisdiction": "US",
        "legal_status": "active",
        "patent_number": "CN121537748A",
        "priority_date": 20160707,
        "application_date": 20170707,
        "publication_date": 20200901
      }
    ],
    "total_hits": 1250,
    "returned_count": 20
  },
  "status": true,
  "error_code": 0,
  "error_message": "Invalid search strategy combination"
}

错误码

此接口可能返回的错误码列表

业务错误码

错误码描述
68300004请求参数异常!
68300005查询Api失败!
68300006解析基本存取错误!
68300007存在错误的请求!
68300008服务中断异常，请稍后再试!
68300010文件不符合上传规范!

平台错误码

错误码描述
67200000API整体限流错误!
67200001API整体限流错误！
67200002当前调用速率过快,超过当前配置限制QPS！
67200003申请token的key和secret传参不正确或者客户端已被禁用！
67200004请求的接口无权限请联系我们的支持人员！
67200005账户余额/调用次数不足！
67200006客户端超过开通有效期！
67200007当前调用超过当天配置使用额度！
67200008请检查query参数中必填的apikey是否传输！
67200009apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token！
67200012请求不合法！
67200100当前服务器状态正忙,请求响应超时！
67200101当前请求的Api不存在请检查请求Path！

HTTP 状态码

状态码描述
0请求成功
422Validation Error

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms