专利检索 · 引用反查（分组）

与引用反查同一份数据，按”谁引用了它 / 它引用了谁”分组返回，适合直接画图。

引用查询（分组）

POST /ip/patent/citation/grouped

请求参数

参数	类型	必填	说明
`patentNumbers`	`array<string>`	✅	待查询的专利号，1~50 个（超出部分将被忽略）。发明与外观专利均支持，大小写及补零写法均可识别；重复的专利号仅计一次。
`includeCited`	`boolean`	❌	是否查询「输入专利所引用的在先专利」，默认为 `true`
`includeCitedBy`	`boolean`	❌	是否查询「引用了输入专利的在后专利」，默认为 `true`
`limit`	`integer`	❌	每个方向最多返回的条数，默认为 50，最大为 200

请求示例

{
  "patentNumbers": [
    "US-11654321-B2"
  ],
  "includeCited": false,
  "includeCitedBy": false,
  "limit": 0
}

cURLPython

curl -X POST "https://api.trohub.com/v2/ip/patent/citation/grouped" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"patentNumbers":["US-11654321-B2"],"includeCited":false,"includeCitedBy":false,"limit":0}'

import requests

url = "https://api.trohub.com/v2/ip/patent/citation/grouped"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
  "patentNumbers": [
      "US-11654321-B2"
  ],
  "includeCited": false,
  "includeCitedBy": false,
  "limit": 0
}

r = requests.post(url, headers={**headers, "Content-Type": "application/json"}, json=payload)
print(r.json())

响应示例

{
  "ok": true,
  "message": "成功",
  "data": {
    "inputs": [
      "string"
    ],
    "cited": [
      {
        "pn": "string",
        "title": "2026 秋季批次 A",
        "abstract": "string",
        "kind": "string",
        "grant": 0,
        "filling": 0,
        "assignees": [
          {
            "name": "string",
            "country": "string"
          }
        ],
        "relatedInputs": [
          "string"
        ],
        "inLibrary": false,
        "imageUrls": [
          "string"
        ],
        "relations": [
          "string"
        ]
      }
    ],
    "citedBy": [
      {
        "pn": "string",
        "title": "2026 秋季批次 A",
        "abstract": "string",
        "kind": "string",
        "grant": 0,
        "filling": 0,
        "assignees": [
          {
            "name": "string",
            "country": "string"
          }
        ],
        "relatedInputs": [
          "string"
        ],
        "inLibrary": false,
        "imageUrls": [
          "string"
        ],
        "relations": [
          "string"
        ]
      }
    ],
    "notInLibrary": [
      "string"
    ],
    "truncated": false
  }
}

响应字段

