Nexscope logo
Start free

Ruiguan Trademark Graphic Detection 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 graphic trademarks in product images by comparing against registered trademark databases across 15 major trademark offices using YOLO-based object detection and visual similarity.

Try this API
Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/ruiguan-trademark-graphic-detection/run
MCP method
nexscope_ruiguan_trademark_graphic_detection

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-trademark-graphic-detection/run

Run an API

Request parameters documented by ecommerce.ruiguan-trademark-graphic-detection.

Slugruiguan-trademark-graphic-detection
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-trademark-graphic-detection/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",   "regions": "US",   "enableRadar": false,   "enableLocalizing": false,   "topNumber": 10 }'
All categories/ Patent & IP Risk
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/ruiguan-trademark-graphic-detection/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-trademark-graphic-detection/run
AuthBearer API key
Content-Typeapplication/json

Request body

NameTypeRequiredDescription
imageUrlstringrequired
产品图片URL或base64编码的图片数据（最大1000字符）
Example: https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg
topNumberintegerrequired
返回YOLO坐标的最大数量，默认 5，最大 100。实际返回数量可能少于传参数量
Example: 1
productTitlestringoptional
产品标题，用于上下文感知检测（最大1000字符）
trademarkNamestringoptional
可能的图形logo名称，用于缩小检索范围（最大1000字符）
regionsstringoptional
需要检测的国家/地区代码，多个时使用逗号隔开，不传默认全部国家。可选值：US（美国）、WO（世界知识产权）、ES（西班牙）、GB（英国）、DE（德国）、IT（意大利）、CA（加拿大）、MX（墨西哥）、EM（欧盟）、AU（澳大利亚）、FR（法国）、JP（日本）、TR（土耳其）、BX（玻利维亚）、CN（中国）
Example: US
enableLocalizingbooleanoptional
是否开启切图，默认 false
Example: false
enableRadarbooleanoptional
是否开启雷达监测，默认 true
Example: false

Request example

{
  "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
  "regions": "US",
  "enableRadar": false,
  "enableLocalizing": false,
  "topNumber": 10
}

Response body

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

NameTypeRequiredDescription
boundingBoxCountintegeroptional
检测结果数量
Example: 1
data[].radarResultstringoptional
雷达检测结果
totalintegeroptional
记录数
Example: 1
dataarrayoptional
检测结果列表（详见下方）
Example: []
detectIdstringoptional
检测ID
Example: example-id
columnsarrayoptional
渲染的列定义
Example: []
costTokenintegeroptional
消耗token
Example: 1
typestringoptional
渲染的样式
data[].imagestringoptional
匹配的商标图片地址
Example: https://example.com/image.jpg
data[].boundingBoxstringoptional
YOLO坐标（逗号隔开）
data[].subRadarResultstringoptional
子雷达检测结果
data[].applicationNumberstringoptional
申请号
data[].niceClassNamestringoptional
尼斯分类名称（逗号隔开）
data[].applicantNamestringoptional
权利人（逗号隔开）
data[].tradeMarkStatusstringoptional
商标状态，枚举值："DEL"、"ended"、"registered"、"act"、"pend"、"filed"、""
data[].niceClassarrayoptional
尼斯分类详情
Example: []
data[].similaritynumberoptional
相似度（0到1，值越高越相似）
Example: 1
data[].registrationNumberstringoptional
注册号
data[].registrationOfficeCodestringoptional
商标受理局
data[].registrationDatestringoptional
注册日期
Example: 2026-01-01
data[].bidstringoptional
logo标识
Example: example-id
data[].trademarkNamestringoptional
图片中的文字商标名称
data[].applicationDatestringoptional
申请日期
Example: 2026-01-01
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.

{
  "boundingBoxCount": 1,
  "total": 1,
  "data": [
    {
      "image": "https://example.com/image.jpg",
      "niceClass": [],
      "similarity": 1,
      "registrationDate": "2026-01-01",
      "bid": "example-id",
      "applicationDate": "2026-01-01"
    }
  ],
  "detectId": "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_ruiguan_trademark_graphic_detection",
    "arguments": {
      "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
      "regions": "US",
      "enableRadar": false,
      "enableLocalizing": false,
      "topNumber": 10
    }
  }
}

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-trademark-graphic-detection/run
MCP method
nexscope_ruiguan_trademark_graphic_detection
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/ruiguan-trademark-graphic-detection/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "imageUrl": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg", "regions": "US", "enableRadar": false, "enableLocalizing": false, "topNumber": 10 }'
Response
No response yet. Run the request to see the response here.