API文档
开始 版本介绍
价格体系
按次数收费 按年度收费
测试脚本 开通服务 联系我们

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

搜索接口

接口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
    },
    "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 申请人地址

专利权利要求接口

接口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/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/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国家代码、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 专利年剩余量，仅按年付费接口有该数据

错误代码

错误代码
序号 值 说明
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 获取年费数据异常！