Nexscope logo
Start free

Ruiguan Detection Patent Design API

REST API and MCP service documentation generated from server-side API definitions. Responses shown here are the direct payload returned by each API execution.

API selector
Patent & IP Risk

API overview

Detect design patent infringement risks by comparing a product image against a global design patent database across 25+ jurisdictions.

Try this API
Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/ruiguan-detection-patent-design/run
MCP method
nexscope_ruiguan_detection_patent_design

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Missing or invalid API keys return an authentication error. Manage keys from .
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/ruiguan-detection-patent-design/run

Run an API

Request parameters documented by ecommerce.ruiguan-detection-patent-design.

Slugruiguan-detection-patent-design
HeadersAuthorization: Bearer nk_...
Content-Type: application/json
Request bodyAPI-specific JSON object.
Response bodyDirect API response payload. No data/result wrapper is added.

Status codes

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.

Example request

curl -X POST https://api.nexscope.ai/api/skill-api/v1/skills/ruiguan-detection-patent-design/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "patentStatus": "1,0",   "productTitle": "Magnetic phone case",   "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",   "enableRadar": false,   "regions": "US",   "topNumber": 10,   "productDescription": "A protective smartphone case with a magnetic ring stand and shockproof corners.",   "queryMode": "physical" }'
All categories/ Patent & IP Risk
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/ruiguan-detection-patent-design/run

Run this API

Send a JSON request to execute this API and receive the direct response payload.

Open tester

Endpoint

MethodPOST
Pathhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/ruiguan-detection-patent-design/run
AuthBearer API key
Content-Typeapplication/json

Request body

