What is the endpoint for [P081]Patent/Paper Intelligent Search?

The [P081]Patent/Paper Intelligent Search endpoint is POST https://connect.patsnap.com/search-agent/rag/v4/search.

Where can I find the OpenAPI schema for [P081]Patent/Paper Intelligent Search?

The OpenAPI schema is available at /openapi.json#/paths/~1search-agent~1rag~1v4~1search/post. You can also browse the full specification at /openapi.json.

[P081]Patent/Paper Intelligent Search

Q: What data can [P081]Patent/Paper Intelligent Search return?

[P081]Patent/Paper Intelligent Search Intelligent hybrid search for patents and academic papers. Supports free combination of three retrieval strategies: semantic search, keyword search, and structured filtering. Each request targets a single data source (patent or paper), returning documents sorted by relevance with pagination support. See the Response Schema and Success Response Example on this page for the full structure.

post

https://connect.patsnap.com/search-agent/rag/v4/search

Try in Sandbox

Intelligent hybrid search for patents and academic papers. Supports free combination of three retrieval strategies: semantic search, keyword search, and structured filtering. Each request targets a single data source (patent or paper), returning documents sorted by relevance with pagination support.

Supports hybrid search combining semantic retrieval, keyword matching, and structured filtering. Each request targets exactly one data source (patent or paper). To cover both, issue two separate calls.

Request Parameters

List of parameters supported by this API endpoint

Name	Type	Example	Description
`search_strategy`	`array`	`[ "keyword", "filter", "semantic" ]`	Retrieval strategy combination. Allowed values: 'semantic', 'keyword', 'filter'. Strategy-param binding is STRICT: - 'semantic' in strategy → MUST provide semantic_query - 'keyword' in strategy → MUST provide keywords - 'filter' in strategy → MUST provide filters (≥1 field set) Default: ['keyword']
`semantic_query`	`string`	`How to improve lithium-ion battery cathode material cycle stability and rate performance through material modification`	A complete natural-language description of the technical problem or concept. MUST be a full sentence, never a keyword list. Required only when 'semantic' ∈ search_strategy.
`keywords`	`array`	`[ "6G", "毫米波", "beamforming", "massive MIMO" ]`	Keyword list for BM25 text matching. Recommended 3-8 independent technical terms. Required only when 'keyword' ∈ search_strategy. Do NOT pass 15+ keywords.
`filters`	`object`	`Please check the form: Filter`	Structured filter conditions. Required only when 'filter' ∈ search_strategy, with ≥1 field set. Only set fields the user explicitly states — do NOT infer or guess.
`assignees`	`array`	`[ "华为", "Huawei" ]`	Patent applicants or paper institution names. Avoid containment-relation redundancy: '华为' already matches '华为技术有限公司'.
`jurisdiction`	`array`	`[ "CN", "US" ]`	Patent office country codes (ISO 3166-1 alpha-2). Common: CN, US, EP, WO, JP, KR, GB.
`ipc`	`array`	`[ "H04W72/04" ]`	IPC class codes — broad (e.g. 'H04W') or specific (e.g. 'H04W72/04'). Common: H04W (wireless), A61K (pharma), H01L (semiconductor).
`legal_status`	`array`	`[ "active" ]`	Patent legal status. Allowed: 'active' (granted, in force), 'inactive' (lapsed/withdrawn/rejected), 'pending' (under examination).
`date_from`	`integer<int32>`	`20230101`	Start date (inclusive), format YYYYMMDD. Must not be later than date_to.
`date_to`	`integer<int32>`	`20241231`	End date (inclusive), format YYYYMMDD. Must not be earlier than date_from.
`date_type`	`string`	`publication`	Date field to filter on. Allowed: 'publication' (default), 'application', 'granted', 'priority', 'expired'.
`inventors`	`array`	`[ "张伟", "John Smith" ]`	Inventor names (patents) or author names (papers). Supports Chinese and English.
`cited_min`	`integer<int32>`	`50`	Minimum citation count — filters for high-impact patents.
`source` Required	`string`	`patent`	Data source selection (required, single value). Allowed: 'patent' (global patent data) or 'paper' (academic papers). Each request targets exactly one source; issue two calls to cover both.
`limit`	`integer<int32>`	`20`	Page size — number of results per page. Range: 1-100. Default: 10. Use with offset for pagination. Constraint: offset + limit ≤ 1000.
`offset`	`integer<int32>`	-	Pagination offset — number of leading results to skip. Default: 0. Constraint: offset + limit ≤ 1000 (Vespa pagination depth limit).

