https://api.nexscope.ai/rg/textTrademarkDetectionRun 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/textTrademarkDetection |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
productTitle | string | required | Product title, used for trademark detection, maximum 1000 characters |
regions | string | optional | Country/region codes, separate multiples with commas. support `US`, `EM`, `GB`, `DE`, `FR`, `IT`, `ES`, `AU`, `CA`, `MX`, `JP`, `CN`, `WO`, `TR`, `BX` Example: US |
limit | integer | required | Limit on the number of returned results, maximum 500 Example: 100 |
productText | string | optional | Other text information about the product, such as five-point description or product description, maximum 1000 characters |
Code example
{
"limit": 100,
"productTitle": "Wireless Bluetooth Headphones Noise Cancelling Over Ear",
"regions": "US"
}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 (28 fields)
| Name | Type | Required | Description |
|---|---|---|---|
total | integer | optional | Number of matched trademark records |
data | array | optional | Trademark list (flattened), each element contains the fields below |
detectId | string | optional | Interface call ID |
columns | array | optional | Rendered column definitions |
blacklistTrademarks | array | optional | Blacklisted trademarks detected in text |
whitelistTrademarks | array | optional | Whitelisted (safe) trademarks detected in text |
textTrademarkRadar | string | optional | Product risk level: `0` is low risk, `1` is pending manual verification, and `2` is high risk |
costToken | integer | optional | Consume token |
type | string | optional | Rendering style |
trademarkName | string | optional | Trademark word |
region | string | optional | Country code |
score | integer | optional | risk score |
highestModeScore | integer | optional | Maximum risk score, range 0-5 |
trademarksStatus | string | optional | Highest scoring trademark word status |
regionStatus | string | optional | Trademark status in matching regions |
holder | string | optional | rights holder |
applicationNumber | string | optional | Application number |
registrationNumber | string | optional | Registration number |
isFamous | boolean | optional | Is it a famous trademark? |
isAmazonBrand | boolean | optional | Is it an Amazon hot search brand? |
isActiveHolder | boolean | optional | Are you an active rights defender? |
isCompatibility | boolean | optional | Compatibility |
isCommonSense | boolean | optional | Is it a common word? |
niceClass | array | optional | Nice Classification |
originalTextMatches | array | optional | The original word that triggered the match |
trademark | string | optional | Trade name |
region | string | optional | Country code |
note | string | optional | Remarks |
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.