外观专利 TRO API - 全球外观专利检索与诉讼风险排查接口

接口说明

外观专利 TRO API提供全球外观专利数据检索，辅助新品立项与合规排查，并支持深度关联获取对应的美国专利诉讼案件详情。
本接口支持通过产品说明关键词、外观设计分类、权利人等维度查询专利基础信息，并通过关联查询控制参数 enable_litigation，支持两种业务场景的一键切换：

专利查新模式（默认）： 仅检索全球外观设计专利的注册、确权与存续状态。
智能联动风控模式（enable_litigation=true）： 自动执行链式查询。系统首先通过外观专利库锁定存在侵权风险的专利，若存在匹配资产，则自动以其专利号深度穿透检索其在美国的相关诉讼档案，一键结构化输出匹配的诉讼案件及完整的诉讼事件时间线日志（Docket Timeline）。

核心亮点： 彻底将外观专利与司法诉讼的数据连通逻辑封装在底层。用户无需理解和对接多个不同的司法数据库，仅需一次 API 调用，即可实现”从风险专利到关联诉讼”的端到端全链路数据闭环。

🤖 支持 MCP 协议，可供 AI Agent 进行自动化跨境电商合规与侵权风险预警。 相比于自行解析原始 API，接入 MCP 服务可以让 AI Agent（如 Claude Desktop）原生、无缝地调用 Amazon、SERP 和外观专利数据。

请求URL

POST https://scrapeapi.pangolinfo.com/api/v3/wipo

请求头

参数名	参数值	类型	说明
Content-Type	application/json	string	数据格式
Authorization	Bearer xxx	string	认证凭证

请求参数

参数	必填	类型	说明
irn	Yes	string	国际注册号
ds	Yes	string	指定国家
source	Yes	string	数据来源
ed	No	string	过期日期
from	No	int	分页起始位置
hol	No	string	权利人
id	No	string	唯一标识符
id_search	No	string	ID 变体
lcs	No	string	外观设计分类（洛迦诺分类号 LCS，如 `30-01`）
prod	No	string	产品说明关键词
rd	No	string	注册日期
num	No	int	每页数量
status	No	string	法律状态
enable_litigation	No	boolean	是否开启智能联动风控模式，默认 `false`。为 `true` 时：命中专利后用专利号(IRN)查关联的美国诉讼案件，案件 join 进每条专利的 `cases` 字段（计费见下方说明）

响应值

顶层

返回值	类型	说明
total	int	总匹配专利数
hits	array	专利结果列表，元素结构见下

hits[] — 专利对象（WIPO 字段）

字段	类型	说明
ID	string	专利唯一标识（`{SOURCE}.{编号}`，如 `USID.D1000009`）
IRN	string	国际注册号 / 专利号（如 `D1000009`）
SOURCE	string	数据来源国家代码（USID / CNID / JPID / EMID / HAGUE 等）
STATUS	string	法律状态：`ACT` 已启用 / `PEND` 待生效 / `DEL` 已停用（部分源可能为空）
RD	string	注册日期（ISO 8601，如 `2023-09-26T23:59:59Z`）
HOL	array<string>	权利人 / 持有人名称列表
PROD	array<string>	产品 / 外观设计说明（指示产品）
PROD_EN / PROD_ZH	array<string>	产品说明本地化版本（英文源为 PROD_EN，CNID 为 PROD_ZH）
LCS	array<string>	外观设计分类（洛迦诺分类号 Locarno Classification，如 `30-01`）
DS	array<string>	指定国家列表
DC	int	外观设计数量
DOC	string	源数据文件路径
IMG	array<string>	图片相对路径列表
IMG_DATA	array<object>	图片对象列表，每项含 `filename`（文件名）、`url`（可访问的完整图片地址）
DETAIL_URL	string	WIPO 官方详情页链接
DETAIL_DATA	object	结构化详情，`structured` 子对象含 `name_and_address_of_the_holders`、`indication_of_products`、`class_and_subclass_of_the_locarno_classification`、`date_of_the_national_registration`、`national_registration_number`、`designer` 等明细字段（不同源字段略有差异）
以下字段仅当请求参数 `enable_litigation=true` 时返回：
litigationStatus	string	诉讼查询状态：`success` 已成功查询 / `skipped` 未提取到专利号未查 / `failed` 诉讼查询失败
caseTotal	int	该专利关联的诉讼案件数（0 表示查过但无关联案件）
cases	array	该专利关联的美国诉讼案件列表，元素结构见下

cases[] — 诉讼案件对象（仅 enable_litigation=true）

字段	类型	说明
docketId	long	案件内部唯一 ID
docketNumber	string	法院案件号（如 `2:24-cv-00058`）
caseId	string	诉讼系统案件 ID
caseName	string	案件名称（如 `LunaMarie LLC v. Remy and Roo LLC`）
court	string	受理法院名称
courtId	string	法院代码（如 `azd`）
assignedTo	string	主审法官
suitNature	string	案由 / 诉讼性质（如 `830 Property Rights: Patent`）
jurisdiction	string	管辖类型（如 `Federal Question`）
status	string	案件状态（如 `terminated` 已结案）
dateFiled	string	立案日期
dateTerminated	string	结案日期（未结案为空）
parties	array<string>	当事人（原告 / 被告）列表
patentNumbers	array<string>	案件涉及的专利号列表
entryTotal	int	该案件 docket 流水总条数
entries	array	docket 流水时间线（默认最多 50 条），元素结构见下

