https://api.nexscope.ai/rg/trademarkGraphicDetectionRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/rg/trademarkGraphicDetection |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
imageUrl | string | required | Product image URL or base64-encoded image data, maximum 1000 characters |
topNumber | integer | required | Returns the maximum number of YOLO coordinates, ranging from 1-100; the actual number returned may be less than the number of parameters passed Example: 5 |
productTitle | string | optional | Product title, used for context-aware detection, max 1000 characters |
trademarkName | string | optional | Possible graphic logo names, used to narrow the search scope, maximum 1000 characters |
regions | string | optional | Country/region codes to be detected, separate with commas if multiple. If not transmitted, all countries will be detected by default. Optional values: `US`, `WO`, `ES`, `GB`, `DE`, `IT`, `CA`, `MX`, `EM`, `AU`, `FR`, `JP`, `TR`, `BX`, `CN` |
enableLocalizing | boolean | optional | Whether to enable image cutting Example: false |
enableRadar | boolean | optional | Whether to enable radar monitoring Example: true |
Code example
{
"imageUrl": "https://example.com/product-image.jpg",
"productTitle": "Wireless Bluetooth headphones",
"regions": "US,EM",
"topNumber": 5
}Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"code": 0,
"cost": "-1",
"data": {},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Response fields
Response field reference (23 fields)
| Name | Type | Required | Description |
|---|---|---|---|
boundingBoxCount | integer | optional | Number of test results |
radarResult | string | optional | Radar detection results |
total | integer | optional | Number of records |
data | array | optional | Test result list (see element fields below for details) |
detectId | string | optional | Detection ID |
columns | array | optional | Rendered column definitions |
costToken | integer | optional | Consume token |
type | string | optional | Rendering style |
image | string | optional | Matching trademark image address |
boundingBox | string | optional | YOLO coordinates, comma separated |
subRadarResult | string | optional | Sub-radar detection results |
applicationNumber | string | optional | Application number |
niceClassName | string | optional | Nice classification names, comma separated |
applicantName | string | optional | Rights holders, separated by commas |
tradeMarkStatus | string | optional | Trademark status, enumeration value is `DEL`, `ended`, `registered`, `act`, `pend`, `filed` or empty string |
niceClass | array | optional | Nice classification details |
similarity | number | optional | Similarity (0 to 1, higher values are more similar) |
registrationNumber | string | optional | Registration number |
registrationOfficeCode | string | optional | Trademark Acceptance Office |
registrationDate | string | optional | Registration date |
bid | string | optional | logo |
trademarkName | string | optional | Text brand name in image |
applicationDate | string | optional | Application date |
Responses
| Code | Description |
|---|---|
| 200 | HTTP request completed. Check JSON code; only 0 indicates business success or acceptance. |
| 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.