[ PROMPT_NODE_27550 ]
patentsearch_api
[ SKILL_DOCUMENTATION ]
# PatentSearch API 参考
## 概述
PatentSearch API 是 USPTO 基于 ElasticSearch 的现代专利搜索系统,于 2025 年 5 月取代了旧版 PatentsView API。它提供截至 2025 年 6 月 30 日的专利数据访问,并定期更新。
**基础 URL:** `https://search.patentsview.org/api/v1/`
## 身份验证
所有 API 请求都需要在请求头中使用 API 密钥进行身份验证:
X-Api-Key: YOUR_API_KEY
在以下地址注册 API 密钥:https://account.uspto.gov/api-manager/
## 速率限制
- 每个 API 密钥 **45 次请求/分钟**
- 超过速率限制将导致 HTTP 429 错误
## 可用端点
### 核心专利与公开端点
- **`/patent`** - 通用专利数据(已授权专利)
- **`/publication`** - 授权前公开数据
- **`/publication/rel_app_text`** - 公开的相关申请数据
### 实体端点
- **`/inventor`** - 包含位置和性别代码字段的发明人信息
- **`/assignee`** - 包含位置标识符的受让人详情
- **`/location`** - 地理数据,包括经纬度坐标
- **`/attorney`** - 法律代表信息
### 分类端点
- **`/cpc_subclass`** - 子类级别的合作专利分类 (CPC)
- **`/cpc_at_issue`** - 专利授权日的 CPC 分类
- **`/uspc`** - 美国专利分类数据
- **`/wipo`** - 世界知识产权组织分类
- **`/ipc`** - 国际专利分类
### 文本数据端点 (Beta)
- **`/brief_summary_text`** - 专利简要摘要(已授权和授权前)
- **`/claims`** - 专利权利要求文本
- **`/drawing_description_text`** - 图纸说明
- **`/detail_description_text`** - 详细说明文本
*注意:文本端点处于 Beta 阶段,数据主要来自 2023 年以后。历史数据回填正在进行中。*
### 支持端点
- **`/other_reference`** - 专利参考资料
- **`/related_document`** - 专利间的交叉引用
## 查询参数
所有端点支持四个主要参数:
### 1. 查询字符串 (`q`)
使用 JSON 查询对象过滤数据。**必需参数。**
**查询运算符:**
- **相等**: `{"field": "value"}` 或 `{"field": {"_eq": "value"}}`
- **不相等**: `{"field": {"_neq": "value"}}`
- **比较**: `_gt`, `_gte`, `_lt`, `_lte`
- **字符串匹配**:
- `_begins` - 以...开始
- `_contains` - 子字符串匹配
- **全文搜索** (推荐用于 t