开发文档
介绍所有接口的输入和输出,商务技术QQ:2157717237

搜索接口

接口URL: /api/s
接口说明: 该接口提供对专利的检索功能,用户输入想要查找的关键词或者符合语法规范的短语即可对专利数据进行检索。
实例: 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页;系统将根据用户输入的页码返回该页的数据
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
接口说明: 该接口提供对单个专利的基本信息的查询功能。
实例: 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": "株式会社朝日光学,奥普梯玛公司",
        "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
    },
    "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 专利权人
inventor string 发明人
type string 专利类型
agency string 专利代理机构
agent string 代理人
legalStatus string 法律状态
imagePath string 专利附图地址
claims string 权利要求
firstInventor string 第一发明人
firstApplicant string 第一申请人
pdfList string 专利文献全文PDF地址列表

专利权利要求接口

接口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
接口说明: 该接口提供对单个专利的法律信息的查询功能。
实例: 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/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/cr/s
接口说明: 该接口提供对软件著作权的检索功能,用户输入想要查找的关键词或者符合语法规范的短语即可对软件著作权数据进行检索。
实例: https://www.patenthub.cn/api/cr/s?c=x&t=xx&q=xx&v=1
参数列表
参数 是否必须 参数说明
t token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN
q 用户输入的查询条件
c 查询字段设置,默认值name; number:登记号,name:软件著作权全称,owner:拥有者
p page页码,默认值1,最大页码为100页;系统将根据用户输入的页码返回该页的数据
ps pageSize,每页展现数据的条数,默认10条,单页最大50条;系统将根据用户指定的每页显示条数返回搜索数据
v version,版本号,当前版本号为1
响应结果
{
  "took" : 0.023,
  "total" : 1,
  "code" : 200,
  "success" : true,
  "nextPage" : -1,
  "crList" : [ {
    "number" : "2016SR318244",
    "category" : "30200-0000",
    "name" : "鼎华科技档案扫描管理系统软件",
    "version" : "V1.0",
    "owner" : "广东鼎华科技有限公司",
    "nationality" : "中国",
    "recordDate" : "2016/11/3",
    "postDate" : "未发表"
  } ],
  "totalPages" : 1,
  "page" : 1
}
                                
字段说明
字段 类型 含义
took double 请求耗时
code int 状态码:具体请参考,状态码
total int 总条数
success boolean 请求是否成功
nextPage int 下一页
totalPages int 总页数
page int 当前页
crList list 著作权列表
number string 登记号
name string 软件著作权名称
category string 分类号
shortName string 简称
owner string 著作权人
nationality string 国籍
version string 版本号
recordDate string 登记日期
postDate string 发表日期

作品著作权搜索接口

接口URL: /api/works/s
接口说明: 该接口提供对作品著作权的检索功能,用户输入想要查找的关键词或者符合语法规范的短语即可对作品著作权数据进行检索。
实例: https://www.patenthub.cn/api/works/s?c=x&t=xx&q=xx&v=1
参数列表
参数 是否必须 参数说明
t token,用户身份识别的重要依据,所有申请集成API的用户将获得对应TOKEN,申请TOKEN
q 用户输入的查询条件
c 查询字段设置,默认值name; number:登记号,name:作品著作权全称,owner:拥有者,author:作者
p page页码,默认值1,最大页码为100页;系统将根据用户输入的页码返回该页的数据
ps pageSize,每页展现数据的条数,默认10条,单页最大50条;系统将根据用户指定的每页显示条数返回搜索数据
v version,版本号,当前版本号为1
响应结果
{
  "took" : 0.041,
  "total" : 2,
  "code" : 200,
  "success" : true,
  "nextPage" : -1,
  "worksList" : [ {
    "number" : "国作登字-2016-F-00339341",
    "name" : "棒女郎bongirs",
    "category" : "美术",
    "author" : "黄子珊",
    "owner" : "黄子珊",
    "date" : "2013-03-22"
  }, {
    "number" : "国作登字-2016-F-00339342",
    "name" : "女神bongirs",
    "category" : "美术",
    "author" : "黄子珊",
    "owner" : "黄子珊",
    "date" : "2013-03-22"
  } ],
  "totalPages" : 1,
  "page" : 1
}
                                
字段说明
字段 类型 含义
took double 请求耗时
code int 状态码:具体请参考,状态码
total int 总条数
success boolean 请求是否成功
nextPage int 下一页
totalPages int 总页数
page int 当前页
worksList list 著作权列表
number string 登记号
name string 作品名称
category string 作品类别
author string 作者
owner string 著作权人
date string 登记日期

商标搜索接口

接口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/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 用户输入的查询条件
c 专利分析维度,目前支持countryCode国家代码、legalStatus专利有效性、applicationYear申请日、documentYear公开公告日、applicant申请人、inventor发明人、ipc、ipc1大类、ipc2小类、ipc3大组、ipc4小组、loc、province中国省市、city中国市区 等维度。
响应结果
{
  "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 专利年剩余量,仅按年付费接口有该数据

错误代码

错误代码
序号 说明
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类型错误