参数	类型	必填	说明
`inputs`	`array<string>`	❌	规范化、去重后的输入专利号（按输入顺序）
`cited`	`array<PatentCitationHit>`	❌	输入专利所引用的在先专利
`cited[].pn`	`string`	❌	专利号（规范化后）
`cited[].title`	`string`	❌	专利标题。库内未收录的引用专利不返回该字段（此时仅有 `pn` / `kind` / `relatedInputs` / `inLibrary`）
`cited[].abstract`	`string`	❌	摘要。库内未收录的引用专利不返回该字段
`cited[].kind`	`string`	❌	—
`cited[].grant`	`integer`	❌	—
`cited[].filling`	`integer`	❌	—
`cited[].assignees`	`array<UtilityAdvancedParty>`	❌	权利人。库内未收录的引用专利不返回该字段
`cited[].assignees[].name`	`string`	❌	—
`cited[].assignees[].country`	`string`	❌	国家代码（ISO 3166-1 alpha-2）
`cited[].relatedInputs`	`array<string>`	❌	该结果关联的输入专利号。
`cited[].inLibrary`	`boolean`	❌	该专利是否已被库内收录；已收录的专利可通过 `POST /ip/patent/detail` 获取全文
`cited[].imageUrls`	`array<string>`	❌	附图地址（最多 5 张，原图不缩放）。须原样请求（`.TIF` 实际返回 PNG，改扩展名/查询串会 404）。
`cited[].relations`	`array<string>`	❌	与该结果的关系：`cited`（输入引用了它）/ `citedBy`（它引用了输入）；仅平铺版返回。
`citedBy`	`array<PatentCitationHit>`	❌	引用了输入专利的在后专利
`citedBy[].pn`	`string`	❌	专利号（规范化后）
`citedBy[].title`	`string`	❌	专利标题。库内未收录的引用专利不返回该字段（此时仅有 `pn` / `kind` / `relatedInputs` / `inLibrary`）
`citedBy[].abstract`	`string`	❌	摘要。库内未收录的引用专利不返回该字段
`citedBy[].kind`	`string`	❌	—
`citedBy[].grant`	`integer`	❌	—
`citedBy[].filling`	`integer`	❌	—
`citedBy[].assignees`	`array<UtilityAdvancedParty>`	❌	权利人。库内未收录的引用专利不返回该字段
`citedBy[].assignees[].name`	`string`	❌	—
`citedBy[].assignees[].country`	`string`	❌	国家代码（ISO 3166-1 alpha-2）
`citedBy[].relatedInputs`	`array<string>`	❌	该结果关联的输入专利号。
`citedBy[].inLibrary`	`boolean`	❌	该专利是否已被库内收录；已收录的专利可通过 `POST /ip/patent/detail` 获取全文
`citedBy[].imageUrls`	`array<string>`	❌	附图地址（最多 5 张，原图不缩放）。须原样请求（`.TIF` 实际返回 PNG，改扩展名/查询串会 404）。
`citedBy[].relations`	`array<string>`	❌	与该结果的关系：`cited`（输入引用了它）/ `citedBy`（它引用了输入）；仅平铺版返回。
`notInLibrary`	`array<string>`	❌	输入专利号中，库内未收录全文的专利号（不代表无引用结果）
`truncated`	`boolean`	❌	结果是否因 `limit` 限制而被截断

可能的错误

HTTP	错误码	说明
400	`VALIDATION_*`（见 message）	请求数据无效（HTTP 400）
401	`UNAUTHORIZED_AUTH_REQUIRED`	缺少 API Key、Key 无效或被封禁（HTTP 401），错误码 `UNAUTHORIZED_AUTH_REQUIRED`。
403	`BUSINESS_INSUFFICIENT_QUOTA`	积分不足（HTTP 403），错误码 `BUSINESS_INSUFFICIENT_QUOTA`。提交类接口在扣减积分前校验余额。
429	`BUSINESS_RATE_LIMIT_EXCEEDED` / `RATE_LIMITER_UNAVAILABLE`	请求频率或并发数超限（HTTP 429），错误码 `BUSINESS_RATE_LIMIT_EXCEEDED`。限流校验不可用时返回 503（`RATE_LIMITER_UNAVAILABLE`）。限流是动态的：额度由「你的 API 档位 × 接口所属的桶」决定，所以同一个接口对不同调用者可能是不同的数值，这里不给出固定数字。两处可以看到实际生效值： 1. 每次响应的 `X-RateLimit-` 响应头（当次生效的次数、窗口、命中哪一档额度）； 2. `GET /v2/quota/mine`（带 API Key，返回你每个额度的生效值）；另有 `GET /v2/quota/config`（公开）给出未分档的基线额度。计数口径：按账号计* —— 同一账号下的所有 API Key 共享同一份额度，多开一个 Key 不会获得额外配额。接口桶是分开计数的（例如「提交检测」与「轮询结果」是两个桶），所以轮询不会吃掉提交的额度。
500	`INTERNAL_ERROR_UNKNOWN`	服务器内部错误（HTTP 500），错误码 `INTERNAL_ERROR_UNKNOWN`