https://api.nexscope.ai/patents/searchRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/patents/search |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
q | string | required | Google Patents search query supports official advanced query syntax (such as `owner:"Company"`, `inventor:"Name"`, date operator). Maximum 1000 characters. |
num | integer | optional | Number of results per page, range 10–100. Example: 10 |
page | integer | optional | Page number, starting from 1. Example: 1 |
country | string | optional | Country code, multiple values separated by commas, for example `US,CN,WO`. |
language | string | optional | Language, multiple values separated by English commas, use Google Patents official language value. |
before | string | optional | Maximum date, format `priority\|filing\|publication:YYYYMMDD`. |
after | string | optional | Minimum date, the format is the same as `before`. |
sort | string | optional | Sorting method: `new` (latest) or `old` (earliest); if not transmitted, sorted by relevance. |
type | string | optional | Result type: `PATENT` or `DESIGN`. |
status | string | optional | Patent status: `GRANT` or `APPLICATION`. |
patents | boolean | optional | Whether to include patent results. Example: true |
scholar | boolean | optional | Whether to include Google Scholar results. Example: false |
litigation | string | optional | Litigation Status: `YES` or `NO`. |
inventor | string | optional | Inventor, multiple values are separated by commas. |
assignee | string | optional | Assignee, multiple values separated by commas. |
clustered | boolean | optional | Whether to aggregate by category; upstream currently only supports `true`. |
dups | string | optional | Deduplication method; when not uploading, deduplication is based on patent family, `language` means deduplication is based on public text. |
Code example
{
"num": 10,
"q": "wireless earbuds"
}Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"code": 0,
"cost": "-1",
"data": {},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Response fields
Response field reference (39 fields)
| Name | Type | Required | Description |
|---|---|---|---|
errcode | integer | optional | `200` indicates success. |
errmsg | string | optional | `ok` indicates success, otherwise it is an error description. |
organicResults | array | optional | List of patent search results. |
searchParameters | object | optional | Echoed query parameters (`q`/`engine`/`num`/`patents`/`page`/`scholar`, etc.). |
searchInformation | object | optional | Retrieve meta information, including `total_results` (total number of hits), `total_pages` (total number of pages), `page_number` (current page). |
searchMetadata | object | optional | Retrieve processing metadata. |
pagination | object | optional | Paging information (`next`, `current`). |
serpapiPagination | object | optional | Upstream paging information. |
summary | object | optional | Result summary (including `cpc` classification aggregation, etc., only part of it is returned during classification aggregation). |
costToken | integer | optional | Consume token. |
message | string | optional | Upstream prompt information; successful but may appear under special circumstances. Most successful responses do not contain this field. |
publicationNumber | string | optional | Public account. |
patentId | string | optional | Patent ID. |
title | string | optional | Patent or academic result titles. |
snippet | string | optional | Abstracts of patent or academic results. |
inventor | string | optional | Inventor. |
assignee | string | optional | Assignee. |
filingDate | string | optional | Application date. |
publicationDate | string | optional | Publication or release date. |
grantDate | string | optional | Authorization date. |
priorityDate | string | optional | Priority date. |
language | string | optional | Patent language. |
cpc | string | optional | Collaborative patent classification (returned only when classification is aggregated). |
cpcDescription | string | optional | Description of cooperative patent classification. |
countryStatus | object | optional | The legal status of each country. |
position | integer | optional | Search result location. |
rank | integer | optional | Result ranking (may differ from `position` when aggregated). |
patentLink | string | optional | Google Patents patent link. |
pdf | string | optional | Patent PDF link. |
thumbnail | string | optional | Patent thumbnail. |
figures | array | optional | Patent image list, elements containing `thumbnail`, `full`. |
scholar | boolean | optional | Whether it is a Google Scholar result. |
scholarId | string | optional | Scholar result ID. |
scholarLink | string | optional | Google Scholar results link. |
author | string | optional | Scholar result author. |
authorEtal | boolean | optional | Whether the Scholar result contains three or more authors. |
publicationVenue | string | optional | Scholar results publication venue. |
urlHostname | string | optional | Scholar result source domain name. |
serpapiLink | string | optional | Result details API link. |
Responses
| Code | Description |
|---|---|
| 200 | HTTP request completed. Check JSON code; only 0 indicates business success or acceptance. |
| 400 | Request JSON or required API parameters are invalid. |
| 401 | API key is missing, invalid, or cannot be matched to a user. |
| 5xx | API execution or upstream service failed. |
Data source, freshness, and limitations
Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.