NameTypeRequiredDescription
imageUrlstringrequired
产品图片文件URL，用于与专利数据库进行比对（最大1000字符）
Example: https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg
queryModestringrequired
检索模式：physical（实物图检索）、line（线条图检索）、hybrid（混合检索）。最大1000字符
Example: physical
topNumberintegerrequired
召回专利数量（最大100）
Example: 10
regionsstringoptional
商品所售卖国家/地区代码，多选时用逗号隔开（如 US,EU,CN）。支持：US、EU、CN、JP、KR、DE、GB、FR、IT、AU、CA、BR、MX、IN、TH、SE、CH、IE、IL、DK、NZ、AT、BX、FI、WO。最大1000字符
Example: US
productTitlestringoptional
产品标题，用于补充检索上下文（最大1000字符）
Example: Magnetic phone case
productDescriptionstringoptional
产品描述，用于补充检索上下文（最大1000字符）
Example: A protective smartphone case with a magnetic ring stand and shockproof corners.
patentStatusstringoptional
专利有效性筛选：1（有效专利）、0（失效专利）、1,0（全部）。最大1000字符
Example: 1,0
enableRadarbooleanoptional
是否启用雷达图（AI侵权判定分析）
Example: false
topLocstringoptional
指定检索的一级LOC范围（如 06,07）。格式：^(0[1-9]\
sourceLanguagestringoptional
原语言代码，需要标记以便统一翻译成英文（如 zh-CN）。文本为英语时传空即可。最大1000字符

Request example

{
  "patentStatus": "1,0",
  "productTitle": "Magnetic phone case",
  "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
  "enableRadar": false,
  "regions": "US",
  "topNumber": 10,
  "productDescription": "A protective smartphone case with a magnetic ring stand and shockproof corners.",
  "queryMode": "physical"
}

Response body

Returns the documented upstream API response directly without an additional wrapper.

NameTypeRequiredDescription
totalintegeroptional
返回的专利记录总数
Example: 1
dataarrayoptional
专利列表（详见下方专利对象）
Example: []
columnsarrayoptional
渲染的列定义
Example: []
costTokenintegeroptional
消耗token
Example: 1
typestringoptional
渲染的样式
data[].applicationNumberstringoptional
专利申请号
data[].publicationNumberstringoptional
专利公开号
data[].patentProdstringoptional
专利标题（英文）
data[].patentProdCnstringoptional
专利标题（中文）
data[].similaritystringoptional
专利与产品图片的相似度（0-1）
data[].patentImageUrlstringoptional
与产品图片相似度最高的专利附图URL
Example: https://example.com/image.jpg
data[].imagesarrayoptional
专利图片列表
Example: []
data[].abstractsstringoptional
专利摘要
data[].specificationstringoptional
专利说明书
data[].inventorsarrayoptional
发明人列表
Example: []
data[].applicantsarrayoptional
申请人列表
Example: []
data[].applicantAddressesarrayoptional
申请人地址
Example: []
data[].troCasebooleanoptional
是否有TRO维权史
Example: false
data[].troHolderbooleanoptional
是否是TRO权利人的专利
Example: false
data[].radarResultobjectoptional
AI雷达分析结果
Example: {}
radarResult.samebooleanoptional
是否疑似侵权
Example: false
radarResult.expstringoptional
预期描述（雷达判定说明）
data[].patentLocstringoptional
该专利的LOC分类（多个用逗号隔开）
data[].locOneInfostringoptional
LOC一级详情
data[].locTwoInfostringoptional
LOC二级详情
data[].patentValiditystringoptional
专利有效性
data[].applicationDatestringoptional
专利申请日
Example: 2026-01-01
data[].publicationDatestringoptional
专利公开日
Example: 2026-01-01
data[].grantDatestringoptional
专利授权日
Example: 2026-01-01
data[].estimatedDueDatestringoptional
预估到期日
Example: 2026-01-01
data[].registrationOfficeCodestringoptional
专利注册受理局
data[].patentFamilyarrayoptional
同族专利列表
Example: []
data[].globalPatentIdstringoptional
全球专利ID
Example: example-id
data[].globalImageIdstringoptional
专利图片的ID
Example: example-id
data[].isSketchTextstringoptional
是否线稿图
errcodeintegeroptional
Upstream status code returned by the provider.
errmsgstringoptional
Upstream status message returned by the provider.
codestringoptional
Provider-specific status code.
msgstringoptional
Provider-specific status message.
messagestringoptional
Provider-specific message.
titlestringoptional
Provider-specific response title.
sourceTypestringoptional
Provider-specific source platform type.
sourceToolstringoptional
Provider-specific source tool name.
costTimeintegeroptional
Execution time reported by the upstream provider.
pageintegeroptional
Current page returned by the upstream provider.
pageSizeintegeroptional
Page size returned by the upstream provider.
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
totalPageintegeroptional
Total page count returned by the upstream provider.
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.

Response example

Direct response payload. No extra wrapper is added.

{
  "total": 1,
  "data": [
    {
      "patentImageUrl": "https://example.com/image.jpg",
      "images": [],
      "inventors": [],
      "applicants": [],
      "applicantAddresses": [],
      "troCase": false,
      "troHolder": false,
      "radarResult": {},
      "applicationDate": "2026-01-01",
      "publicationDate": "2026-01-01",
      "grantDate": "2026-01-01",
      "estimatedDueDate": "2026-01-01",
      "patentFamily": [],
      "globalPatentId": "example-id",
      "globalImageId": "example-id"
    }
  ],
  "columns": [],
  "costToken": 1,
  "radarResult": {
    "same": false
  }
}

Responses

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI 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.

Related APIs

Patent Abstract Image Data

Retrieves patent abstract images (drawings) from the Zhihuiya (PatSnap) patent database by patent ID or publication number.

Patent Claims

Retrieves patent claims data from Zhihuiya (PatSnap).

Patent Claims Translation

Retrieves translated patent claims from the Zhihuiya (PatSnap) patent database.

Patent Description Data

Retrieve patent description (specification) data from the Zhihuiya patent database by patent ID or publication number.

MCP

Use the MCP endpoint when an agent needs to discover and call API tools with JSON-RPC.

GET /api/skill-api/v1/mcp
POST /api/skill-api/v1/mcp
Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Content-Type: application/json

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ruiguan_detection_patent_design",
    "arguments": {
      "patentStatus": "1,0",
      "productTitle": "Magnetic phone case",
      "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
      "enableRadar": false,
      "regions": "US",
      "topNumber": 10,
      "productDescription": "A protective smartphone case with a magnetic ring stand and shockproof corners.",
      "queryMode": "physical"
    }
  }
}

Online test

Execute the current API with your API key and JSON payload.

Try it

Send a real request with the same contract shown in the reference.

Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/ruiguan-detection-patent-design/run
MCP method
nexscope_ruiguan_detection_patent_design
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/ruiguan-detection-patent-design/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "patentStatus": "1,0", "productTitle": "Magnetic phone case", "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg", "enableRadar": false, "regions": "US", "topNumber": 10, "productDescription": "A protective smartphone case with a magnetic ring stand and shockproof corners.", "queryMode": "physical" }'
Response
No response yet. Run the request to see the response here.