[P060]专利图像检索-单图形搜升级版

post
https://connect.zhihuiya.com/search/patent/image-single/beta
在体验中心中试用

该接口支持通过图像URL搜寻相似外观专利，默认按照相似度从高到低排序，单次请求最多返回100条相似专利。搜索侧加入了用户图像转专利风格线条图的步骤，更好的支持图片在轮廓形状上的召回效果，可以更好的支持出海电商在欧美专利上的侵权检索。

注意： 1.支持常用图像格式（jpg，png），文件小于4M。获得的相似图片路径有效期为9小时（32400秒），过期后会清空； 2.单次调用最多支持返回Top100条相似专利，如需要获取排序靠后的相似专利，请注意请求参数offset的设置（默认为0）； 3.如需使用本地图片检索，可以先调用【[P010]专利图像相似检索】接口上传图像，获得公网可以访问的Url； 4.目前CA外观专利分类号数据完善中，建议客户country:CA和loc条件不要同时填写。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
apply_end_time
string20200101
专利申请截止时间，格式:yyyyMMdd
apply_start_time
string20100101
专利申请起始时间，格式:yyyyMMdd
assignees
stringhuawei
申请（专利权）人
country
array[ "US", "EU", "CN" ]
专利受理局（国家/组织/地区代码） 输入国家代码进行检索结果筛选，国家代码请参照https://analytics.zhihuiya.com/status，可以多选，多个内容项之间用英文,隔开。
field
stringSCORE

返回结果排序field支持SCORE,APD,PBD,ISD

SCORE：按照最相关排序

APD：按照申请日排序

PBD：按照公开日排序

ISD：按照授权日排序

include_machine_translation
booleantrue
搜索包含机器翻译数据
is_https
integer<int32>-

选择是否返回https域名图片，默认为0，即返回http域名图片

1：返回https

0：返回http

lang
stringoriginal
设置标题的语言优先选择，可以选cn、en、original，默认为original： original：专利原文标题 cn：专利中文翻译标题 en：专利英文翻译标题
legal_status
string3,2

专利的法律状态

1:公开 2:实质审查 3:授权 8:避免重复授权 11:撤回 12:撤回-未指定类型 17:撤回-视为撤回 18:撤回-主动撤回 13:驳回 14:全部撤销 15:期限届满 16:未缴年费 21:权利恢复 22:权利终止 23:部分无效 24:申请终止 30:放弃 19:放弃-视为放弃 20:放弃-主动放弃 25:放弃-未指定类型 222:PCT未进入指定国（指定期内） 223:PCT进入指定国（指定期内） 224:PCT进入指定国（指定期满） 225:PCT未进入指定国（指定期满），可以多选，多个内容项之间用英文,隔开。

limit
integer<int32>10
返回专利条数, 1 <= limit <= 100，默认为10
loc
string(14-03 OR 14-02)

LOC分类(洛迦诺分类号)是针对外观设计专利的通用分类体系

搜索任意层级的分类号，多个分类号可以用逻辑符AND/OR/NOT连接

main_field
string(phones or 手机)

专利主要字段

主要字段包括标题、摘要、权利要求、说明书、公开号、申请号、申请人、发明人和IPC/UPC/LOC分类号

model
必填
integer<int32>1

选择图像检索模型（外观专利和实用新型有不同的模型可选）

外观专利：

1：智能联想【推荐】

2：搜索此图

实用新型专利：

3：匹配形状

4：匹配形状/图案/色彩【推荐】

offset
integer<int32>-
偏移量，0 <= offset <= 1000，默认为0 如需要获取排名在100名之后的专利，可以设置offset=100
order
stringdesc
当field选择APD,PBD,ISD时有效，order支持desc,asc。默认desc
patent_type
必填
stringD

选择检索外观专利或实用新型专利：

D：外观专利

U：实用新型专利

public_end_time
string20200101
专利公开截止时间，格式:yyyyMMdd
public_start_time
string20100101
专利公开起始时间，格式:yyyyMMdd
return_img_id
boolean-
是否返回img_id
score_expansion
booleantrue
分数拓展
simple_legal_status
string1,2

