[QD006]商标图样近似查询

post
https://connect.zhihuiya.com/quandashi/brand/search/image/similar
在体验中心中试用

通过商标图片 base64 进行近似查询，返回全球商标列表。

image_data、position、top_n 均为必填项；top_n 最大2000。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
country_name
stringCN,US
国家代码，多个逗号分隔，例如 CN,US
image_data
必填
stringiVBORw0KGgoAAAANSUhEUgAAA2UAAAMbCAIAAABCPKq1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAgAElEQVR4nOy92ZbcSK4tiA0Y6R6DsoZzVj/1+71/cf9/3dX9Ad2rv6C7qroyU4pw0oB9H2yg0YcYpFAqs05ZZUkhDzpptAnABrCB//G/P1IkKEEEGSSltqBQNIRCCdKFFFAkBC4SpHtEMCLcwylBBsu3hCLlVkGKCERUUG67PQGC9qEC7bPzDwGg/tH/KldSSMjW0G5SrnulcejJvmMcf4aQZPlDpH/h1dtvvaIodOze9d5tv5ZbvQevfVi6ha1vbNdh6/G1b15pZYYFW3cIEVBMJCmSaTIkFUDbGKCO1dA5cBufPpvYPYakjJNXb0Kh0MkAckSgrKX2QkS/zYvzy3JZ9EmsNwcFdaDGqWe7t1C2TpV/Q6AqVGFCTMqD6nGyWW2ebE46Jz1MNs92mFJKNplOySZDUlgS0zKXKA90j5w9gkJESNk+7uF5zZFzxBqxOBePxbm6nDI9JAc9R5TO1NcZRpFCbGu5jNSwlMYZuTVkrOO1XVA2a51Zgu6shwOl/B0iESGCEIbULd9mXodFd7nwriz/8gbjvzFcLdd+Pvtw3Mt1Pe6vrT3E+KXeG+jubuMTa3fqSdRf9GIMh9sOR9TQTULIoAgZUWfv/Pv1/KvrEOPH5X+q7SRhmYR6YIJigkntL48/ffr08PT05fOXX6Dx+HC4Px6S0sBJMWlKagqdp9lSKvdOpsfjYUqTAO5xOi1PT1+W01IOojTNd/cP8zxnz6fTqZ74ZAjdPYICUcBJAGomFPfwcIGmlJIl1VSWTURIkBIgwmNds4hMh/lwOFgyhaqpuzMCqoCYajDCQyCmpslSShGxLEsZQvdgBEkBFIBinFqSDGbPEVWsFRFCkhQPMghL2eOXL5//8fMv//z11+d1DagLHVUUhjMiIggAokU0KLQKJRFo3eDudA9pUnKb3LM1y+1/45Ycl91+ndcb6cXi57UdgXaGD6tyt2THw/lMAp49fTwNhXxZhmzn5nj/cooM30QTFKw7oImqbQtudyQxSF30M+6lfvxW7VyIlA9x43S4Ns6v3R/DgX/5dbYPA9sEjwJVhrHF+LWxq1W1aUNcbno5wGh/JhGUgwsAKA==
图片 base64 编码
int_cls
string09,42
尼斯分类，多个逗号分隔，例如 09,42
page_no
integer<int32>1
当前页，默认1，最小1
page_size
integer<int32>20
每页条数，默认20，最大200
position
必填
string0,0,869,795
裁剪位置，格式：x1,y1,x2,y2
tm_status
string已注册
法律状态，多个逗号分隔
top_n
必填
integer<int32>100
返回条数，最大2000，默认100

响应结构

API 响应数据的结构说明

