1、标库网开放接口v2.02016-12-30API列表免费版基础版精英版旗舰版尊贵版接口简介接口名称接口功能说明接口访问次数限制模糊查询search给定关键字,查询商标名/注册号/申请人中含有该关键字的商标列表30次/天200次/天1000次/天2000次/天6000次/天search申请人列表sqr-list根据给定的申请人名关键词,获得申请人列表30次/天200次/天1000次/天2000次/天6000次/天申请人商标列表sqr-tm-list给定申请人名,获得该申请人名下的全部商标列表30次/天200次/天1000次/天2000次/天6000次/天商标详情info获取指定商标的详细信
2、息200次/天4000次/天20000次/天40000次/天120000次/天状态提取data-status根据指定的商标状态,获得商标列表10次/天100次/天500次/天1000次/天2000次/天商标公告情况tm-gonggao-list给定一个商标注册号,获得它的商标公告情况100次/天2000次/天10000次/天20000次/天60000次/天近似查询similar给的一个关键词,查询有哪些商标跟他近似,目前支持中文和英文。5次/天40次/天300次/天1000次/天5000次/天备注:profile接口可以获得当前apiKey的有效期、调用权限等信息原价免费¥3500/年¥60
3、00/年¥8000/年¥24000/年推广期优惠价免费¥2000/年¥4000/年¥5000/年¥15000/年特别说明:接口调用时的翻页不计入次数。文档修改记录2015-01-25创建本文档1.0版2015-03-05更新为1.1版本(1).search接口中,增加了regIssue、regDate、agent属性。(2).info接口中,flow部分增加了code属性。2015-03-17更新为1.2版本新增search接口的变种,接口名不变。区别于原search接口的是onlySbmc和searchType参数。2015-04-09更新为1.3版本新增data-stat
4、us接口新增adv-first-trial接口info接口,将访问次数限制进行了调整,放宽为原来的两倍。2015-04-20更新为1.4版本search接口所返回的results列表中的对象新增加2个属性:announcementIssue初审公告期号announcementDate初审公告日期sqr-list接口所返回的results列表中的对象新增加1个属性validTmCount2015-08-17更新为1.5版本新增tm-gonggao-list接口、新增profile.php接口2015-10-08更新为1.6版本search接口的pageSize参数的含义升级,可为
6、ageSize必传页面大小,即一次api调用最大获取多少条记录,取值范围:1-50pageNo必传当前页码数,即本次api调用是获得结果的第几页,从1开始计数onlySbmc非必传,默认=falsetrue:只在商标名中匹配false:在商标名/注册号/申请人上匹配intCls非必传,默认=00:全部国际分类非0:限定在指定类别,类别间用分号分割。如:4;12;34表示在第4、12、34类内查询请求示例返回说明数据格式json返回对象属性ret返回码。0-成功1-失败msg如果ret=1,会有相应的错误信息提示,返回数据全部用UTF-8编码。remainCount本天内,本接口的剩余
7、允许调用次数allRecords本接口调用后,共查询出多少条记录results当前页的查询结果列表。它是列表对象,里面包含商标简单信息,具体信息格式见下面示例。facets类别及统计值数组。类别和统计值之间英文冒号分割返回示例ret:0,msg:,remainCount:354,allRecords:9860,results:regNo:5232144,/注册号intCls:9,/国际分类tmImg:121b99cebccde101,/商标图片名,需要小图(50*50),需要中图(100*100),需要大图,tmName:万龙腾飞;MONLONG,/商标名称app
8、licantCn:陈健光,/申请人中文名appDate:2006-03-22,/申请日期announcementIssue:1324,/初审公告期号announcementDate:2012-08-21,/初审公告日期regIssue:1336,/注册公告期号regDate:2012-11-21,/注册公告日期agent:无锡创名商标事务所有限公司,/代理公司currentStatus:商标已注册/当前流程状态。,facets:1:27,/类别的统计值,如1:27表示第1类有27条记录。facet数组只是数大于0的分类,统计数为0的不在数组里。10:3,11:12
11、表参数名约束/默认说明keyword必传待搜索的关键词,需要进行URL编码apiKey必传标库网分配给您的apiKeyapiPassword必传标库网分配给您的apiPasswordpageSize必传页面大小,即一次api调用最大获取多少条记录,取值范围:1-50pageNo必传当前页码数,即本次api调用是获得结果的第几页,从1开始计数pattern非必传匹配方式:0-默认,模糊匹配;1-完全相同,2-前包含请求示例返回说明数据格式json返回对象属性ret返回码。0-成功1-失败msg如果ret=1,会有相应的错误信息提示,返回数据全部用UTF-8编码。remainCount本天内,
12、本接口的剩余允许调用次数allRecords本接口调用后,共查询出多少条记录results当前页的查询结果列表。它是列表对象,里面包含申请人简单信息,具体信息格式见下面示例。返回示例ret:0,msg:,remainCount:152,allRecords:321,results:applicantCn:陈健光,/申请人中文名idCardNo:110203195624261103,/身份证号,如果是公司,没有身份证号,此属性为空串。allTmCount:2,/拥有的商标数量validTmCount:1/有效商标数。3、接口sqr-tm-list请求说明接口功能给定
14、信息提示,返回数据全部用UTF-8编码。remainCount本天内,本接口的剩余允许调用次数results当前页的查询结果列表。它是列表对象,里面包含商标简单信息,具体信息格式见下面示例。返回示例ret:0,msg:,remainCount:342,results:regNo:5232144,/注册号intCls:9,/国际分类tmImg:121b99cebccde101,/商标图片名,需要小图(50*50),需要中图(100*100),需要大图,tmName:万龙腾飞;MONLONG,/商标名称applicantCn:陈健光,/申请人中文名appDate:2
16、注册号intCls国际分类tmName商标名appDate申请日期applicantCn申请人中文idCardNo申请人身份证号。如果是公司,此属性为空串,如果是个人,一般是身份证号,也有可能空串(此种情形是因为商标局没有录入身份证号)。addressCn申请人地址中文applicantOther1共有申请人1-只要有内容,就说明此商标是共有商标applicantOther2共有申请人2-只要有内容,就说明此商标是共有商标applicantEn申请人英文addressEn申请人地址英文agent代理公司announcementIssue初审公告期号announcementDate初审公告日期r
18、中图(100*100),需要大图,regNo:9999212,/注册号intCls:11,/国际分类tmName:图形,/商标名appDate:2011-09-23,/申请日期applicantCn:宜兴市格瑞特环保设备有限公司,/申请人名称中文idCardNo:,/身份证号addressCn:江苏省宜兴市高塍镇赋村村,/申请人地址中文applicantOther1:,/共有申请人1applicantOther2:,/共有申请人2applicantEn:,/申请人名称英文addressEn:,/申请人地址英文announcementIssue:1324,/初审公告期号
19、announcementDate:2012-08-20,/初审公告日期regIssue:1336,/注册公告期号regDate:2012-11-21,/注册公告日期privateDate:2012-11-21至2022-11-20,/专用权期限agent:无锡创名商标事务所有限公司,/代理公司category:,/商标类型,一般、特殊、集体、证明hqzdrq:,/后期指定日期gjzcrq:,/国际注册日期yxqrq:,/优先权日期color:,/指定颜色goods:/使用商品goodsCode:1105,/群组号goodsName:玻璃钢冷却塔,beDeleted
21、码数,即本次api调用是获得结果的第几页,从1开始计数intCls非必传,默认=00-不限制1-第一类2-第二类。45-第四十五类statusCode必传,默认不限制【它与statusDate参数必须至少传一个】状态编码,目前共9种:xzq:续展期kzq:宽展期zcsqddbhfw:注册申请等待驳回发文zcsqddbhfs:注册申请等待驳回复审sbyysqz:商标异议申请中sbyywc:商标异议完成yyfsz:异议复审中cxzcsbfsz:撤销注册商标复审中cxlxsnwsy:撤销连续三年未使用statusDate非必传,默认不限制【它与statusCode参数必须至少传一个】商标状态日
22、期,格式为yyyymmdd,例如:20150419(注意月/日要补零)请求示例返回说明数据格式json返回对象属性ret返回码。0-成功1-失败msg如果ret=1,会有相应的错误信息提示,返回数据全部用UTF-8编码。remainCount本天内,本接口的剩余允许调用次数allRecords本接口调用后,共查询出多少条记录results当前页的查询结果列表。它是列表对象,里面包含商标简单信息,具体信息格式见下面示例。返回示例ret:0,msg:,remainCount:354,allRecords:6560,results:regNo:5232144,/注册号intCl
24、返回说明数据格式json返回对象属性ret返回码。0-成功1-失败msg如果ret=1,会有相应的错误信息提示,返回数据全部用UTF-8编码。remainCount本天内,本接口的剩余允许调用次数gonggaos本商标的公告列表。它是列表对象,里面包含公告信息,具体信息格式见下面示例。返回示例ret:0,msg:,remainCount:354,gonggaos:ggDate:2015-06-06,/公告日期ggQihao:1450,/公告期号ggName:初步审定公告”,/公告类型ggPage:35,/第几页url:5pTp0SX_ppmXE=,vcode:f1f