https://api.nexscope.ai/api/skill-api/v1/skills/google-patent-search/runRun this API
Send a JSON request to execute this API and receive the direct response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/api/skill-api/v1/skills/google-patent-search/run |
| Auth | Bearer API key |
| Content-Type | application/json |
Request body
| Name | Type | Required | Description |
|---|---|---|---|
q | string | required | Patent search query, maximum 1000 characters Example: wireless earbuds |
num | integer | optional | Results per page, from 10 to 100 Example: 10 |
page | integer | optional | Page number, starting at 1 Example: 1 |
country | string | optional | Country filter |
language | string | optional | Language filter |
before | string | optional | Upper date boundary such as filing:20260101 |
after | string | optional | Lower date boundary such as filing:20200101 |
sort | string | optional | Sort order: new or old |
type | string | optional | Document type: PATENT or DESIGN |
status | string | optional | Document status: GRANT or APPLICATION |
patents | boolean | optional | Include patent results Example: true |
scholar | boolean | optional | Include scholar results Example: false |
litigation | string | optional | Litigation filter: YES or NO |
inventor | string | optional | Inventor filter |
assignee | string | optional | Assignee filter |
clustered | boolean | optional | Enable clustered results; only true is supported Example: true |
dups | string | optional | Duplicate grouping mode; only language is supported Example: language |
Request example
{
"q": "wireless earbuds",
"num": 10,
"page": 1
}Response body
Response example
Direct response payload. No extra wrapper is added.
{
"results": [],
"summary": {
"cpc": [
{
"percentage": 100,
"key": "Total"
}
]
}
}Responses
| Code | Description |
|---|---|
| 200 | API executed successfully. Body is the direct response payload. |
| 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.