cases[].entries[] — 案件流水对象

字段	类型	说明
documentNumber	string	文档编号
dateFiled	string	该条流水的提交日期
description	string	流水 / 文档描述
documentHref	string	文档详情链接
pdfUrl	string	PDF 下载地址
patentNumbers	array<string>	该流水关联的专利号
extraDocument	array	附件文档列表

请求示例

curl https://scrapeapi.pangolinfo.com/api/v3/wipo \
  --request POST \
  --header 'Authorization: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "irn": "000298",
  "ds": "AL",
  "source": "AL",
  "from": 0,
  "num": 10,
  "status": "ACT",
  "ed": "",
  "hol": "",
  "id": "",
  "id_search": "",
  "lcs": "",
  "prod": "",
  "rd": ""
}'

返回示例

{
  "hits":[{"workerId":"worker_upload","IMG":["00/01/ALI2021000001-0001.1-th.jpg","00/01/ALI2021000001-0001.10-th.jpg","00/01/ALI2021000001-0001.11-th.jpg","00/01/ALI2021000001-0001.12-th.jpg","00/01/ALI2021000001-0001.13-th.jpg","00/01/ALI2021000001-0001.14-th.jpg","00/01/ALI2021000001-0001.15-th.jpg","00/01/ALI2021000001-0001.16-th.jpg","00/01/ALI2021000001-0001.17-th.jpg","00/01/ALI2021000001-0001.18-th.jpg","00/01/ALI2021000001-0001.19-th.jpg","00/01/ALI2021000001-0001.2-th.jpg","00/01/ALI2021000001-0001.20-th.jpg","00/01/ALI2021000001-0001.21-th.jpg","00/01/ALI2021000001-0001.3-th.jpg","00/01/ALI2021000001-0001.4-th.jpg","00/01/ALI2021000001-0001.5-th.jpg","00/01/ALI2021000001-0001.6-th.jpg","00/01/ALI2021000001-0001.7-th.jpg","00/01/ALI2021000001-0001.8-th.jpg","00/01/ALI2021000001-0001.9-th.jpg"],"IRN":"000298","HOL":["W-A PROGETTAZIONI S.R.L."],"DETAIL_DATA":{"structured":{"indication_of_products":"1. Pajisje p&euml;r shp&euml;rndarjen e l&euml;ngut 2. Pajisje p&euml;r shp&euml;rndarjen e l&euml;ngut 3. Pajisje p&euml;r shp&euml;rndarjen e l&euml;ngut","data_relating_to_priority_claim_under_the_paris_convention":"EM - 2020-07-31008061386-0001/0003","class_and_subclass_of_the_locarno_classification":"23-01 : Fluid distribution equipment","filing_date_of_the_application":"2021-01-11","date_of_the_national_registration":"2022-01-24","application_number":"AL/I/2021/000001","national_registration_number":"000298","expected_expiration_date_of_the_registrationrenewal":"2026-01-11"}},"version":"2.0","DS":["AL"],"WORKER_ID":"unknown","RD":"2022-01-24T23:59:59Z","STATUS":"ACT","PROD":["1. Pajisje për shpërndarjen e lëngut 2. Pajisje për shpërndarjen e lëngut 3. Pajisje për shpërndarjen e lëngut"],"crawledAt":"2026-04-11T17:12:52.155Z","SOURCE":"ALID","DOC":"00/01/ALI2021000001_20220412.1919.xml.gz","DETAIL_URL":"https://designdb.wipo.int/designdb/jsp/getData.jsp?qi=1-Cf9ymbDC5WPxMCqiQ9p09ZoiYoEck02x8vDZ30OnPHw=&SOURCE=ALID&LANG=en&XML=00/01/ALI2021000001_20220412.1919.xml.gz&KEY=//2021/000001&NO=1&TOT=17442479","PROCESSED_AT":"2026-04-11T17:12:48.889Z","ID":"ALID.AL/I/2021/000001","LCS":["23-01"],"IMG_DATA":[{"filename":"ALI2021000001-0001.1-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.1-th.jpg"},{"filename":"ALI2021000001-0001.10-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.10-th.jpg"},{"filename":"ALI2021000001-0001.11-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.11-th.jpg"},{"filename":"ALI2021000001-0001.12-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.12-th.jpg"},{"filename":"ALI2021000001-0001.13-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.13-th.jpg"},{"filename":"ALI2021000001-0001.14-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.14-th.jpg"},{"filename":"ALI2021000001-0001.15-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.15-th.jpg"},{"filename":"ALI2021000001-0001.16-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.16-th.jpg"},{"filename":"ALI2021000001-0001.17-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.17-th.jpg"},{"filename":"ALI2021000001-0001.18-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.18-th.jpg"},{"filename":"ALI2021000001-0001.19-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.19-th.jpg"},{"filename":"ALI2021000001-0001.2-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.2-th.jpg"},{"filename":"ALI2021000001-0001.20-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.20-th.jpg"},{"filename":"ALI2021000001-0001.21-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.21-th.jpg"},{"filename":"ALI2021000001-0001.3-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.3-th.jpg"},{"filename":"ALI2021000001-0001.4-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.4-th.jpg"},{"filename":"ALI2021000001-0001.5-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.5-th.jpg"},{"filename":"ALI2021000001-0001.6-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.6-th.jpg"},{"filename":"ALI2021000001-0001.7-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.7-th.jpg"},{"filename":"ALI2021000001-0001.8-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.8-th.jpg"},{"filename":"ALI2021000001-0001.9-th.jpg","url":"https://scrapeapi.pangolinfo.com/wipo/img/ALID/AL/I/2021/000001/images/ALI2021000001-0001.9-th.jpg"}],"DC":1,"ED":"2026-01-11"}],
  "total":1
}

