[A001]专利趋势分析（检索式检索）
输入检索式，分析检索式覆盖专利的申请趋势。结果包含以申请年为单位的专利申请量，和该年申请的专利中最终授权的专利量&占比。最多返回近20年的申请授权数据。
注意：输入检索式的最大长度为800字符，且不可包含 $W $PRE $WS $SEN $PARA $FREQ 等复杂通配符。
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| string | LATEST | 选择专利去重的排序规则，仅当collapse_by等于APD或PBD时有效，collapse_order的有效值为OLDEST或LATEST |
必填 | string | TACD_ALL:(virtual reality) | 输入Analytics检索式，最大长度为800字符，且不可包含 $W $PRE $WS $SEN $PARA $FREQ 等复杂通配符。 |
| string | ALL | 选择专利去重条件，如：ALL不去重、APNO按申请号去重、DOCDB按简单同族去重、INPADOC按inpadoc同族去重，以及EXTEND按patsnap同族去重，空值默认为ALL |
| string | PBD | 选择专利去重的排序字段，如：APD按申请日排序、PBD按公开日排序、AUTHORITY按受理局排序，以及SCORE按照查询相关性排序 |
| array | [
"CN",
"US",
"EP",
"JP",
"KR"
] | 设置专利去重的排序规则，仅当collapse_by等于AUTHORITY时有效，按照输入的受理局优先级保留对应专利 |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
data | array | - | 响应数据 |
year | string | 2019 | 申请年 |
granted | integer<int32> | 20 | 授权数量 |
percentage | number<double> | 0.1667 | 授权占申请比 |
application | integer<int32> | 100 | 申请数量 |
status必填 | boolean | false | 状态 |
error_msg | string | The request parameter format is incorrect！ | 错误信息 |
error_code必填 | integer | 0 | 错误代码 |
成功响应示例
成功调用 API 的响应示例
JSON
{
"data": [
{
"year": 2019,
"granted": 20,
"percentage": 0.1667,
"application": 100
}
],
"status": true,
"error_code": 0
}错误码
此接口可能返回的错误码列表
业务错误码
| 错误码 | 描述 |
|---|---|
68300004 | 请求参数异常! |
68300005 | 查询Api失败! |
68300006 | 解析基本存取错误! |
68300007 | 存在错误的请求! |
68300008 | 服务中断异常，请稍后再试! |
68300010 | 文件不符合上传规范! |
平台错误码
| 错误码 | 描述 |
|---|---|
67200001 | API整体限流错误! |
67200002 | 用户调用请求限流限制错误! |
67200003 | 申请token的key和secret不正确或者状态错误! |
67200004 | 无权限或该接口的套餐已超过系统设置的上限! |
67200005 | 账户余额不足，调用失败! |
67200006 | 客户端已过期，调用失败! |
67200007 | 超过调用额度，调用失败! |
HTTP 状态码
| 状态码 | 描述 |
|---|---|
0 | 请求成功 |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
性能指标
此接口的预期性能特征
正常响应时间
5000 ms
最大响应时间
10000 ms