搜索接口
| 接口URL: | /api/s |
| 接口说明: | 该接口提供对专利的检索功能,用户输入想要查找的关键词或者符合语法规范的短语即可对专利数据进行检索。只支持返回前1000条记录,
如果需要获取更多记录建议拆分检索式,比如增加时间范围。
特别说明:只有通过搜索接口获取到的专利唯一ID才能在/patent/base等接口中获取到相应数据且有效时间60分钟,直接访问/patent/base接口将被返回215错误代码。 |
| 实例: | https://www.patenthub.cn/api/s?ds=cn&t=xx&q=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| ds | 否 | dataScope,数据范围,目前支持cn:中国,all:全球,默认cn |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| q | 是 |
用户输入的查询条件,可以是检索式,具体如何编写检索式可以参考《检索帮助文档》
案例:1、查询石墨烯领域的专利 q=石墨烯2、查询柳沈的代理的专利 q=agency:北京市柳沈律师事务所 3、查询石墨烯相关的2014年和2015年的公开的专利 q=documentYear:[2014 TO 2015] AND 石墨烯 4、查询石墨烯相关的发明授权且有效的专利 q=石墨烯 AND type:发明授权 AND legalStatus:有效专利 |
| p | 否 | page页码,默认值1,最大页码为100页,最多返回1000条记录;系统将根据用户输入的页码返回该页的数据 |
| ps | 否 | pageSize,每页展现数据的条数,默认10条,单页最大50条;系统将根据用户指定的每页显示条数返回搜索数据 |
| s | 否 | sort,排序字段,默认值relation,有4个有效值:relation(相关度),applicationDate(申请时间)、documentDate(公开(公告)时间)、rank(专利评级);可以在applicationDate、documentDate前面加感叹号,感叹号表示降序,如果不加表示升序。 |
| hl | 否 | Highlight,是否高亮结果,默认0,可选值:0(不高亮数据),1(高亮数据) |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"took" : 638,
"total" : 58981,
"code" : 200,
"success" : true,
"nextPage" : 2,
"totalPages" : 5899,
"patents" : [ {
"id" : "CN108251808A",
"rank" : "0",
"legalStatus" : "公开",
"type" : "发明公开",
"title" : "铜掺杂多层石墨烯的制备方法",
"summary" : "铜掺杂多层石墨烯的制备方法,涉及石墨烯,尤其是一种通过异质铜原子的掺杂,有效地调制多层石墨烯......池、荧光材料等领域。",
"applicant" : "昆明物理研究所",
"applicationDate" : "2018-06-05",
"mainIpc" : "C23C14/35",
"applicationNumber" : "CN201810025878.9",
"documentNumber" : "CN108251808A",
"documentDate" : "2018-07-06",
"inventor" : "唐利斌; 姬荣斌; 项金钟; 高树雄; 袁绶章; 魏虹; 铁筱滢; 李雄军; 左大凡; 王燕; 林占文; 韩福忠"
}, {
"id" : "CN108314034A",
"rank" : "0",
"legalStatus" : "公开",
"type" : "发明公开",
"title" : "一种多孔椰壳炭石墨化方法",
"summary" : "本发明属于碳质材料应用技术领域,具体涉及一种多孔椰壳炭石墨化方法。先将多孔椰壳炭粉碎过筛,.......层石墨烯或氧化石墨烯。",
"applicant" : "曾功昶",
"applicationDate" : "2018-05-16",
"mainIpc" : "C01B32/205",
"applicationNumber" : "CN201810465500.0",
"documentNumber" : "CN108314034A",
"documentDate" : "2018-07-24",
"inventor" : "曾功昶; 曾和平"
},
......
]
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| took | double | 请求耗时 |
| code | int | 状态码:具体请参考,状态码 |
| total | int | 总条数 |
| success | boolean | 请求是否成功 |
| nextPage | int | 下一页 |
| totalPages | int | 总页数 |
| page | int | 当前页 |
| patents | list | 专利列表 |
| id | string | 专利唯一ID |
| rank | int | 专利评级 |
| loc | string | LOC分类号 |
| legalStatus | string | 法律状态 |
| type | string | 专利类型 |
| title | string | 专利名称 |
| summary | string | 摘要 |
| applicant | string | 申请人 |
| applicationDate | string | 申请日 |
| applicationNumber | string | 申请号 |
| mainIpc | string | 主分类号 |
专利基本信息接口
| 接口URL: | /api/patent/base |
| 接口说明: |
该接口提供对单个专利的基本信息的查询功能。
特别说明:只有通过/s获取到的唯一ID才能访问,但每天允许前200个数据直接访问。否则返回215错误代码 |
| 实例: | https://www.patenthub.cn/api/patent/base?t=xx&id=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| id | 是 | 专利的唯一ID |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"code": 200,
"patent": {
"id": "CN1064309C",
"title": "光学热塑性氨基甲酸乙酯树脂透镜制造方法及其透镜",
"summary": "一种连续制造光学各性能优良并且在镜片全体上没有光学特性上不均匀斑的镜片的方法及通过这种方法制造的镜片。形成硫代氨基甲酸乙酯预聚物的第一工序及该硫代氨基甲酸乙酯预聚物与至少1种的氨基甲酸乙酯形成单体反应的第二工序,在挤出机内或后续工序的有挤出装置的反应器内部进行,将由前述挤出机或挤出装置挤出的光学用热塑性硫代氨基甲酸乙酯-氨基甲酸乙酯共聚合体延展为片状,该延展为片状的共聚体通过冲切形成镜片先导体,冲压该镜片先导体使该镜片先导体的至少一面具有设定曲面。",
"ipc": "B29D11/00; B29C47/00; G02B1/04; G02B3/00",
"fullPriorityNumber": "103483/1997 1997.04.21 JP",
"priorityNumber": "JP19970103483",
"applicant": "株式会社朝日光学; 奥普梯玛公司",
"assignee": "株式会社朝日光学,奥普梯玛公司",
"currentAssignee": "株式会社朝日光学,奥普梯玛公司",
"inventor": "杨州; 诸振亚; 林荫年; 小林忠; 斋藤祐义",
"applicationDate": "1998-04-17",
"applicationNumber": "CN98804400.5",
"applicantAddress": "日本福井",
"type": "发明授权",
"agency": "中国国际贸易促进委员会专利商标事务所",
"agent": "何腾云",
"legalStatus": "失效专利",
"currentStatus": "权利终止",
"imagePath": "/CN/1998/8/0/images/98804400.jpg",
"mainIpc": "B29D11/00",
"firstInventor": "杨州",
"firstApplicant": "株式会社朝日光学",
"pdfList": [
"/CN/api/2001/04/11/1/CN1064309C.pdf"
],
"documentNumber": "CN1064309C",
"documentDate": "2001-04-11",
"documentType": 2,
"pctDate":"2020-04-01",//PCT国际申请进入国家阶段日
"pctApplicationData":"PCT/GB2018/052408 2018.08.24",//PCT国际申请的申请数据
"pctPublicationData":"WO2019/038558 EN 2019.02.28",//PCT国际申请的公布数据
},
"success": true
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| id | string | 专利唯一ID |
| documentNumber | string | 文献号 |
| documentDate | string | 文献日 |
| applicationDate | string | 申请日 |
| applicationNumber | string | 申请号 |
| title | string | 专利名称 |
| summary | string | 摘要 |
| ipc | string | 国际分类号 |
| mainIpc | string | 主分类号 |
| loc | string | LOC分类号(外观设计才有) |
| fullPriorityNumber | string | 优先权 |
| priorityNumber | string | 优先权号 |
| applicant | string | 申请人 |
| assignee | string | 专利权人 |
| currentAssignee | string | 当前专利权人 |
| inventor | string | 发明人 |
| type | string | 专利类型 |
| agency | string | 专利代理机构 |
| agent | string | 代理人 |
| legalStatus | string | 法律状态 |
| imagePath | string | 专利摘要附图地址 |
| firstInventor | string | 第一发明人 |
| firstApplicant | string | 第一申请人 |
| pdfList | string | 专利文献全文PDF地址列表 |
| applicantAddress | string | 申请人地址 |
| pctDate | string | PCT国际申请进入国家阶段日 |
| pctApplicationData | string | PCT国际申请的申请数据 |
| pctPublicationData | string | PCT国际申请的公布数据 |
专利权利要求接口
| 接口URL: | /api/patent/claims |
| 接口说明: | 该接口提供对单个专利的权利要求的查询功能。 |
| 实例: | https://www.patenthub.cn/api/patent/claims?t=xx&id=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| id | 是 | 专利的唯一ID |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"code" : 200,
"patent" : {
"id" : "CN103532200B",
"applicationNumber" : "CN201310512089.5",
"documentNumber" : "CN103532200B",
"claims" : "1.一种新能源汽车的电池管理系统,其特征在于,包括:电能输入端,用于从所述新能源汽车的电池接收电能......"
},
"success" : true
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| id | string | 专利唯一ID |
| documentNumber | string | 文献号 |
| applicationNumber | string | 申请号 |
| claims | string | 专利权利要求代码化全文 |
专利说明书全文接口
| 接口URL: | /api/patent/desc |
| 接口说明: | 该接口提供对单个专利的说明书全文的查询功能。 |
| 实例: | https://www.patenthub.cn/api/patent/desc?t=xx&id=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| id | 是 | 专利的唯一ID |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"code" : 200,
"patent" : {
"id" : "CN108251808A",
"applicationNumber" : "CN201810025878.9",
"documentNumber" : "CN108251808A",
"description" : "铜掺杂多层石墨烯的制备方法\n技术领域\n[0001] 本发明涉及石墨烯,尤其是一种通过异质铜原子的掺杂......."
},
"success" : true
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| id | string | 专利唯一ID |
| documentNumber | string | 文献号 |
| applicationNumber | string | 申请号 |
| description | string | 专利说明书代码化全文 |
专利法律信息接口
| 接口URL: | /api/patent/tx |
| 接口说明: | 该接口提供对单个专利的法律信息的查询功能。
特别说明:只有通过/s获取到的唯一ID才能访问,但每天允许前200个数据直接访问。否则返回215错误代码 |
| 实例: | https://www.patenthub.cn/api/patent/tx?t=xx&id=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| id | 是 | 专利的唯一ID |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"code" : 200,
"success" : true,
"transactions" : [ {
"content" : "登记生效日: 2016.06.15\n专利权人由北京理工大学变更为陶丽\n地址由100081 北京市海淀区中关村南大街5号变更为100022 北京市朝阳区东三环中路39号建外SOHO7-503",
"date" : "2016-07-06",
"type" : "专利权的转移",
"applicationNumber" : "CN201010263656.4"
}, {
"content" : "授权",
"date" : "2012-07-25",
"type" : "授权",
"applicationNumber" : "CN201010263656.4"
}, {
"content" : "IPC(主分类): C01B 31/04 \n专利申请号: 201010263656.4 \n申请日: 2010.08.25",
"date" : "2011-03-09",
"type" : "实质审查的生效",
"applicationNumber" : "CN201010263656.4"
}, {
"content" : "公布",
"date" : "2011-01-12",
"type" : "公布",
"applicationNumber" : "CN201010263656.4"
}, {
"content" : null,
"date" : "2011-01-12",
"type" : "公开",
"applicationNumber" : "CN201010263656.4"
} ]
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| transactions | list | 专利事务列表 |
| applicationNubmer | string | 专利申请号 |
| type | string | 事务类型 |
| date | string | 发生日期 |
| content | string | 具体内容 |
专利引用数据接口
| 接口URL: | /api/patent/citing |
| 接口说明: | 该接口提供对单个专利的引用数据,包括专利引用、非专利引用和被引用。 |
| 实例: | https://www.patenthub.cn/api/patent/citing?t=xx&id=xx&v=1 |
| 参数 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| id | 是 | 专利的唯一ID |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"code" : 200,
"success" : true,
"citedList" : [ {
"id" : "CN102824883A",
"legalStatus" : "有效专利",
"type" : "发明公开",
"title" : "石墨烯/普鲁士蓝类配合物复合气凝胶、制备方法及应用",
"summary" : "本发明涉及一种石墨烯/普鲁士蓝类配合物复合气凝胶、制备方法及其应用......和电致变色性能。",
"applicant" : "北京理工大学",
"applicationDate" : "2012-08-27",
"mainIpc" : "B01J13/00",
"applicationNumber" : "CN201210309317.4"
} ],
"noPatentXref" : [ "杨常玲等.石墨烯的制备及其电化学性能.《电源技术》.2010,第34卷(第2期)," ],
"patentXref" : [ {
"id" : "CN101613098A",
"legalStatus" : "有效专利",
"type" : "发明公开",
"title" : "一种石墨烯的溶液相制备方法",
"summary" : "一种石墨烯的溶液相制备方法,其特征在于包括如下步骤:①石墨氧化......大规模生产的需要。",
"applicant" : "中国科学院宁波材料技术与工程研究所",
"applicationDate" : "2009-06-12",
"mainIpc" : "C01B31/02",
"applicationNumber" : "CN200910099595.X"
} ]
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| citedList | list | 被引用专利列表 |
| id | string | 专利唯一ID |
| rank | string | 专利评级 |
| loc | string | LOC分类号 |
| applicant | string | 申请人 |
| applicationDate | string | 申请日 |
| applicationNumber | string | 申请号 |
| type | string | 专利类型 |
| legalStatus | string | 法律状态 |
| mainIpc | string | 主分类号 |
| noPatentXref | list | 非专利引用列表 |
| patentXref | string | 专利引用列表 |
相似专利接口
| 接口URL: | /api/patent/like |
| 接口说明: | 该接口提供某个专利的相似专利查询。 |
| 实例: | https://www.patenthub.cn/api/patent/like?t=xx&id=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| id | 是 | 专利的唯一ID |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"code" : 200,
"patentLikeList" : [ {
"id" : "CN101941693B",
"rank" : "247.5315",
"legalStatus" : "有效专利",
"type" : "发明授权",
"title" : "一种石墨烯气凝胶及其制备方法",
"summary" : "本发明提供了一种石墨烯气凝胶的制备方法,包括:在中性、酸性或者碱性水溶液中.......且制备的气凝胶能够具备石墨烯的特性。",
"applicant" : "北京理工大学",
"applicationDate" : "2010-08-25",
"mainIpc" : "C01B31/04",
"applicationNumber" : "CN201010263656.4",
"documentNumber" : "CN101941693B",
"documentDate" : "2012-07-25",
"inventor" : "张学同,隋竹银,罗运军"
}, {
"id" : "CN101941693A",
"rank" : "247.5315",
"legalStatus" : "有效专利",
"type" : "发明公开",
"title" : "一种石墨烯气凝胶及其制备方法",
"summary" : "本发明提供了一种石墨烯气凝胶的制备方法,包括:在中性、酸性或者碱性水溶液中......具备石墨烯的特性。",
"applicant" : "北京理工大学",
"applicationDate" : "2010-08-25",
"mainIpc" : "C01B31/04",
"applicationNumber" : "CN201010263656.4",
"documentNumber" : "CN101941693A",
"documentDate" : "2011-01-12",
"inventor" : "张学同,隋竹银,罗运军"
}, {
"id" : "CN105271212A",
"rank" : "31.0",
"legalStatus" : "有效专利",
"type" : "发明公开",
"title" : "一种石墨烯气凝胶材料及其制备方法",
"summary" : "本发明公开了一种石墨烯气凝胶材料及其制备方法,所述方法包括如下步骤:(1)制备前驱体溶液.......可作为高温隔热材料使用。",
"applicant" : "航天特种材料及工艺技术研究所",
"applicationDate" : "2015-11-30",
"mainIpc" : "C01B31/04",
"applicationNumber" : "CN201510846174.4",
"documentNumber" : "CN105271212A",
"documentDate" : "2016-01-27",
"inventor" : "郭慧,刘斌,金兆国,赵英民,裴雨辰"
},
......
],
"success" : true
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| patentLikeList | list | 相似专利列表 |
| id | string | 专利唯一ID |
| rank | string | 专利评级 |
| loc | string | LOC分类号 |
| applicant | string | 申请人 |
| applicationDate | string | 申请日 |
| applicationNumber | string | 申请号 |
| type | string | 专利类型 |
| legalStatus | string | 法律状态 |
| mainIpc | string | 主分类号 |
PDF全文下载
| 接口URL: | /api/pdf |
| 接口说明: | 通过该接口获取某一个专利的PDF全文数据。 |
| 实例: | https://www.patenthub.cn/api/pdf?key=/CN/api/2016/03/30/2/CN205106451U.pdf&t=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| v | 是 | version,版本号,当前版本号为1 |
| key | 是 | PDF路径,可以从专利基本信息接口中的pdfList中获取 |
| 响应结果 | |||
|---|---|---|---|
字节流
|
|||
专利摘要附图
| 接口URL: | /api/img |
| 接口说明: | 通过该接口获取某一个专利的摘要附图数据。 |
| 实例: | https://www.patenthub.cn/api/img?key=xx&t=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| v | 是 | version,版本号,当前版本号为1 |
| key | 是 | 图片路径,可以从专利基本信息接口中的imagePath字段中获取 |
| 响应结果 | |||
|---|---|---|---|
字节流
|
|||
专利说明书附图列表
| 接口URL: | /api/patent/drawings |
| 接口说明: | 该接口提供某个专利的说明书附图。(目前仅支持查询中国外观专利和2010以后的发明和实用专利、以及美国专利的说明书附图) |
| 实例: | https://www.patenthub.cn/api/patent/drawings?t=xx&id=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| id | 是 | 专利的唯一ID |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
|
|||
| 核心字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| drawings | list | 说明书附图列表 |
| id | string | 专利唯一ID |
| drawings核心字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| name | string | 图片名字 |
| thumbPath | string | 图片地址 |
| bigPath | string | 大图地址 |
专利说明书附图下载
| 接口URL: | /api/pic |
| 接口说明: | 通过该接口获取某一个专利的说明书附图数据。 |
| 实例: | https://www.patenthub.cn/api/pic?key=xx&t=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| v | 是 | version,版本号,当前版本号为1 |
| key | 是 | 图片路径,可以从专利基本信息接口中的imagePath字段中获取 |
| 响应结果 | |||
|---|---|---|---|
字节流
|
|||
企业画像
| 接口URL: | /api/a/portrait |
| 接口说明: | 该接口提供企业相关的统计数据包括法律状态统计、专利类型统计、申请趋势、公开趋势、授权趋势、专利布局、核心发明人、核心技术领域、核心技术领域的主要竞争对手。 |
| 实例: | https://www.patenthub.cn/api/a/portrait?en=xx&t=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| en | 是 | 需要查询的企业的名称,注意为了数据准确性必须是全称 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"code" : 200,
"success" : true,
"enterprisePortrait" : {
"legalMap" : {
"有效专利" : 24024,
.....
},
"typeMap" : {
"发明专利" : 38292,
.....
},
"legalApplicationYearMap" : {
"1999" : {
"失效专利" : 11,
"有效专利" : 6
},
......
},
"areaMap" : {
"中国" : 193
},
"areaYearMap" : {
"1999" : {
"中国" : 17
},
......
},
"ipcMap" : {
"H04M" : 2778,
......
},
"compareMap" : {
"1" : "中兴通讯股份有限公司",
"2" : "高通股份有限公司",
"3" : "三星电子株式会社",
"4" : "鸿海精密工业股份有限公司",
"5" : "联想(北京)有限公司"
},
"applicationYearMap" : {
"1999" : 17,
......
},
"publicationYearMap" : {
"2001" : 58,
......
},
"grantYearMap" : {
"2001" : 28,
......
},
"inventorMap" : {
"李强" : 177,
......
}
}
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| enterprisePortrait | object | 企业画像 |
| legalMap | map | 专利有效性分布 |
| typeMap | map | 专利类型分布 |
| legalApplicantYearMap | map | 每年专利有效性的分布情况 |
| areaMap | map | 专利区域布局情况 |
| areaYearMap | map | 每年专利区域分布情况 |
| ipcMap | map | 主要的技术分布 |
| compareMap | map | 主要的竞争对手排行 |
| applicationYearMap | map | 申请趋势 |
| publicationYearMap | map | 公开趋势 |
| grantYearMap | map | 授权趋势 |
| inventorMap | map | 核心发明人分布 |
商标搜索接口
| 接口URL: | /api/tm/s |
| 接口说明: | 该接口提供对商标的检索功能,用户输入想要查找的关键词或者符合语法规范的短语即可对商标数据进行检索。 |
| 实例: | https://www.patenthub.cn/api/tm/s?t=xx&q=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| q | 是 | 用户输入的查询条件 |
| p | 否 | page页码,默认值1,最大页码为100页;系统将根据用户输入的页码返回该页的数据 |
| ps | 否 | pageSize,每页展现数据的条数,默认10条,单页最大50条;系统将根据用户指定的每页显示条数返回搜索数据 |
| s | 否 | sort,排序字段,默认值relation,有4个有效值:relation(相关度),applicationDate(申请时间);可以在applicationDate前面加感叹号,感叹号表示降序,如果不加表示升序。 |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"took" : 52,
"total" : 162,
"code" : 200,
"success" : true,
"nextPage" : 3,
"totalPages" : 9,
"page" : 2,
"tms" : [ {
"id" : "2020163926c8006d56dba63557fbefe8213a3aaa",
"type" : "普通",
"country" : "CN",
"applicationNumber" : 20774275,
"ncl" : [ "第42类 网站服务" ],
"applicant" : [ "上海超碳石墨烯产业技术有限公司" ],
"applicationDate" : "2016-07-26",
"lawStatus" : "商标注册申请等待受理中",
"agent" : [ "律享知识产权代理(上海)有限公司" ],
"imagePath" : "/tm/cn/20774275.jpg",
"applicantLabel" : "上海超碳石墨烯产业技术有限公司",
"countryLabel" : "中国",
"agentLabel" : "律享知识产权代理(上海)有限公司"
}, {
"id" : "202016f23ba86233028d3254b1ecebcb17b45041",
"type" : "普通",
"country" : "CN",
"applicationNumber" : 20773731,
"ncl" : [ "第06类 金属材料" ],
"applicant" : [ "上海超碳石墨烯产业技术有限公司" ],
"applicationDate" : "2016-07-26",
"lawStatus" : "商标注册申请等待受理中",
"agent" : [ "律享知识产权代理(上海)有限公司" ],
"imagePath" : "/tm/cn/20773731.jpg",
"applicantLabel" : "上海超碳石墨烯产业技术有限公司",
"countryLabel" : "中国",
"agentLabel" : "律享知识产权代理(上海)有限公司"
}
......
]
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| took | double | 请求耗时 |
| code | int | 状态码:具体请参考,状态码 |
| total | int | 总条数 |
| success | boolean | 请求是否成功 |
| nextPage | int | 下一页 |
| totalPages | int | 总页数 |
| page | int | 当前页 |
| tms | list | 商标列表 |
| id | string | 商标唯一ID |
| type | int | 类型 |
| country | string | 国家编码 |
| applicationNumber | string | 申请号 |
| ncl | list | 国际分类 |
| applicant | list | 申请人 |
| applicationDate | string | 申请日 |
| lawStatus | string | 法律状态 |
| agent | list | 代理人 |
| imagePath | string | 图片路径 |
| applicantLabel | string | 申请人 |
| countryLabel | string | 国家 |
| agentLabel | string | 代理人 |
商标详情信息接口
| 接口URL: | /api/tm/base |
| 接口说明: | 该接口提供对单个商标的基本信息的查询功能。 |
| 实例: | https://www.patenthub.cn/api/tm/base?t=xx&id=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| id | 是 | 商标的唯一ID |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"code" : 200,
"success" : true,
"tm" : {
"id" : "2020163926c8006d56dba63557fbefe8213a3aaa",
"type" : "普通",
"country" : "CN",
"applicationNumber" : 20774275,
"registerNumber" : 20774275,
"ncl" : [ "第42类 网站服务" ],
"applicant" : [ "上海超碳石墨烯产业技术有限公司" ],
"applicantAddress" : [ "上海市宝山区真陈路1000号3楼" ],
"applicationDate" : "2016-07-26",
"announcementNumber" : 0,
"registrationNumber" : 0,
"collective" : false,
"lawStatus" : "商标注册申请等待受理中",
"agent" : [ "律享知识产权代理(上海)有限公司" ],
"trademarkStatus" : [ {
"date" : "null",
"content" : "商标注册申请等待受理中",
"code" : "208"
} ],
"imagePath" : "/tm/cn/20774275.jpg",
"applicantLabel" : "上海超碳石墨烯产业技术有限公司",
"countryLabel" : "中国",
"agentLabel" : "律享知识产权代理(上海)有限公司"
}
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| id | string | 商标唯一ID |
| type | string | 类型 |
| country | string | 国家编码 |
| applicationNumber | int | 申请号 |
| registerNumber | int | 注册号 |
| ncl | list | 国际分类 |
| applicant | list | 申请人 |
| applicantAddress | list | 申请人地址 |
| applicationDate | string | 申请日 |
| announcementNumber | int | 初审公告号 |
| registrationNumber | int | 注册公告号 |
| collective | boolean | 是否共有商标 |
| lawStatus | string | 法律状态 |
| agent | list | 代理人 |
| trademarkStatus | list | 法律事务 |
| imagePath | string | 图片地址 |
| applicantLabel | string | 申请人 |
| countryLabel | string | 国家 |
| agentLabel | string | 代理人 |
商标图片
| 接口URL: | /api/tm/img |
| 接口说明: | 通过该接口获取某一个商标的图片数据。 |
| 实例: | https://www.patenthub.cn/api/tm/img?key=xx&t=xx&id=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| v | 是 | version,版本号,当前版本号为1 |
| key | 是 | 图片路径,可以从商标基本信息接口中的imagePath字段中获取 |
| id | 是 | 商标唯一ID |
| 响应结果 | |||
|---|---|---|---|
字节流
|
|||
国际外观专利检索接口
| 接口URL: | /api/world/design |
| 请求方式: | POST,Content-Type: multipart/form-data 或 application/x-www-form-urlencoded |
| 接口说明: | 国际(含海牙体系等)外观专利检索。支持图样文件上传、Base64 传图与/或关键词检索;分页固定为第 1 页,仅可通过 size 指定本页返回条数(默认 50,最大 100)。参数要求: image、imageBase64 与 keyword 至少提供其一(图样二选一即可)。 |
| 实例: | POST https://www.patenthub.cn/api/world/design,使用表单提交字段(见参数列表);传图可用 multipart 上传 image,或提交 imageBase64(纯 Base64 或带 data:image/...;base64, 前缀)。 |
| 大图传参建议: |
推荐顺序:① multipart/form-data + image 文件上传(无 Base64 膨胀,最稳)→ ② 同 Content-Type 下以普通表单字段提交 imageBase64 → ③ 仅小图可用 application/x-www-form-urlencoded + imageBase64。原因:Base64 体积约为原图的 1.33 倍; urlencoded 将整个 Base64 串放入请求体单字段,易触及网关或 Tomcat 的 POST 体大小上限(常见约 2MB),表现为 413 或连接中断。实践建议:原图超过约 200KB 时勿用 urlencoded 传 imageBase64;大图优先二进制上传,或对客户端图片做压缩/缩略后再检索。
|
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| v | 是 | version,版本号,当前版本号为1 |
| image | 否 | 待检索图样图片文件(multipart/form-data);与 imageBase64、keyword 至少提供其一;若同时提供 image 与 imageBase64,优先使用上传文件。 |
| imageBase64 | 否 | 待检索图样的 Base64 编码字符串;可与 keyword 组合使用;支持 data:image/png;base64,... 形式。 |
| keyword | 否 | 关键词,参与检索式拼装(设计师名称或产品名称相关字段)。 |
| size | 否 | 本页返回记录条数;默认 50,范围 1~100。不提供页码参数,固定为第 1 页。 |
| tProtection | 否 | 国家/保护范围筛选;多个取值用英文逗号分隔,对应检索 filters 字段 tProtection。 |
| locarnoClass | 否 | LOC 洛迦诺分类筛选;多个取值用英文逗号分隔,对应 locarnoClass。 |
| 响应结果 | |||
|---|---|---|---|
{
"success" : true,
"code" : 200,
"data" : {
"total" : 10000,
"records" : [ {
"images" : [ {
"name" : "EM700000008710644-0007-001"
} ],
"ST13" : "EM700000008710644-0007",
"applicationNumber" : "008710644",
"tProtection" : [ "DE", "BE", "FI", "PT", "BG", "DK", "LT", "LU", "HR", "LV", "FR", "HU", "SE", "SI", "BX", "SK", "IE", "EE", "MT", "EM", "GR", "IT", "ES", "AT", "CY", "CZ", "PL", "RO", "NL" ],
"priorityNumber" : "2021/004273",
"applicantName" : [ "KÜTAHYA PORSELEN SANAYI ANONIM SIRKETI" ],
"office" : "EM",
"priorityCountry" : "TR",
"indicationOfProduct" : [ {
"languageCode" : "bg",
"indicationOfProduct" : "Чинийки за хляб или гарнитура"
} ],
"designerName" : "KARIM RASHID",
"expiryDate" : "2026-09-30T12:00:00.000Z",
"designNumber" : "008710644-0007",
"locarnoClass" : [ "07.01" ],
"imagePaths" : [ "https://dt.patenthub.cn/world_design/assets/EM/img/EM70000000871/EM700000008710644-0007/EM700000008710644-0007-001.webp" ],
"image_path" : "https://dt.patenthub.cn/world_design/assets/EM/img/EM70000000871/EM700000008710644-0007/EM700000008710644-0007-001.webp",
"designStatus" : "Registered and fully published",
"registrationDate" : "2021-09-30T12:00:00.000Z",
"preferredImageUrl" : "EM700000008710644-0007-001",
"priorityDate" : [ "2021-04-06T12:00:00.000Z" ],
"id" : "EM700000008710644-0007",
"representativeName" : "CABINET CHAILLOT",
"thumbnailUrl" : "EM700000008710644-0007-001",
"applicationDate" : "2021-09-30T12:00:00.000Z",
"score" : 0.987654321
} ]
}
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:200 成功;205 参数错误(如未提供 image/imageBase64 与关键词);203 检索过程异常。 |
| success | boolean | 请求是否成功 |
| data.total | int | 本次检索符合条件的总记录数。 |
| data.records | list | 当前页结果记录列表。 |
以下为 data.records 中单条对象的常见字段(不同案卷可能略有增减) |
||
| id | string | 记录标识。 |
| ST13 | string | 国际注册或公开编号类标识(与 id 常一致)。 |
| applicationNumber | string | 申请号。 |
| designNumber | string | 外观设计编号。 |
| office | string | 主管局/受理局代码。 |
| tProtection | list | 指定缔约方或保护范围国家/地区代码列表。 |
| locarnoClass | list | 洛迦诺分类号列表。 |
| designerName | string | 设计师名称。 |
| applicantName | list | 申请人名称列表。 |
| representativeName | string | 代理人或代理机构名称。 |
| indicationOfProduct | list | 产品名称说明;每项含 languageCode(语言代码)、indicationOfProduct(该语文下的产品说明)。 |
| designStatus | string | 外观设计法律状态描述。 |
| applicationDate | string | 申请日(ISO 8601 格式时间串)。 |
| registrationDate | string | 注册日。 |
| expiryDate | string | 届满日或有效期相关日期。 |
| priorityNumber | string | 优先权号。 |
| priorityCountry | string | 优先权国家/地区代码。 |
| priorityDate | list | 优先权日列表。 |
| images | list | 图样项列表;每项含 name(图样名称或编号)。 |
| image_path | string | 主图或首图完整访问地址(含域名 https://dt.patenthub.cn)。 |
| imagePaths | list | 各图样完整访问地址列表(含域名)。 |
| preferredImageUrl | string | 推荐展示图标识或短码(与图档命名相关)。 |
| thumbnailUrl | string | 缩略图标识或短码。 |
| score | double | 相似度得分,范围 0.0-1.0。 |
国际商标图形检索接口
| 接口URL: | /api/world/tm/graphic |
| 请求方式: | POST,Content-Type: multipart/form-data 或 application/x-www-form-urlencoded |
| 接口说明: | 国际商标图样相似检索。须提供商标图样(文件或 Base64);分页固定第 1 页,仅可通过 size 控制条数(默认 50,最大 100)。参数要求:表单字段 image(图样文件)与 imageBase64 二选一,至少提供其一。 |
| 实例: | POST https://www.patenthub.cn/api/world/tm/graphic,表单含 image 或 imageBase64 等字段。 |
| 大图传参建议: |
推荐顺序:① multipart/form-data + image 文件上传(无 Base64 膨胀,最稳)→ ② 同 Content-Type 下以普通表单字段提交 imageBase64 → ③ 仅小图可用 application/x-www-form-urlencoded + imageBase64。原因:Base64 体积约为原图的 1.33 倍; urlencoded 将整个 Base64 串放入请求体单字段,易触及网关或 Tomcat 的 POST 体大小上限(常见约 2MB),表现为 413 或连接中断。实践建议:原图超过约 200KB 时勿用 urlencoded 传 imageBase64;大图优先二进制上传,或对客户端图片做压缩/缩略后再检索。
|
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| v | 是 | version,版本号,当前版本号为1 |
| image | 否 | 待检索的商标图样文件(multipart/form-data);与 imageBase64 二选一;若同时提供,优先使用上传文件。 |
| imageBase64 | 否 | 待检索商标图样的 Base64 编码;与 image 二选一;支持 data:image/png;base64,... 形式。 |
| keyword | 否 | 附加文字条件(商标名称检索式片段)。 |
| size | 否 | 本页条数,默认 50,最大 100。 |
| tmOffice | 否 | 国家/商标主管机关筛选,多个取值英文逗号分隔。 |
| niceClass | 否 | 尼斯分类筛选,多个取值英文逗号分隔。 |
| 响应结果 | |||
|---|---|---|---|
{
"success" : true,
"code" : 200,
"data" : {
"total" : 10000,
"records" : [ {
"ST13" : "US500000076542047",
"applicationNumber" : "76542047",
"applicantName" : [ "BOSS MANUFACTURING CO." ],
"tradeMarkStatus" : "Ended",
"niceClass" : [ 25 ],
"viennaCodes" : [ "01.15.25", "09.05.01", "09.05.25", "26.17.25" ],
"registrationNumber" : "2916982",
"tradeMarkType" : "Figurative",
"image_path" : "https://dt.patenthub.cn/world_tm/assets/US/img/50000007654/US500000076542047.webp",
"registrationDate" : "2005-01-11T12:00:00.000Z",
"id" : "US500000076542047",
"tmOffice" : "US",
"applicationDate" : "2003-08-28T12:00:00.000Z",
"score" : 0.987654321
} ]
}
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 200 成功;205 未提供图样(image/imageBase64)等参数错误;203 检索异常。 |
| success | boolean | 请求是否成功 |
| data.total | int | 本次检索符合条件的总记录数。 |
| data.records | list | 当前页结果记录列表。 |
以下为 data.records 中单条对象的常见字段(不同案卷可能略有增减) |
||
| id | string | 商标记录标识。 |
| ST13 | string | 商标公开/注册文献号类标识(与 id 常一致)。 |
| tmOffice | string | 商标主管机关国家/地区代码。 |
| applicationNumber | string | 申请号。 |
| registrationNumber | string | 注册号。 |
| tradeMarkType | string | 商标类型,如 Figurative(图形商标)。 |
| tradeMarkStatus | string | 商标流程或法律效力状态描述。 |
| niceClass | list | 尼斯国际分类号列表。 |
| viennaCodes | list | 维也纳图形要素分类代码列表。 |
| applicantName | list | 申请人名称列表。 |
| tmName | string | 图形检索下多数记录不含该字段;若有则为商标名称文本。 |
| applicationDate | string | 申请日(ISO 8601 格式时间串)。 |
| registrationDate | string | 注册日。 |
| image_path | string | 商标图样完整访问地址(含域名 https://dt.patenthub.cn)。 |
| score | double | 相似度得分,范围 0.0-1.0。 |
国际商标文字检索接口
| 接口URL: | /api/world/tm/text |
| 请求方式: | POST;支持 multipart/form-data 或 application/x-www-form-urlencoded |
| 接口说明: | 按商标名称等文字条件检索国际商标数据。分页固定第 1 页,通过 size 控制返回条数(默认 50,最大 100)。不涉及图样上传。 |
| 实例: | POST https://www.patenthub.cn/api/world/tm/text,表单字段 keyword=苹果&size=20(urlencoded 或 multipart 均可)。 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| v | 是 | version,版本号,当前版本号为1 |
| keyword | 是 | 检索关键词(商标名称侧检索式)。 |
| size | 否 | 本页条数,默认 50,最大 100。 |
| tmOffice | 否 | 国家/商标主管机关筛选,多个取值英文逗号分隔。 |
| niceClass | 否 | 尼斯分类筛选,多个取值英文逗号分隔。 |
| 响应结果 | |||
|---|---|---|---|
{
"success" : true,
"code" : 200,
"data" : {
"total" : 10000,
"records" : [ {
"tmName" : "APPLE WEAR",
"niceClass" : [ 25 ],
"ST13" : "US500000073362092",
"applicationNumber" : "73362092",
"tradeMarkType" : "Stylized characters",
"image_path" : "https://dt.patenthub.cn/world_tm/assets/US/img/50000007336/US500000073362092.webp",
"id" : "US500000073362092",
"applicantName" : [ "Apple Wear Company, The" ],
"tmOffice" : "US",
"tradeMarkStatus" : "Ended",
"applicationDate" : "1982-04-29T12:00:00.000Z"
} ]
}
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 200 成功;205 关键词为空等参数错误;203 检索异常。 |
| success | boolean | 请求是否成功 |
| data.total | int | 本次检索符合条件的总记录数。 |
| data.records | list | 当前页结果记录列表。 |
以下为 data.records 中单条对象的常见字段(不同案卷可能略有增减) |
||
| id | string | 商标记录标识。 |
| ST13 | string | 商标公开/注册文献号类标识(与 id 常一致)。 |
| tmName | string | 商标名称或显著识别文字。 |
| tmOffice | string | 商标主管机关国家/地区代码。 |
| applicationNumber | string | 申请号。 |
| tradeMarkType | string | 商标类型,如 Stylized characters(风格化文字)等。 |
| tradeMarkStatus | string | 商标流程或法律效力状态描述。 |
| niceClass | list | 尼斯国际分类号列表。 |
| applicantName | list | 申请人名称列表。 |
| applicationDate | string | 申请日(ISO 8601 格式时间串)。 |
| image_path | string | 商标图样完整访问地址(含域名 https://dt.patenthub.cn)。 |
国际商标文字批量检索接口
| 接口URL: | /api/world/tm/text/batch |
| 请求方式: | POST;支持 multipart/form-data 或 application/x-www-form-urlencoded |
| 接口说明: | 按多个商标名称关键词分别检索国际商标数据,单次最多 10 个关键词。每个关键词独立返回检索结果,分页固定第 1 页,通过 size 控制每个关键词的返回条数(默认 50,最大 100)。不涉及图样上传。 |
| 实例: | POST https://www.patenthub.cn/api/world/tm/text/batch,表单字段 keywords=苹果,华为,三星&size=20(urlencoded 或 multipart 均可)。 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| v | 是 | version,版本号,当前版本号为1 |
| keywords | 是 | 多个检索关键词,支持英文逗号、中文逗号、分号、顿号或换行分隔;单次最多 10 个。 |
| size | 否 | 每个关键词的本页条数,默认 50,最大 100。 |
| tmOffice | 否 | 国家/商标主管机关筛选,多个取值英文逗号分隔。 |
| niceClass | 否 | 尼斯分类筛选,多个取值英文逗号分隔。 |
| 响应结果 | |||
|---|---|---|---|
{
"success" : true,
"code" : 200,
"data" : {
"items" : [ {
"keyword" : "苹果",
"total" : 10000,
"records" : [ {
"tmName" : "APPLE WEAR",
"niceClass" : [ 25 ],
"ST13" : "US500000073362092",
"applicationNumber" : "73362092",
"tradeMarkType" : "Stylized characters",
"image_path" : "https://dt.patenthub.cn/world_tm/assets/US/img/50000007336/US500000073362092.webp",
"id" : "US500000073362092",
"applicantName" : [ "Apple Wear Company, The" ],
"tmOffice" : "US",
"tradeMarkStatus" : "Ended",
"applicationDate" : "1982-04-29T12:00:00.000Z"
} ]
}, {
"keyword" : "华为",
"total" : 500,
"records" : [ ]
} ]
}
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 200 成功;205 关键词为空或超过 10 个等参数错误;203 检索异常。 |
| success | boolean | 请求是否成功 |
| data.items | list | 各关键词的检索结果列表,顺序与输入关键词一致。 |
以下为 data.items 中单条对象的字段 |
||
| keyword | string | 当前检索使用的关键词。 |
| total | int | 该关键词检索符合条件的总记录数。 |
| records | list | 该关键词当前页的结果记录列表,单条记录字段同国际商标文字检索接口。 |
找商标接口
| 接口URL: | /api/world/tm/detect |
| 请求方式: | POST;支持 multipart/form-data 或 application/x-www-form-urlencoded |
| 接口说明: | 从给定文本中识别并提取其中的商标词,返回匹配位置及对应商标名称。不涉及图样上传。 |
| 实例: | POST https://www.patenthub.cn/api/world/tm/detect,表单字段 text=Apple iPhone 手机壳&caseSensitive=false(urlencoded 或 multipart 均可)。 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| v | 是 | version,版本号,当前版本号为1 |
| text | 是 | 待分析的文本内容。 |
| caseSensitive | 否 | 是否区分大小写,默认 false。 |
| 响应结果 | |||
|---|---|---|---|
{
"success" : true,
"code" : 200,
"data" : {
"text" : "Apple iPhone 手机壳",
"match_count" : 2,
"matches" : [ {
"trademark" : "APPLE",
"start_pos" : 0,
"end_pos" : 5,
"matched_text" : "Apple"
}, {
"trademark" : "IPHONE",
"start_pos" : 6,
"end_pos" : 12,
"matched_text" : "iPhone"
} ]
}
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 200 成功;205 文本为空等参数错误;203 找商标异常。 |
| success | boolean | 请求是否成功 |
| data.text | string | 输入的原始文本。 |
| data.match_count | int | 识别到的商标匹配数量。 |
| data.matches | list | 匹配结果列表。 |
以下为 data.matches 中单条对象的字段 |
||
| trademark | string | 识别到的标准商标名称。 |
| start_pos | int | 匹配文本在原文中的起始位置(从 0 开始)。 |
| end_pos | int | 匹配文本在原文中的结束位置(不含该位置字符)。 |
| matched_text | string | 原文中实际匹配到的文本片段。 |
专利统计分析接口
| 接口URL: | /api/ration |
| 接口说明: | 该接口提供对全球专利查询的统计分析功能,返回前20条统计项。 |
| 实例: | https://www.patenthub.cn/api/ration?ds=xx&t=xx&q=xx&c=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| ds | 否 | dataScope,数据范围,目前支持cn:中国,all:全球,默认cn |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| v | 是 | version,版本号,当前版本号为1 |
| q | 是 | 用户输入的查询条件 |
| limit | 否 | 返回用户统计结果最大数量,支持最大50条,超过无效 |
| c | 是 | 专利分析维度,目前支持countryCode国家代码、firstApplicant第一申请人、firstInventor第一发明人、legalStatus专利有效性、applicationYear申请日、documentYear公开公告日、applicant申请人、inventor发明人、ipc、ipc1大类、ipc2小类、ipc3大组、ipc4小组、loc、province中国省市、city中国市区、type专利类型、currentStatus当前法律状态、currentAssignee当前专利权人、agency代理机构、agent代理人、legalEvent法律事件、assignee专利权人。 |
| 响应结果 | |||
|---|---|---|---|
{
"analysis_total" :
"[{\"key\":\"H01\",\"count\":15935},
{\"key\":\"C08\",\"count\":8412},
{\"key\":\"C01\",\"count\":7690},
{\"key\":\"C09\",\"count\":5002},
{\"key\":\"B01\",\"count\":4742},
{\"key\":\"G01\",\"count\":3299},
{\"key\":\"B82\",\"count\":2983},
{\"key\":\"C02\",\"count\":1830},
{\"key\":\"B32\",\"count\":1362},
{\"key\":\"A61\",\"count\":1340},
{\"key\":\"C23\",\"count\":1237},
{\"key\":\"C04\",\"count\":1183},
{\"key\":\"H05\",\"count\":1148},
{\"key\":\"B29\",\"count\":1111},
{\"key\":\"G06\",\"count\":1057},
{\"key\":\"C10\",\"count\":998},
{\"key\":\"G02\",\"count\":941},
{\"key\":\"C22\",\"count\":884},
{\"key\":\"D01\",\"count\":863},
{\"key\":\"C07\",\"count\":839}]",
"code" : 200,
"success" : true
}
|
|||
接口使用情况调用
| 接口URL: | /api/used |
| 接口说明: | 该接口提供对单个接口的使用情况的查询。 |
| 实例: | https://www.patenthub.cn/api/used?t=xx&day=xx&v=1&apiUrl=xx |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| apiUrl | 是 | 要查询API接口url路径,如:/api/s 、/api/patent/base等 |
| v | 是 | version,版本号,当前版本号为1 |
| day | 否 | 对按年付费的接口,必须指定查询某一天的接口情况,否则会报错,按次付费的即可无需指定该值 |
| 响应结果 | |||
|---|---|---|---|
{
"remainNum" : 7138,
"total" : 10000,
"code" : 200,
"success" : true,
"visitNum" : 2862
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| visitNum | int | 已经使用的量 |
| remainNum | int | 剩余数量 |
| total | int | 总量,仅按次接口有该数据 |
| yearRemainPatentNum | int | 专利年剩余量,仅按年付费接口有该数据 |
法律状态批量查询
| 接口URL: | /api/ls |
| 接口说明: | 该接口提供对专利当前法律状态、有效性实时批量返回,用户输入想要查找的关键词或者符合语法规范的短语即可对专利数据进行检索。只支持返回前1000条记录,
如果需要获取更多记录建议拆分检索式,比如增加时间范围。
|
| 实例: | https://www.patenthub.cn/api/ls?ds=cn&t=xx&q=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| ds | 否 | dataScope,数据范围,目前支持cn:中国,all:全球,默认cn |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| q | 是 |
用户输入的查询条件,可以是检索式,具体如何编写检索式可以参考《检索帮助文档》
案例:1、查询石墨烯领域的专利 q=石墨烯2、查询柳沈的代理的专利 q=agency:北京市柳沈律师事务所 3、查询石墨烯相关的2014年和2015年的公开的专利 q=documentYear:[2014 TO 2015] AND 石墨烯 4、查询石墨烯相关的发明授权且有效的专利 q=石墨烯 AND type:发明授权 AND legalStatus:有效专利 |
| p | 否 | page页码,默认值1,最大页码为100页,最多返回1000条记录;系统将根据用户输入的页码返回该页的数据 |
| ps | 否 | pageSize,每页展现数据的条数,默认10条,单页最大50条;系统将根据用户指定的每页显示条数返回搜索数据 |
| s | 否 | sort,排序字段,默认值relation,有4个有效值:relation(相关度),applicationDate(申请时间)、documentDate(公开(公告)时间)、rank(专利评级);可以在applicationDate、documentDate前面加感叹号,感叹号表示降序,如果不加表示升序。 |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"took" : 638,
"total" : 58981,
"code" : 200,
"success" : true,
"nextPage" : 2,
"totalPages" : 5899,
"patents" : [ {
"id" : "CN108251808A",
"legalStatus" : "公开",
"currentStatus" : "公开",
"documentNumber" : "CN108251808A",
"applicationNumber" : "CN201810025878.9"
}, {
"id" : "CN108314034A",
"legalStatus" : "公开",
"currentStatus" : "公开",
"documentNumber" : "CN108314034A",
"applicationNumber" : "CN201810465500.0"
},
......
]
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| took | double | 请求耗时 |
| code | int | 状态码:具体请参考,状态码 |
| total | int | 总条数 |
| success | boolean | 请求是否成功 |
| nextPage | int | 下一页 |
| totalPages | int | 总页数 |
| page | int | 当前页 |
| patents | list | 专利列表 |
| id | string | 专利唯一ID |
| legalStatus | string | 有效性 |
| currentStatus | string | 当前法律状态 |
| documentNumber | string | 文献号 |
| applicationNumber | string | 申请号 |
专利详细信息接口
| 接口URL: | /api/patent/detail |
| 接口说明: |
该接口提供对单个专利的详细信息的查询功能。
|
| 实例: | https://www.patenthub.cn/api/patent/detail?t=xx&id=xx&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| id | 是 | 专利的唯一ID |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"code" : 200,
"patent" : {
"id" : "CN111344253A",
"title" : "3D石墨烯",
"summary" : "一种形成附着于基底表面的3D石墨烯材料的方法,包括:在基底表面上提供碳源;和将至少一部分所述碳源和/或至少一部分所述基底暴露于激光束,从而将至少一部分所述碳源转化为附着于所述基底表面的3D石墨烯材料。",
"ipc" : "C01B32/184; C30B1/02; C30B29/02",
"fullPriorityNumber" : "17187835.8 2017.08.24 EP",
"priorityNumber" : "EP20170187835",
"applicant" : "RD石墨烯有限公司",
"assignee" : "RD石墨烯有限公司",
"inventor" : "马尔科·卡菲奥; 克劳斯·马阔特",
"applicationDate" : "2018-08-24",
"applicationNumber" : "CN201880064241.9",
"applicantAddress" : "英国斯特灵",
"type" : "发明公开",
"agency" : "北京康信知识产权代理有限责任公司",
"agent" : "陈方鸣",
"legalStatus" : "无效专利",
"currentStatus" : "驳回",
"imagePath" : "/CN/2018/8/12/images/201880064241.jpg",
"claims" : "1.一种形成附着于基底表面的3D石墨烯材料的方法,所述方法包括:在基底的表面上提供碳源,所述碳源包括含碳材料;和将至少一部分所述碳源和/或至少一部分所述基底暴露于激光束,从而将至少一部分所述碳源转化为附着于所述基底表面的3D石墨烯材料。
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| id | string | 专利唯一ID |
| documentNumber | string | 文献号 |
| documentDate | string | 文献日 |
| applicationDate | string | 申请日 |
| applicationNumber | string | 申请号 |
| title | string | 专利名称 |
| summary | string | 摘要 |
| ipc | string | 国际分类号 |
| mainIpc | string | 主分类号 |
| loc | string | LOC分类号(外观设计才有) |
| fullPriorityNumber | string | 优先权 |
| priorityNumber | string | 优先权号 |
| applicant | string | 申请人 |
| assignee | string | 专利权人 |
| currentAssignee | string | 当前专利权人 |
| inventor | string | 发明人 |
| type | string | 专利类型 |
| agency | string | 专利代理机构 |
| agent | string | 代理人 |
| legalStatus | string | 法律状态 |
| imagePath | string | 专利摘要附图地址 |
| firstInventor | string | 第一发明人 |
| firstApplicant | string | 第一申请人 |
| pdfList | string | 专利文献全文PDF地址列表 |
| applicantAddress | string | 申请人地址 |
| pctDate | string | PCT国际申请进入国家阶段日 |
| pctApplicationData | string | PCT国际申请的申请数据 |
| pctPublicationData | string | PCT国际申请的公布数据 |
专利同族接口
| 接口URL: | /api/patent/family |
| 接口说明: |
该接口提供对专利同族的查询功能,包括简单同族和扩展同族,支持同时查和分开查。
|
| 实例: | https://www.patenthub.cn/api/patent/family?t=xx&efId=xx&&fId=yy&v=1 |
| 参数列表 | ||
|---|---|---|
| 参数 | 是否必须 | 参数说明 |
| t | 是 | token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN |
| efId | 否 | 扩展同族id,来自于接口/api/s、/api/patent/base、/api/patent/detail的extendedFamilyId字段 |
| fId | 否 | 简单同族id,来自于接口/api/s、/api/patent/base、/api/patent/detail的familyId字段 |
| v | 是 | version,版本号,当前版本号为1 |
| 响应结果 | |||
|---|---|---|---|
{
"code" : 200,
"data" : [ {
"id" : "CN101864098B",
"udn" : "CN101864098B",
"title" : "聚合物/石墨烯复合材料的原位还原制备方法",
"countryCode" : "CN",
"documentNumber" : "CN101864098B",
"documentDate" : "2012-01-04"
}, {
"id" : "CN101864098A",
"udn" : "CN101864098A",
"title" : "聚合物/石墨烯复合材料的原位还原制备方法",
"countryCode" : "CN",
"documentNumber" : "CN101864098A",
"documentDate" : "2010-10-20"
}, {
"id" : "US8807980B2",
"udn" : "US8807980B2",
"title" : "Magazine apparatus for the storage of blow moulds and methods of storing blow moulds",
"countryCode" : "US",
"documentNumber" : "US08807980B2",
"documentDate" : "2014-08-19"
}, {
"id" : "US2011052744A1",
"udn" : "US2011052744A1",
"title" : "MAGAZINE APPARATUS FOR THE STORAGE OF BLOW MOULDS AND METHODS OF STORING BLOW MOULDS",
"countryCode" : "US",
"documentNumber" : "US20110052744A1",
"documentDate" : "2011-03-03"
}, {
"id" : "US2013224323A1",
"udn" : "US2013224323A1",
"title" : "MAGAZINE APPARATUS FOR THE STORAGE OF BLOW MOULDS AND METHODS OF STORING BLOW MOULDS",
"countryCode" : "US",
"documentNumber" : "US20130224323A1",
"documentDate" : "2013-08-29"
}, {
"id" : "US8491293B2",
"udn" : "US8491293B2",
"title" : "Magazine apparatus for the storage of blow moulds and methods of storing blow moulds",
"countryCode" : "US",
"documentNumber" : "US08491293B2",
"documentDate" : "2013-07-23"
}, {
"id" : "EP2292402A3",
"udn" : "EP2292402A3",
"title" : "Magazinvorrichtung sowie Verfahren zur Aufbewahrung von Blasformen",
"countryCode" : "EP",
"documentNumber" : "EP2292402A3",
"documentDate" : "2011-10-12"
}, {
"id" : "EP3150357A1",
"udn" : "EP3150357A1",
"title" : "MAGAZINVORRICHTUNG SOWIE VERFAHREN ZUR AUFBEWAHRUNG VON BLASFORMEN",
"countryCode" : "EP",
"documentNumber" : "EP3150357A1",
"documentDate" : "2017-04-05"
}, {
"id" : "EP2292402B1",
"udn" : "EP2292402B1",
"title" : "Magazinvorrichtung sowie Verfahren zur Aufbewahrung von Blasformen",
"countryCode" : "EP",
"documentNumber" : "EP2292402B1",
"documentDate" : "2016-12-21"
}, {
"id" : "EP2292402A2",
"udn" : "EP2292402A2",
"title" : "Magazinvorrichtung sowie Verfahren zur Aufbewahrung von Blasformen",
"countryCode" : "EP",
"documentNumber" : "EP2292402A2",
"documentDate" : "2011-03-09"
} ],
"success" : true
}
|
|||
| 字段说明 | ||
|---|---|---|
| 字段 | 类型 | 含义 |
| code | int | 状态码:具体请参考,状态码 |
| success | boolean | 请求是否成功 |
| id | string | 专利唯一ID |
| udn | string | 文献号 |
| documentNumber | string | 文献号 |
| documentDate | string | 文献日 |
| countryCode | string | 国家代码 |
| title | string | 专利名称 |
错误代码
| 错误代码 | ||
|---|---|---|
| 序号 | 值 | 说明 |
| 1 | 200 | 响应成功 |
| 2 | 201 | token为空 |
| 3 | 202 | 非法token |
| 4 | 203 | 响应异常 |
| 5 | 204 | ip被拒绝访问 |
| 6 | 205 | 参数值为空 |
| 7 | 206 | 没有找到对应数据 |
| 8 | 207 | 该接口当天访问次数已经用尽 |
| 9 | 208 | 没有访问权限 |
| 10 | 209 | 版本号为空 |
| 11 | 210 | 参数错误 |
| 12 | 211 | 该等级接口当年专利总数量已经用尽 |
| 13 | 212 | 分析维度为空 |
| 14 | 213 | 分析维度不存在 |
| 15 | 214 | TOKEN类型错误 |
| 16 | 215 | 异常访问,被终止,请查看接口规范! |
| 17 | 216 | 获取年费数据异常! |
| 18 | 217 | 访问说明书附图数量超过专利总量的3倍限制 |
| 18 | 218 | 特指按年付费情况下,搜索、引用、相似接口总调用量超过了每日调用量的100倍 |