Nexscope logo
Start free

Zhihuiya Patent Image Search 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

Perform visual similarity search for design patents using an image URL, with filtering by country, legal status, date ranges, Locarno classification, and assignee. Supports design patent types only (type D).

Try this API
Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/zhihuiya-patent-image-search/run
MCP method
nexscope_zhihuiya_patent_image_search

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/zhihuiya-patent-image-search/run

Run an API

Request parameters documented by ecommerce.zhihuiya-patent-image-search.

Slugzhihuiya-patent-image-search
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/zhihuiya-patent-image-search/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "preFilter": 1,   "isHttps": 1,   "limit": 5,   "stemming": 0,   "offset": 0,   "country": "US",   "url": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",   "patentType": "D",   "model": 1 }'
All categories/ Patent & IP Risk
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/zhihuiya-patent-image-search/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/zhihuiya-patent-image-search/run
AuthBearer API key
Content-Typeapplication/json

Request body

NameTypeRequiredDescription
urlstringrequired
图像的URL（最大1000字符）
Example: https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg
patentTypestringrequired
专利类型：D（外观专利）或 U（实用新型专利）。默认：D
Example: D
modelintegerrequired
图像检索模型。外观专利：1（智能联想，推荐）、2（搜索此图）；实用新型专利：3（匹配形状）、4（匹配形状/图案/色彩，推荐）
Example: 1
countrystringoptional
专利受理局（国家/组织/地区代码），多个用英文逗号隔开。例如：CN,US,JP。不传时代表查询全部专利受理局的数据
locstringoptional
LOC分类（洛迦诺分类号），多个分类号可以用逻辑符 AND/OR/NOT 连接
legalStatusstringoptional
专利的法律状态，多个用英文逗号隔开。可选值：1（公开）、2（实质审查）、3（授权）、8（避免重复授权）、11（撤回）、12（撤回-未指定类型）、17（撤回-视为撤回）、18（撤回-主动撤回）、13（驳回）、14（全部撤销）、15（期限届满）、16（未缴年费）、21（权利恢复）、22（权利终止）、23（部分无效）、24（申请终止）、30（放弃）、19（放弃-视为放弃）、20（放弃-主动放弃）、25（放弃-未指定类型）、222（PCT未进入指定国-指定期内）、223（PCT进入指定国-指定期内）、224（PCT进入指定国-指定期满）、225（PCT未进入指定国-指定期满）
simpleLegalStatusstringoptional
专利的简单法律状态，多个用英文逗号隔开。可选值：0（失效）、1（有效）、2（审中）、220（PCT指定期满）、221（PCT指定期内）、999（未确认）
assigneesstringoptional
申请（专利权）人（最大1000字符）
applyStartTimestringoptional
专利申请起始时间，格式：yyyyMMdd
applyEndTimestringoptional
专利申请截止时间，格式：yyyyMMdd
publicStartTimestringoptional
专利公开起始时间，格式：yyyyMMdd
publicEndTimestringoptional
专利公开截止时间，格式：yyyyMMdd
limitintegeroptional
返回专利条数，1-100。默认：10
Example: 5
offsetintegeroptional
偏移量，0-1000。默认：0
Example: 0
fieldstringoptional
返回结果排序字段：SCORE（按照最相关排序）、APD（按照申请日排序）、PBD（按照公开日排序）、ISD（按照授权日排序）。默认：SCORE
orderstringoptional
当 field 选择 APD/PBD/ISD 时有效：desc（降序）或 asc（升序）。默认：desc
langstringoptional
设置标题的语言优先选择：original（专利原文标题）、cn（专利中文翻译标题）、en（专利英文翻译标题）。默认：original
preFilterintegeroptional
是否开启前置国家/LOC过滤：1（开启）、0（关闭）。默认：1
Example: 1
stemmingintegeroptional
是否开启截词功能：1（开启）、0（关闭）。默认：0
Example: 0
mainFieldstringoptional
专利主要字段，包括标题、摘要、权利要求、说明书、公开号、申请号、申请人、发明人和IPC/UPC/LOC分类号（最大1000字符）
includeMachineTranslationbooleanoptional
搜索包含机器翻译数据
Example: false
scoreExpansionbooleanoptional
分数拓展
Example: false
isHttpsintegeroptional
选择是否返回https域名图片：1（返回https）、0（返回http）。默认：0
Example: 1
returnImgIdbooleanoptional
是否返回img_id。默认：false
Example: false

Request example

{
  "preFilter": 1,
  "isHttps": 1,
  "limit": 5,
  "stemming": 0,
  "offset": 0,
  "country": "US",
  "url": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
  "patentType": "D",
  "model": 1
}

Response body

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

NameTypeRequiredDescription
totalintegeroptional
本次返回的记录数
Example: 1
allRecordsCountintegeroptional
数据库中匹配的总记录数
Example: 1
dataarrayoptional
匹配的专利记录列表
Example: []
columnsarrayoptional
渲染的列定义
Example: []
typestringoptional
渲染的样式
costTokenintegeroptional
消耗token
Example: 1
data[].patentIdstringoptional
相似专利ID
Example: example-id
data[].patentPnstringoptional
相似专利号
data[].apnostringoptional
申请号
data[].titlestringoptional
专利名称
data[].inventorstringoptional
发明人
data[].originalAssigneestringoptional
原始申请人
data[].currentAssigneestringoptional
当前申请人
data[].authoritystringoptional
受理局（国家代码）
data[].urlstringoptional
相似的专利附图URL
Example: https://example.com/image.jpg
data[].scorenumberoptional
相似度分数（分数越高越相似；仅当 field 为 SCORE 时有效）
Example: 1
data[].locarrayoptional
LOC分类（洛迦诺分类号）
Example: []
data[].locMatchintegeroptional
是否命中高权重LOC：1（命中）、0（未命中）。仅当 model=1 且 field=SCORE 时有效
Example: 1
data[].apdtintegeroptional
申请日（时间戳）
Example: 1
data[].pbdtintegeroptional
公开日（时间戳）
Example: 1
data[].imgIdstringoptional
专利附图img_id（仅当 returnImgId 为 true 时返回）
Example: example-id
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,
  "allRecordsCount": 1,
  "data": [
    {
      "patentId": "example-id",
      "url": "https://example.com/image.jpg",
      "score": 1,
      "loc": [],
      "locMatch": 1,
      "apdt": 1,
      "pbdt": 1,
      "imgId": "example-id"
    }
  ],
  "columns": [],
  "costToken": 1
}

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_zhihuiya_patent_image_search",
    "arguments": {
      "preFilter": 1,
      "isHttps": 1,
      "limit": 5,
      "stemming": 0,
      "offset": 0,
      "country": "US",
      "url": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
      "patentType": "D",
      "model": 1
    }
  }
}

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/zhihuiya-patent-image-search/run
MCP method
nexscope_zhihuiya_patent_image_search
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/zhihuiya-patent-image-search/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "preFilter": 1, "isHttps": 1, "limit": 5, "stemming": 0, "offset": 0, "country": "US", "url": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg", "patentType": "D", "model": 1 }'
Response
No response yet. Run the request to see the response here.