文字商标 · 关键词搜索

同步检测商品标题、长描述、短描述中提取出的关键词与在先注册文字商标的相似和冲突情况。

请求参数

参数	类型	必填	默认	说明
`title`	`string`	✅	`""`	商品标题文本（系统自动切词并进行 N-Gram 提取分析）
`shortDesc`	`string`	❌	`""`	商品短描述文本
`desc`	`string`	❌	`""`	商品长描述文本
`classCodes`	`array`	❌	`[]`	尼斯分类代码列表进行筛选
`skipStopWords`	`boolean`	❌	`true`	是否在 N-Gram 提取时过滤掉纯停用词
`skipNumbers`	`boolean`	❌	`true`	是否在 N-Gram 提取时过滤掉纯数字
`customStopWords`	`string[]`	❌	`[]`	自定义额外过滤的停用词列表

请求示例

{
  "title": "Ergonomic Chair",
  "shortDesc": "Comfortable design for office work",
  "desc": "A mesh back ergonomic office chair featuring dynamic lumbar support.",
  "classCodes": ["020"],
  "skipStopWords": true,
  "skipNumbers": true,
  "customStopWords": ["chair", "desk"]
}

cURLPython

curl -X POST "https://api.trohub.com/v1/trademarks/word-mark/keyword-search" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Ergonomic Chair","shortDesc":"Comfortable design for office work","desc":"A mesh back ergonomic office chair featuring dynamic lumbar support.","classCodes":["020"],"skipStopWords":true,"skipNumbers":true,"customStopWords":["chair","desk"]}'

import requests

url = "https://api.trohub.com/v1/trademarks/word-mark/keyword-search"
headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "title": "Ergonomic Chair",
    "shortDesc": "Comfortable design for office work",
    "desc": "A mesh back ergonomic office chair featuring dynamic lumbar support.",
    "classCodes": ["020"],
    "skipStopWords": True,
    "skipNumbers": True,
    "customStopWords": ["chair", "desk"]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

🔧 API 沙盒测试 POST /trademarks/word-mark/keyword-search

API Key

Base URL

请求体 (JSON)

响应

响应示例

{
  "ok": true,
  "message": "成功",
  "data": {
    "title": [
      {
        "id": "4bc01932f2724e7d924c5d3ed610d304",
        "tmClass": [{ "code": "009", "text": "" }],
        "drawingCode": "3",
        "filingDate": "20081215",
        "markText": "CHAIR",
        "owners": [
          { "address": "620 CROSSROADS BOULEVARD\nCARY, NC 27518", "country": "US", "name": "EPIC GAMES, INC." },
          { "address": "108 West Center Street\nProvo, UT 84601", "country": "US", "name": "Chair Entertainment Group, LLC" }
        ],
        "regDate": "20111213",
        "regNumber": "4068973",
        "serialNumber": "77633411",
        "status": "LIVE",
        "legalStatus": "REGISTERED"
      }
    ],
    "desc": [
      {
        "id": "dec5c7ad55a24120adf25f342c753659",
        "tmClass": [{ "code": "005", "text": "Natural supplements for treating erectile dysfunction" }],
        "drawingCode": "4",
        "filingDate": "20191112",
        "markText": "SUPPORT",
        "owners": [
          { "address": "348 Paraiso Drive\nDanville, CA 94526", "country": "US", "name": "Judson Brandeis" }
        ],
        "regDate": "20200818",
        "regNumber": "6132046",
        "serialNumber": "88689375",
        "status": "LIVE",
        "legalStatus": "REGISTERED"
      }
    ],
    "shortDesc": [
      {
        "id": "87d79f56d2024406a32d3752e0535a93",
        "tmClass": [
          { "code": "018", "text": "All purpose carrying bags; carry-all bags; tote bags; duffel bags; backpacks; sport bags; athletic bags; gym bags" },
          { "code": "021", "text": "Water bottles sold empty" },
          { "code": "025", "text": "Clothing, namely, tops, bottoms, shirts, sweatshirts, sweatpants, headwear, socks; athletics tops and bottoms for training, running, yoga, the gym and leisure" }
        ],
        "drawingCode": "3",
        "filingDate": "20170330",
        "markText": "WORK",
        "owners": [
          { "address": "16782 Hale Ave, Suite B\nIrvine, CA 92606", "country": "US", "name": "WORK, LLC" }
        ],
        "regDate": "20171107",
        "regNumber": "5328465",
        "serialNumber": "87392229",
        "status": "LIVE",
        "legalStatus": "REGISTERED"
      }
    ]
  },
  "responseType": "v2"
}