智能联动风控模式（enable_litigation=true）

开启 enable_litigation 后，命中专利会用专利号(IRN)继续查关联的美国诉讼案件，案件 join 进每条专利的 cases 字段。请求示例：

curl https://scrapeapi.pangolinfo.com/api/v3/wipo \
  --request POST \
  --header 'Authorization: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "source": "USID",
  "id": "USID.D1000009",
  "enable_litigation": true
}'

返回结构：命中专利的 hit 保留全部专利字段（IRN、HOL、PROD、LCS、DETAIL_DATA、IMG_DATA、SOURCE、RD、STATUS 等，同上方「返回示例」），并在此基础上额外追加 litigationStatus、caseTotal、cases 三个字段：

{
  "total": 1,
  "hits": [{
    "ID": "USID.D1000009",
    "IRN": "D1000009",
    "SOURCE": "USID",
    "HOL": ["..."],
    "PROD": ["..."],
    "LCS": ["..."],
    "RD": "...",
    "STATUS": "...",
    "DETAIL_DATA": { "structured": { "...": "..." } },
    "IMG_DATA": [{ "filename": "...", "url": "..." }],
    "// 以上为原有专利字段(完整保留)": "",
    "// 以下为 enable_litigation=true 追加的诉讼字段": "",
    "litigationStatus": "success",
    "caseTotal": 1,
    "cases": [{
      "docketId": 68150298,
      "docketNumber": "2:24-cv-00058",
      "caseId": "1358743",
      "caseName": "LunaMarie LLC v. Remy and Roo LLC",
      "court": "District Court, D. Arizona",
      "courtId": "azd",
      "assignedTo": "Eileen S. Willett",
      "suitNature": "830 Property Rights: Patent",
      "jurisdiction": "Federal Question",
      "status": "terminated",
      "dateFiled": "2024-01-09T16:00:00.000+00:00",
      "dateTerminated": "2024-04-22T16:00:00.000+00:00",
      "parties": ["Remy and Roo LLC", "LunaMarie LLC"],
      "patentNumbers": ["D1000009"],
      "entryTotal": 17,
      "entries": [ "...docket 流水时间线..." ]
    }]
  }]
}

积点消耗说明

平均响应时间：5s
积点消耗：
- 专利查新模式：2 点/次（仅检索全球外观专利）
- 智能联动风控模式（enable_litigation=true）：
  - 成功穿透检索诉讼：14 点/次（无论最终是否有关联案件）
  - 未查到专利不执行穿透：2 点/次

翻页计费规则：本接口按页独立计费，每次翻页请求均视作全新查询。如开启联动风控模式，每翻一页累计扣除 14 点，请按需调用。

快速入门

Amazon Scrape API

AI SERP API

Amazon 利基数据

TRO Data API

Playground

Design Patent TRO API

接口说明

请求URL

请求头

请求参数

响应值

顶层

hits[] — 专利对象（WIPO 字段）

cases[] — 诉讼案件对象（仅 enable_litigation=true）

cases[].entries[] — 案件流水对象

请求示例

返回示例

智能联动风控模式（enable_litigation=true）

积点消耗说明

快速入门

Amazon Scrape API

AI SERP API

Amazon 利基数据

TRO Data API

Playground

​接口说明

​请求URL

​请求头

​请求参数

​响应值

​顶层

​hits[] — 专利对象（WIPO 字段）

​cases[] — 诉讼案件对象（仅 enable_litigation=true）

​cases[].entries[] — 案件流水对象

​请求示例

​返回示例

​智能联动风控模式（enable_litigation=true）

​积点消耗说明

接口说明

请求URL

请求头

请求参数

响应值

顶层

hits[] — 专利对象（WIPO 字段）

cases[] — 诉讼案件对象（仅 enable_litigation=true）

cases[].entries[] — 案件流水对象

请求示例

返回示例

智能联动风控模式（enable_litigation=true）

积点消耗说明