字段名类型示例描述
data
object-
响应数据
list
array[ { "agent": "", "app_no": "3020261101905", "reg_no": "302026110190", "country": "德国", "tm_name": "BLUESTAR", "app_date": "2026-05-15", "end_date": "2036-05-15", "reg_date": "2026-05-26", "tm_image": "", "applicant": "VOLKSWAGEN AKTIENGESELLSCHAFT", "exam_date": "2026-06-26", "tm_status": "已注册", "flow_status": "Application procedure Trade mark registered", "tm_category": "12 运输工具", "goods_service": "12 Alarmanlagen für Fahrzeuge；Automobile；Kraftfahrzeuge；Motorräder", "applicant_address": "38440 Wolfsburg DE" }, { "agent": "", "app_no": "99802284", "reg_no": "", "country": "美国", "tm_name": "GOLF", "app_date": "2026-05-04", "end_date": "", "reg_date": "", "tm_image": "", "applicant": "VOLKSWAGEN AKTIENGESELLSCHAFT", "exam_date": "", "tm_status": "注册申请中", "flow_status": "APPLICATION FILING RECEIPT MAILED", "tm_category": "28 健身器材", "goods_service": "28 remote-controlled toy vehicles；scale model vehicles；toy vehicles for children", "applicant_address": "Berliner Ring 2, Wolfsburg, 38440" }, { "agent": "", "app_no": "3020261066441", "reg_no": "", "country": "德国", "tm_name": "VW", "app_date": "2026-03-27", "end_date": "", "reg_date": "", "tm_image": "https://mzw-ot.oss-cn-beijing.aliyuncs.com/de/tm_image/efece8d5/bd52d8d9/d7eac3a1/4aa2c91d/3020261066441.jpg", "applicant": "VOLKSWAGEN AKTIENGESELLSCHAFT", "exam_date": "", "tm_status": "注册申请中", "flow_status": "", "tm_category": "39 运输贮藏", "goods_service": "", "applicant_address": "38440 Wolfsburg DE" } ]
商标列表
rank
string0.6250130777606762
图形检索排序分（仅图样近似查询返回）
agent
stringCABINET NEFISSA GUEBLAOUI
代理机构
app_no
string20000248
申请号
reg_no
string15601
注册号
country
string乌兹别克斯坦
国家
tm_name
stringMM
商标名称
app_date
string2000-04-06
申请日期
end_date
string2020-02-28
到期日期
reg_date
string2002-06-28
注册日期
tm_image
stringhttps://mzw-ot.oss-cn-beijing.aliyuncs.com/uz/tm_image/6d31bed3/af56dd9f/96d27a17/102ff0ef/20000248.jpg
商标图片URL
applicant
stringТОРГОВОЕ ЧАСТНОЕ УНИТАРНОЕ ПРЕДПРИЯТИЕ "ХАРТИЯ"
申请人
exam_date
string2002-06-28
审查日期
tm_status
string商标无效
商标状态
flow_status
stringTermination Date
流程状态
tm_category
string42 科技服务
商标类别
goods_service
string42 Оптовая и розничная торговля.
商品/服务描述
similarity_level
string一般
近似程度
applicant_address
string220121, г. Минск, ул. Лещинского, д. 8
申请人地址
total
integer<int64>6819
商标总数
page_no
integer<int32>1
当前页
page_size
integer<int32>20
每页条数
total_pages
integer<int32>341
总页数
status
必填
booleanfalse
状态
error_msg
stringThe request parameter format is incorrect！
错误信息
error_code
必填
integer0
错误代码

成功响应示例

成功调用 API 的响应示例

JSON 
{
  "data": {
    "list": [
      {
        "rank": 0.6250130777606762,
        "agent": "CABINET NEFISSA GUEBLAOUI",
        "app_no": 20000248,
        "reg_no": 15601,
        "country": "乌兹别克斯坦",
        "tm_name": "MM",
        "app_date": "2000-04-06",
        "end_date": "2020-02-28",
        "reg_date": "2002-06-28",
        "tm_image": "https://mzw-ot.oss-cn-beijing.aliyuncs.com/uz/tm_image/6d31bed3/af56dd9f/96d27a17/102ff0ef/20000248.jpg",
        "applicant": "ТОРГОВОЕ ЧАСТНОЕ УНИТАРНОЕ ПРЕДПРИЯТИЕ \"ХАРТИЯ\"",
        "exam_date": "2002-06-28",
        "tm_status": "商标无效",
        "flow_status": "Termination Date",
        "tm_category": "42 科技服务",
        "goods_service": "42 Оптовая и розничная торговля.",
        "similarity_level": "一般",
        "applicant_address": "220121, г. Минск, ул. Лещинского, д. 8"
      }
    ],
    "total": 6819,
    "page_no": 1,
    "page_size": 20,
    "total_pages": 341
  },
  "status": true,
  "error_code": 0
}

错误码

此接口可能返回的错误码列表

业务错误码

错误码描述
68300004请求参数异常!
68300005查询Api失败!
68300006解析基本存取错误!
68300007存在错误的请求!
68300008服务中断异常，请稍后再试!
68300010文件不符合上传规范!

平台错误码

错误码描述
67200000API整体限流错误!
67200001API整体限流错误！
67200002当前调用速率过快,超过当前配置限制QPS！
67200003申请token的key和secret传参不正确或者客户端已被禁用！
67200004请求的接口无权限请联系我们的支持人员！
67200005账户余额/调用次数不足！
67200006客户端超过开通有效期！
67200007当前调用超过当天配置使用额度！
67200008请检查query参数中必填的apikey是否传输！
67200009apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token！
67200012请求不合法！
67200100当前服务器状态正忙,请求响应超时！
67200101当前请求的Api不存在请检查请求Path！

HTTP 状态码

状态码描述
0请求成功
201Created
401Unauthorized
403Forbidden
404Not Found
68300012企业数据不存在

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms