[P039]战略指标
可以通过输入patent_id或patent_number查询具体某条专利专利价值中战略价值维度的详细计算内容。包含：原始申请人数量、当前权利人数量、当前权利人公司类型占比、申请人公司市场覆盖等，详细字段可以在接口返回字段中查看。
专利id和公开号两个参数必须要有一个，如果两个都存在，会优先使用专利id。
该接口支持批量请求，上限为100条，请求参数相互之间用英文,隔开。批量请求在进行流量/费用扣减的时候，会根据返回结果的成功条数进行多次扣减。
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| string | c3efa1e6-a2c3-4502-b5e7-97fcf570cfd3 | 专利id |
| string | US5012236A | 公开公告号 |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
data | array | - | 响应数据 |
pn | string | US11205304B2 | 公开(公告)号 |
patent_id | string | 718ead9c-4f3c-4674-8f5a-24e126827269 | 专利Id |
patsnap_strategic_value | object | Please check the form: StrategicValue | 战略指标 |
pledge_no | integer<int32> | 4 | 专利质押数量 |
license_no | integer<int32> | 1 | 专利许可数量 |
inventor_no | integer<int32> | 5 | 发明人数量 |
transfer_no | integer<int32> | 2 | 专利转让数量 |
market_share | number<double> | 2.05 | 申请人市场占比 |
market_sales_usd | number<double> | 3874.66 | 申请人公司市场覆盖销售额（美元） |
market_competition | number<double> | 85849.5 | 申请人公司市场竞争力 |
current_assignee_no | number<double> | 1 | 当前权利人数量 |
original_applicant_no | number<double> | 2 | 原始申请人数量 |
current_company_assignee_ratio | number<double> | 1 | 当前权利人占比（公司类型） |
status必填 | boolean | false | 状态 |
error_msg | string | The request parameter format is incorrect！ | 错误信息 |
error_code必填 | integer | 0 | 错误代码 |
成功响应示例
成功调用 API 的响应示例
JSON
{
"data": [
{
"pn": "US11205304B2",
"patent_id": "718ead9c-4f3c-4674-8f5a-24e126827269",
"patsnap_strategic_value": {
"pledge_no": 4,
"license_no": 1,
"inventor_no": 5,
"transfer_no": 2,
"market_share": 2.05,
"market_sales_usd": 3874.66,
"market_competition": 85849.5,
"current_assignee_no": 1,
"original_applicant_no": 2,
"current_company_assignee_ratio": 1
}
}
],
"status": true,
"error_code": 0
}错误码
此接口可能返回的错误码列表
业务错误码
| 错误码 | 描述 |
|---|---|
68300004 | 请求参数异常! |
68300005 | 查询Api失败! |
68300006 | 解析基本存取错误! |
68300007 | 存在错误的请求! |
68300008 | 服务中断异常，请稍后再试! |
68300010 | 文件不符合上传规范! |
平台错误码
| 错误码 | 描述 |
|---|---|
67200001 | API整体限流错误! |
67200002 | 用户调用请求限流限制错误! |
67200003 | 申请token的key和secret不正确或者状态错误! |
67200004 | 无权限或该接口的套餐已超过系统设置的上限! |
67200005 | 账户余额不足，调用失败! |
67200006 | 客户端已过期，调用失败! |
HTTP 状态码
| 状态码 | 描述 |
|---|---|
0 | 请求成功 |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
性能指标
此接口的预期性能特征
正常响应时间
5000 ms
最大响应时间
10000 ms