{
  "limit": 20,
  "offset": 0,
  "source": "patent",
  "filters": {
    "ipc": [
      "H04W72/04"
    ],
    "date_to": 20241231,
    "assignees": [
      "华为",
      "Huawei"
    ],
    "cited_min": 50,
    "date_from": 20230101,
    "date_type": "publication",
    "inventors": [
      "张伟",
      "John Smith"
    ],
    "jurisdiction": [
      "CN",
      "US"
    ],
    "legal_status": [
      "active"
    ]
  },
  "keywords": [
    "6G",
    "毫米波",
    "beamforming",
    "massive MIMO"
  ],
  "semantic_query": "How to improve lithium-ion battery cathode material cycle stability and rate performance through material modification",
  "search_strategy": [
    "keyword",
    "filter",
    "semantic"
  ]
}

Response Schema

Structure of the API response data

Field Name	Type	Example	Description
`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 }	Search result data
`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 } ]	Document list sorted by relevance score in descending order
`id` Required	`string`	`da3c349f-cbb2-43a0-9d39-29e6d48c966c`	Document unique ID. Patent: uuid-format patent_id; Paper: internal vector_id.
`doi`	`string`	`10.1109/ACCESS.2023.1234567`	Paper DOI identifier
`ipc`	`string`	`H04B7/15`	Patent IPC main classification code
`url`	`string`	`https://eureka.zhihuiya.com/view/#/fullText'figures/?patentId=ee0e5dbb-b43a-4eae-84e1-b58afd583a34`	Document detail page URL
`text`	`string`	`本发明提供一种定向天线及含有外接天线接口的终端设备...`	Document abstract or body excerpt
`score`	`number`	`0.85`	Relevance score (RRF normalized, max 1.0)
`title`	`string`	`一种定向天线及含有外接天线接口的终端设备`	Patent or paper title
`authors`	`array`	`[ "Zhang Wei", "Li Ming" ]`	Paper authors
`assignees`	`array`	`[ "KT CORPORATION" ]`	Patent assignees
`inventors`	`array`	`[ "LEE, JONG-SIK", "PYUN, SUNG-YEOP" ]`	Patent inventors
`org_names`	`array`	`[ "Tsinghua University", "MIT" ]`	Paper organization names
`datasource`	`string`	`patent`	Data source type: patent, paper
`cited_count`	`integer`	`2`	Citation count
`expired_date`	`integer`	`20380707`	Patent expiration date, format YYYYMMDD
`granted_date`	`integer`	`20200901`	Patent grant date, format YYYYMMDD
`journal_name`	`string`	`IEEE Access`	Paper journal name
`jurisdiction`	`string`	`US`	Patent jurisdiction (receiving office)
`legal_status`	`string`	`active`	Patent legal status: active, inactive, pending
`patent_number`	`string`	`CN121537748A`	Patent number
`priority_date`	`integer`	`20160707`	Patent earliest priority date, format YYYYMMDD
`application_date`	`integer`	`20170707`	Patent application date, format YYYYMMDD
`publication_date`	`integer`	`20200901`	Patent publication date, format YYYYMMDD
`total_hits`	`integer`	`1250`	Total number of matching documents
`returned_count`	`integer`	`20`	Actual number of documents returned, depends on limit parameter
`status`	`string`	`success`	Search status: 'success' or 'error'
`error_message`	`string`	`Invalid search strategy combination`	Error message, only present when status=error

Success Response Example

Example of a successful API response

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"
}

Error Codes

List of possible error codes returned by this endpoint

Business Errors

Error Code	Description
`68300004`	Invalid parameter!
`68300005`	Search api failure!
`68300006`	Analytic basic access error!
`68300007`	Bad request!
`68300008`	Service error, please try again later!
`68300010`	The file does not comply with upload specifications!

Platform Errors

Error Code	Description
`67200000`	API call exceeds the total limit set by the platform!
`67200001`	API call exceeds the total limit set by the platform!
`67200002`	The current call rate is too fast, exceeding the current configuration limit QPS!
`67200003`	The key and secret parameters for applying for the token are incorrect or the client has been disabled!
`67200004`	The requested api does not have permission. Please contact our support personnel!
`67200005`	Insufficient account balance/number of calls!
`67200006`	The client has exceeded the activation validity period!
`67200007`	The current call exceeds the configured usage limit of the day!
`67200008`	Please check if the required apikey in the query parameter has been transmitted!
`67200009`	The apikey does not match the passed bearerToken. Please check if a valid token is being used!
`67200012`	The request is illegal!
`67200100`	The current server status is busy, request response timeout!
`67200101`	The API requested currently does not exist. Please check the request path!

HTTP Status Codes

Status Code	Description
`0`	Success
`422`	Validation Error