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. |
Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
No response example is published for this API. Refer to the response fields below.
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 | Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result. |
| 429 | Execution admission rate limit; honor Retry-After when present. |
| 503 | Execution admission is temporarily unavailable; honor Retry-After when present. |
| Opt-in | X-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses. |
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.