专利的简单法律状态

0:失效 1:有效 2:审中 220:PCT指定期满 221:PCT指定期内 999:未确认，可以多选，多个内容项之间用英文,隔开。

url
必填
stringhttps://static-open.zhihuiya.com/sample/common_demo.png
图像的URL
query_text
stringTACD: virtual reality
请输入Analytics检索式
stemming
integer<int32>-

是否开启截词功能，1：开启；0：关闭。默认关闭

注：开启截词，在保留原词的同时，并扩展其对应的单复数及时态，例如搜索 "come"，会扩展为 "come", "comes", "came", "coming" 等等；

关闭截词，只搜索检索式中关键词本身；

在搜索语句中使用通配符，会影响截词在含通配符的关键词中生效；

截词仅作用于英文关键词，且在申请人、发明人等涉及人名的字段中不起作用。

pre_filter
integer<int32>1
是否开启前置国家/LOC过滤，1：开启；0：关闭。默认开启

响应结构

API 响应数据的结构说明

字段名类型示例描述
data
object-
响应数据
patent_messages
arrayPlease check the form: PatentMessage
相似专利信息
url
必填
stringhttp://patsnap-imagefulltext240.cdn.zhihuiya.com/EU/S/00/47/44/21/70/00/9/004744217_0009_0002.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240311T111032Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=AKIAPEVKZSEKLAJCRYAA%2F20240311%2Fcn-northwest-1%2Fs3%2Faws4_request&X-Amz-Signature=017c433982a4c397014bb96c92f320c7da2248a9d6b2ce6352f6adbffc4b0d99
相似的专利附图
apdt
integer<int64>20190528
申请日
apno
stringEU006535076
申请号
pbdt
integer<int64>20190528
公开日
score
number0.8884816
相似度分数（仅当按照相似度排序时有效，即请求参数field为SCORE）
title
必填
stringMobile phones
专利名称
img_id
必填
stringHDA0001130916580000011
相似的专利附图img_id
inventor
stringELSHAFIE, AHMED|YANG, WEI|HOSSEINI, SEYEDKIANOUSH
发明人
loc_match
integer<int32>1
是否命中高权重LOC，1为命中，0为未命中（仅当model=1且field=SCORE时有效）
patent_id
必填
string6e433449-143b-41d9-9abf-6c6519b07779
相似专利ID
patent_pn
必填
stringEU0065350760001S
相似专利号
current_assignee
stringHUAWEI TECHNOLOGIES CO., LTD.
当前申请人
original_assignee
stringHUAWEI TECHNOLOGIES CO., LTD.
原始申请人
total_search_result_count
integer<int32>100
检索结果数
status
必填
booleanfalse
状态
error_msg
stringThe request parameter format is incorrect！
错误信息
error_code
必填
integer0
错误代码

成功响应示例

成功调用 API 的响应示例

JSON 
{
  "data": {
    "patent_messages": [
      {
        "url": "http://patsnap-imagefulltext240.cdn.zhihuiya.com/EU/S/00/47/44/21/70/00/9/004744217_0009_0002.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240311T111032Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=AKIAPEVKZSEKLAJCRYAA%2F20240311%2Fcn-northwest-1%2Fs3%2Faws4_request&X-Amz-Signature=017c433982a4c397014bb96c92f320c7da2248a9d6b2ce6352f6adbffc4b0d99",
        "apdt": 20190528,
        "apno": "EU006535076",
        "pbdt": 20190528,
        "score": 0.8884816,
        "title": "Mobile phones",
        "img_id": "HDA0001130916580000011",
        "inventor": "ELSHAFIE, AHMED|YANG, WEI|HOSSEINI, SEYEDKIANOUSH",
        "loc_match": 1,
        "patent_id": "6e433449-143b-41d9-9abf-6c6519b07779",
        "patent_pn": "EU0065350760001S",
        "current_assignee": "HUAWEI TECHNOLOGIES CO., LTD.",
        "original_assignee": "HUAWEI TECHNOLOGIES CO., LTD."
      }
    ],
    "total_search_result_count": 100
  },
  "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

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms