USPTO数据库API使用指南：专利商标搜索、审查历史与知识产权分析

uspto-database by davila7/claude-code-templates

158 周安装量

23,400 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/davila7/claude-code-templates --skill uspto-database

数据分析科研工具 API

🇨🇳中文介绍

USPTO 数据库

概述

USPTO 为专利和商标数据提供专门的 API。可通过关键词/发明人/受让人搜索专利，通过 PEDS 检索审查历史，跟踪转让，分析引证和审查意见，通过 TSDR 访问商标数据，用于知识产权分析和现有技术检索。

何时使用此技能

此技能应在以下情况下使用：

专利搜索：通过关键词、发明人、受让人、分类或日期查找专利
专利详情：检索完整的专利数据，包括权利要求、摘要、引证
商标搜索：通过序列号或注册号查找商标
商标状态：检查商标状态、所有权和审查历史
审查历史：从 PEDS（专利审查数据系统）访问专利审查数据
审查意见：检索审查意见文本、引证和驳回理由
转让：跟踪专利/商标所有权转移
引证：分析专利引证（前向和后向）
诉讼：访问专利诉讼记录
组合分析：分析公司或发明人的专利/商标组合

USPTO API 生态系统

USPTO 为不同的数据需求提供多个专门的 API：

核心 API

PatentSearch API - 基于 ElasticSearch 的现代专利搜索（已于 2025 年 5 月取代旧的 PatentsView）
- 通过关键词、发明人、受让人、分类、日期搜索专利
- 可访问截至 2025 年 6 月 30 日的专利数据
- 速率限制为 45 次请求/分钟
- 基础 URL：https://search.patentsview.org/api/v1/

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

任务 1：搜索专利

使用 PatentSearch API

PatentSearch API 使用带有各种操作符的 JSON 查询语言，以实现灵活的搜索。

基本专利搜索示例

按摘要中的关键词搜索：

from scripts.patent_search import PatentSearchClient

client = PatentSearchClient()

# 搜索机器学习专利
results = client.search_patents({
    "patent_abstract": {"_text_all": ["machine", "learning"]}
})

for patent in results['patents']:
    print(f"{patent['patent_number']}: {patent['patent_title']}")

按发明人搜索：

results = client.search_by_inventor("John Smith")

按受让人/公司搜索：

results = client.search_by_assignee("Google")

按日期范围搜索：

results = client.search_by_date_range("2024-01-01", "2024-12-31")

按 CPC 分类搜索：

results = client.search_by_classification("H04N")  # 视频/图像技术

使用逻辑操作符组合多个条件：

results = client.advanced_search(
    keywords=["artificial", "intelligence"],
    assignee="Microsoft",
    start_date="2023-01-01",
    end_date="2024-12-31",
    cpc_codes=["G06N", "G06F"]  # AI 和计算分类
)

对于复杂查询，直接使用 API：

import requests

url = "https://search.patentsview.org/api/v1/patent"
headers = {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

query = {
    "q": {
        "_and": [
            {"patent_date": {"_gte": "2024-01-01"}},
            {"assignee_organization": {"_text_any": ["Google", "Alphabet"]}},
            {"cpc_subclass_id": ["G06N", "H04N"]}
        ]
    },
    "f": ["patent_number", "patent_title", "patent_date", "inventor_name"],
    "s": [{"patent_date": "desc"}],
    "o": {"per_page": 100, "page": 1}
}

response = requests.post(url, headers=headers, json=query)
results = response.json()

相等：{"field": "value"} 或 {"field": {"_eq": "value"}}
比较：_gt、_gte、_lt、_lte、_neq
文本搜索：_text_all、_text_any、_text_phrase
字符串匹配：_begins、_contains
逻辑：_and、_or、_not

最佳实践：对文本字段使用 _text_* 操作符（比 _contains 或 _begins 性能更好）

可用的专利端点

/patent - 已授权专利
/publication - 预授权公开
/inventor - 发明人信息
/assignee - 受让人信息
/cpc_subclass、/cpc_at_issue - CPC 分类
/uspc - 美国专利分类
/ipc - 国际专利分类
/claims、/brief_summary_text、/detail_description_text - 文本数据（测试版）

有关完整的 PatentSearch API 文档，请参阅 references/patentsearch_api.md，包括：

所有可用端点
完整的字段参考
查询语法和示例
响应格式
速率限制和最佳实践

任务 2：检索专利审查数据

使用 PEDS（专利审查数据系统）

PEDS 提供全面的审查历史，包括交易事件、状态变更和审查时间线。

uv pip install uspto-opendata-python

获取申请数据：

from scripts.peds_client import PEDSHelper

helper = PEDSHelper()

# 按申请号
app_data = helper.get_application("16123456")
print(f"标题：{app_data['title']}")
print(f"状态：{app_data['app_status']}")

# 按专利号
patent_data = helper.get_patent("11234567")

获取交易历史：

transactions = helper.get_transaction_history("16123456")

for trans in transactions:
    print(f"{trans['date']}: {trans['code']} - {trans['description']}")

获取审查意见：

office_actions = helper.get_office_actions("16123456")

for oa in office_actions:
    if oa['code'] == 'CTNF':
        print(f"非最终驳回：{oa['date']}")
    elif oa['code'] == 'CTFR':
        print(f"最终驳回：{oa['date']}")
    elif oa['code'] == 'NOA':
        print(f"授权通知：{oa['date']}")

获取状态摘要：

summary = helper.get_status_summary("16123456")

print(f"当前状态：{summary['current_status']}")
print(f"申请日期：{summary['filing_date']}")
print(f"待审期：{summary['pendency_days']} 天")

if summary['is_patented']:
    print(f"专利号：{summary['patent_number']}")
    print(f"授权日期：{summary['issue_date']}")

分析审查模式：

analysis = helper.analyze_prosecution("16123456")

print(f"审查意见总数：{analysis['total_office_actions']}")
print(f"非最终驳回：{analysis['non_final_rejections']}")
print(f"最终驳回：{analysis['final_rejections']}")
print(f"授权：{analysis['allowance']}")
print(f"已提交答复：{analysis['responses']}")

CTNF - 非最终驳回已邮寄
CTFR - 最终驳回已邮寄
NOA - 授权通知已邮寄
WRIT - 已提交答复
ISS.FEE - 授权费支付
ABND - 申请已放弃
AOPF - 审查意见已邮寄

有关完整的 PEDS 文档，请参阅 references/peds_api.md，包括：

所有可用数据字段
交易代码参考
Python 库用法
组合分析示例

任务 3：搜索和监控商标

使用 TSDR（商标状态和文件检索）

访问商标状态、所有权和审查历史。

按序列号获取商标：

from scripts.trademark_client import TrademarkClient

client = TrademarkClient()

# 按序列号
tm_data = client.get_trademark_by_serial("87654321")

# 按注册号
tm_data = client.get_trademark_by_registration("5678901")

获取商标状态：

status = client.get_trademark_status("87654321")

print(f"商标：{status['mark_text']}")
print(f"状态：{status['status']}")
print(f"申请日期：{status['filing_date']}")

if status['is_registered']:
    print(f"注册号：{status['registration_number']}")
    print(f"注册日期：{status['registration_date']}")

检查商标健康状况：

health = client.check_trademark_health("87654321")

print(f"商标：{health['mark']}")
print(f"状态：{health['status']}")

for alert in health['alerts']:
    print(alert)

if health['needs_attention']:
    print("⚠️  此商标需要注意！")

监控多个商标：

def monitor_portfolio(serial_numbers, api_key):
    """监控商标组合健康状况。"""
    client = TrademarkClient(api_key)

    results = {
        'active': [],
        'pending': [],
        'problems': []
    }

    for sn in serial_numbers:
        health = client.check_trademark_health(sn)

        if 'REGISTERED' in health['status']:
            results['active'].append(health)
        elif 'PENDING' in health['status'] or 'PUBLISHED' in health['status']:
            results['pending'].append(health)
        elif health['needs_attention']:
            results['problems'].append(health)

    return results

REGISTERED - 有效注册商标
PENDING - 审查中
PUBLISHED FOR OPPOSITION - 异议期
ABANDONED - 申请已放弃
CANCELLED - 注册已取消
SUSPENDED - 审查已暂停
REGISTERED AND RENEWED - 注册已续展

有关完整的商标 API 文档，请参阅 references/trademark_api.md，包括：

TSDR API 参考
商标转让搜索 API
所有状态代码
审查历史访问
所有权跟踪

任务 4：跟踪转让和所有权

专利和商标转让

专利和商标都有用于跟踪所有权变更的转让搜索 API。

基础 URL：https://assignment-api.uspto.gov/patent/v1.4/

按专利号搜索：

import requests
import xml.etree.ElementTree as ET

def get_patent_assignments(patent_number, api_key):
    url = f"https://assignment-api.uspto.gov/patent/v1.4/assignment/patent/{patent_number}"
    headers = {"X-Api-Key": api_key}

    response = requests.get(url, headers=headers)
    if response.status_code == 200:
        return response.text  # 返回 XML

assignments_xml = get_patent_assignments("11234567", api_key)
root = ET.fromstring(assignments_xml)

for assignment in root.findall('.//assignment'):
    recorded_date = assignment.find('recordedDate').text
    assignor = assignment.find('.//assignor/name').text
    assignee = assignment.find('.//assignee/name').text
    conveyance = assignment.find('conveyanceText').text

    print(f"{recorded_date}: {assignor} → {assignee}")
    print(f"  类型：{conveyance}\n")

按公司名称搜索：

def find_company_patents(company_name, api_key):
    url = "https://assignment-api.uspto.gov/patent/v1.4/assignment/search"
    headers = {"X-Api-Key": api_key}
    data = {"criteria": {"assigneeName": company_name}}

    response = requests.post(url, headers=headers, json=data)
    return response.text

ASSIGNMENT OF ASSIGNORS INTEREST - 所有权转移
SECURITY AGREEMENT - 担保/担保权益
MERGER - 公司合并
CHANGE OF NAME - 名称变更
ASSIGNMENT OF PARTIAL INTEREST - 部分所有权

任务 5：访问其他 USPTO 数据

审查意见、引证和诉讼

多个专门的 API 提供额外的专利数据。

审查意见文本检索

使用申请号检索审查意见全文。与 PEDS 集成以识别存在哪些审查意见，然后检索全文。

分析专利引证：

前向引证（引用此专利的专利）
后向引证（引用的现有技术）
审查员与申请人引证
引证上下文

专利诉讼案件 API

访问联邦地区法院专利诉讼记录：

74,623+ 条诉讼记录
主张的专利
当事人和地点
案件结果

专利审判和上诉委员会程序：

多方复审（IPR）
授权后复审（PGR）
上诉决定

有关以下内容的全面文档，请参阅 references/additional_apis.md：

增强引证 API
审查意见 API（文本、引证、驳回）
专利诉讼案件 API
PTAB API
癌症登月数据集
OCE 状态/事件代码

结合多个 API 进行完整的专利情报分析：

def comprehensive_patent_analysis(patent_number, api_key):
    """
    使用多个 USPTO API 进行完整的专利分析。
    """
    from scripts.patent_search import PatentSearchClient
    from scripts.peds_client import PEDSHelper

    results = {}

    # 1. 获取专利详情
    patent_client = PatentSearchClient(api_key)
    patent_data = patent_client.get_patent(patent_number)
    results['patent'] = patent_data

    # 2. 获取审查历史
    peds = PEDSHelper()
    results['prosecution'] = peds.analyze_prosecution(patent_number)
    results['status'] = peds.get_status_summary(patent_number)

    # 3. 获取转让历史
    import requests
    assign_url = f"https://assignment-api.uspto.gov/patent/v1.4/assignment/patent/{patent_number}"
    assign_resp = requests.get(assign_url, headers={"X-Api-Key": api_key})
    results['assignments'] = assign_resp.text if assign_resp.status_code == 200 else None

    # 4. 分析结果
    print(f"\n=== 专利 {patent_number} 分析 ===\n")
    print(f"标题：{patent_data['patent_title']}")
    print(f"受让人：{', '.join(patent_data.get('assignee_organization', []))}")
    print(f"授权日期：{patent_data['patent_date']}")

    print(f"\n审查：")
    print(f"  审查意见：{results['prosecution']['total_office_actions']}")
    print(f"  驳回：{results['prosecution']['non_final_rejections']} 非最终，{results['prosecution']['final_rejections']} 最终")
    print(f"  待审期：{results['prosecution']['pendency_days']} 天")

    # 分析引证
    if 'cited_patent_number' in patent_data:
        print(f"\n引证：")
        print(f"  引用：{len(patent_data['cited_patent_number'])} 项专利")
    if 'citedby_patent_number' in patent_data:
        print(f"  被引用：{len(patent_data['citedby_patent_number'])} 项专利")

    return results

API 密钥管理
- 将 API 密钥存储在环境变量中
- 切勿将密钥提交到版本控制
- 在所有 USPTO API 中使用相同的密钥
速率限制
- PatentSearch：45 次请求/分钟
- 对速率限制错误实施指数退避
- 尽可能缓存响应
查询优化
- 对文本字段使用 _text_* 操作符（性能更好）
- 仅请求所需字段以减少响应大小
- 使用日期范围缩小搜索范围
数据处理
- 并非所有专利/商标的所有字段都已填充
- 优雅处理缺失数据
- 一致地解析日期
组合 API
- 使用 PatentSearch 进行发现
- 使用 PEDS 获取审查详情
- 使用转让 API 进行所有权跟踪
- 组合数据进行全面分析

旧版 API 停用：PatentsView 旧版 API 已于 2025 年 5 月 1 日停用 - 请使用 PatentSearch API
PAIR 批量数据已停用：请改用 PEDS
数据覆盖范围：PatentSearch 的数据截至 2025 年 6 月 30 日；PEDS 的数据从 1981 年至今
文本端点：权利要求和描述端点处于测试版，正在进行数据回填
速率限制：遵守速率限制以避免服务中断

PatentSearch API：https://search.patentsview.org/docs/
USPTO 开发者门户：https://developer.uspto.gov/
USPTO 开放数据门户：https://data.uspto.gov/
API 密钥注册：https://account.uspto.gov/api-manager/

references/patentsearch_api.md - 完整的 PatentSearch API 参考
references/peds_api.md - PEDS API 和库文档
references/trademark_api.md - 商标 API（TSDR 和转让）
references/additional_apis.md - 引证、审查意见、诉讼、PTAB

scripts/patent_search.py - PatentSearch API 客户端
scripts/peds_client.py - PEDS 审查数据客户端
scripts/trademark_client.py - 商标搜索客户端

2026 年 1 月 21 日

🇺🇸English

USPTO Database

Overview

USPTO provides specialized APIs for patent and trademark data. Search patents by keywords/inventors/assignees, retrieve examination history via PEDS, track assignments, analyze citations and office actions, access TSDR for trademarks, for IP analysis and prior art searches.

When to Use This Skill

This skill should be used when:

Patent Search : Finding patents by keywords, inventors, assignees, classifications, or dates
Patent Details : Retrieving full patent data including claims, abstracts, citations
Trademark Search : Looking up trademarks by serial or registration number
Trademark Status : Checking trademark status, ownership, and prosecution history
Examination History : Accessing patent prosecution data from PEDS (Patent Examination Data System)
Office Actions : Retrieving office action text, citations, and rejections
Assignments : Tracking patent/trademark ownership transfers
Citations : Analyzing patent citations (forward and backward)
Litigation : Accessing patent litigation records
Portfolio Analysis : Analyzing patent/trademark portfolios for companies or inventors

USPTO API Ecosystem

The USPTO provides multiple specialized APIs for different data needs:

Core APIs

PatentSearch API - Modern ElasticSearch-based patent search (replaced legacy PatentsView in May 2025)
- Search patents by keywords, inventors, assignees, classifications, dates
- Access to patent data through June 30, 2025
- 45 requests/minute rate limit
- Base URL : https://search.patentsview.org/api/v1/
PEDS (Patent Examination Data System) - Patent examination history
- Application status and transaction history from 1981-present
- Office action dates and examination events
- Use uspto-opendata-python Python library
- Replaced : PAIR Bulk Data (PBD) - decommissioned
TSDR (Trademark Status & Document Retrieval) - Trademark data
- Trademark status, ownership, prosecution history
- Search by serial or registration number
- Base URL : https://tsdrapi.uspto.gov/ts/cd/

Additional APIs

Patent Assignment Search - Ownership records and transfers
Trademark Assignment Search - Trademark ownership changes
Enriched Citation API - Patent citation analysis
Office Action Text Retrieval - Full text of office actions
Office Action Citations - Citations from office actions
Office Action Rejection - Rejection reasons and types
PTAB API - Patent Trial and Appeal Board proceedings
Patent Litigation Cases - Federal district court litigation data
Cancer Moonshot Data Set - Cancer-related patents

Quick Start

API Key Registration

All USPTO APIs require an API key. Register at: https://account.uspto.gov/api-manager/

Set the API key as an environment variable:

export USPTO_API_KEY="your_api_key_here"

Helper Scripts

This skill includes Python scripts for common operations:

scripts/patent_search.py - PatentSearch API client for searching patents
scripts/peds_client.py - PEDS client for examination history
scripts/trademark_client.py - TSDR client for trademark data

Task 1: Searching Patents

Using the PatentSearch API

The PatentSearch API uses a JSON query language with various operators for flexible searching.

Basic Patent Search Examples

Search by keywords in abstract:

from scripts.patent_search import PatentSearchClient

client = PatentSearchClient()

# Search for machine learning patents
results = client.search_patents({
    "patent_abstract": {"_text_all": ["machine", "learning"]}
})

for patent in results['patents']:
    print(f"{patent['patent_number']}: {patent['patent_title']}")

Search by inventor:

results = client.search_by_inventor("John Smith")

Search by assignee/company:

results = client.search_by_assignee("Google")

Search by date range:

results = client.search_by_date_range("2024-01-01", "2024-12-31")

Search by CPC classification:

results = client.search_by_classification("H04N")  # Video/image tech

Advanced Patent Search

Combine multiple criteria with logical operators:

results = client.advanced_search(
    keywords=["artificial", "intelligence"],
    assignee="Microsoft",
    start_date="2023-01-01",
    end_date="2024-12-31",
    cpc_codes=["G06N", "G06F"]  # AI and computing classifications
)

Direct API Usage

For complex queries, use the API directly:

import requests

url = "https://search.patentsview.org/api/v1/patent"
headers = {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

query = {
    "q": {
        "_and": [
            {"patent_date": {"_gte": "2024-01-01"}},
            {"assignee_organization": {"_text_any": ["Google", "Alphabet"]}},
            {"cpc_subclass_id": ["G06N", "H04N"]}
        ]
    },
    "f": ["patent_number", "patent_title", "patent_date", "inventor_name"],
    "s": [{"patent_date": "desc"}],
    "o": {"per_page": 100, "page": 1}
}

response = requests.post(url, headers=headers, json=query)
results = response.json()

Query Operators

Equality : {"field": "value"} or {"field": {"_eq": "value"}}
Comparison : _gt, _gte, _lt, _lte, _neq
Text search : _text_all, _text_any, _text_phrase
String matching : ,

Best Practice : Use _text_* operators for text fields (more performant than _contains or _begins)

Available Patent Endpoints

/patent - Granted patents
/publication - Pregrant publications
/inventor - Inventor information
/assignee - Assignee information
/cpc_subclass, /cpc_at_issue - CPC classifications
/uspc - US Patent Classification
/ipc - International Patent Classification
/claims, /brief_summary_text, - Text data (beta)

Reference Documentation

See references/patentsearch_api.md for complete PatentSearch API documentation including:

All available endpoints
Complete field reference
Query syntax and examples
Response formats
Rate limits and best practices

Task 2: Retrieving Patent Examination Data

Using PEDS (Patent Examination Data System)

PEDS provides comprehensive prosecution history including transaction events, status changes, and examination timeline.

Installation

uv pip install uspto-opendata-python

Basic PEDS Usage

Get application data:

from scripts.peds_client import PEDSHelper

helper = PEDSHelper()

# By application number
app_data = helper.get_application("16123456")
print(f"Title: {app_data['title']}")
print(f"Status: {app_data['app_status']}")

# By patent number
patent_data = helper.get_patent("11234567")

Get transaction history:

transactions = helper.get_transaction_history("16123456")

for trans in transactions:
    print(f"{trans['date']}: {trans['code']} - {trans['description']}")

Get office actions:

office_actions = helper.get_office_actions("16123456")

for oa in office_actions:
    if oa['code'] == 'CTNF':
        print(f"Non-final rejection: {oa['date']}")
    elif oa['code'] == 'CTFR':
        print(f"Final rejection: {oa['date']}")
    elif oa['code'] == 'NOA':
        print(f"Notice of allowance: {oa['date']}")

Get status summary:

summary = helper.get_status_summary("16123456")

print(f"Current status: {summary['current_status']}")
print(f"Filing date: {summary['filing_date']}")
print(f"Pendency: {summary['pendency_days']} days")

if summary['is_patented']:
    print(f"Patent number: {summary['patent_number']}")
    print(f"Issue date: {summary['issue_date']}")

Prosecution Analysis

Analyze prosecution patterns:

analysis = helper.analyze_prosecution("16123456")

print(f"Total office actions: {analysis['total_office_actions']}")
print(f"Non-final rejections: {analysis['non_final_rejections']}")
print(f"Final rejections: {analysis['final_rejections']}")
print(f"Allowed: {analysis['allowance']}")
print(f"Responses filed: {analysis['responses']}")

Common Transaction Codes

CTNF - Non-final rejection mailed
CTFR - Final rejection mailed
NOA - Notice of allowance mailed
WRIT - Response filed
ISS.FEE - Issue fee payment
ABND - Application abandoned
AOPF - Office action mailed

Reference Documentation

See references/peds_api.md for complete PEDS documentation including:

All available data fields
Transaction code reference
Python library usage
Portfolio analysis examples

Task 3: Searching and Monitoring Trademarks

Using TSDR (Trademark Status & Document Retrieval)

Access trademark status, ownership, and prosecution history.

Basic Trademark Usage

Get trademark by serial number:

from scripts.trademark_client import TrademarkClient

client = TrademarkClient()

# By serial number
tm_data = client.get_trademark_by_serial("87654321")

# By registration number
tm_data = client.get_trademark_by_registration("5678901")

Get trademark status:

status = client.get_trademark_status("87654321")

print(f"Mark: {status['mark_text']}")
print(f"Status: {status['status']}")
print(f"Filing date: {status['filing_date']}")

if status['is_registered']:
    print(f"Registration #: {status['registration_number']}")
    print(f"Registration date: {status['registration_date']}")

Check trademark health:

health = client.check_trademark_health("87654321")

print(f"Mark: {health['mark']}")
print(f"Status: {health['status']}")

for alert in health['alerts']:
    print(alert)

if health['needs_attention']:
    print("⚠️  This mark needs attention!")

Trademark Portfolio Monitoring

Monitor multiple trademarks:

def monitor_portfolio(serial_numbers, api_key):
    """Monitor trademark portfolio health."""
    client = TrademarkClient(api_key)

    results = {
        'active': [],
        'pending': [],
        'problems': []
    }

    for sn in serial_numbers:
        health = client.check_trademark_health(sn)

        if 'REGISTERED' in health['status']:
            results['active'].append(health)
        elif 'PENDING' in health['status'] or 'PUBLISHED' in health['status']:
            results['pending'].append(health)
        elif health['needs_attention']:
            results['problems'].append(health)

    return results

Common Trademark Statuses

REGISTERED - Active registered mark
PENDING - Under examination
PUBLISHED FOR OPPOSITION - In opposition period
ABANDONED - Application abandoned
CANCELLED - Registration cancelled
SUSPENDED - Examination suspended
REGISTERED AND RENEWED - Registration renewed

Reference Documentation

See references/trademark_api.md for complete trademark API documentation including:

TSDR API reference
Trademark Assignment Search API
All status codes
Prosecution history access
Ownership tracking

Task 4: Tracking Assignments and Ownership

Patent and Trademark Assignments

Both patents and trademarks have Assignment Search APIs for tracking ownership changes.

Patent Assignment API

Base URL : https://assignment-api.uspto.gov/patent/v1.4/

Search by patent number:

import requests
import xml.etree.ElementTree as ET

def get_patent_assignments(patent_number, api_key):
    url = f"https://assignment-api.uspto.gov/patent/v1.4/assignment/patent/{patent_number}"
    headers = {"X-Api-Key": api_key}

    response = requests.get(url, headers=headers)
    if response.status_code == 200:
        return response.text  # Returns XML

assignments_xml = get_patent_assignments("11234567", api_key)
root = ET.fromstring(assignments_xml)

for assignment in root.findall('.//assignment'):
    recorded_date = assignment.find('recordedDate').text
    assignor = assignment.find('.//assignor/name').text
    assignee = assignment.find('.//assignee/name').text
    conveyance = assignment.find('conveyanceText').text

    print(f"{recorded_date}: {assignor} → {assignee}")
    print(f"  Type: {conveyance}\n")

Search by company name:

def find_company_patents(company_name, api_key):
    url = "https://assignment-api.uspto.gov/patent/v1.4/assignment/search"
    headers = {"X-Api-Key": api_key}
    data = {"criteria": {"assigneeName": company_name}}

    response = requests.post(url, headers=headers, json=data)
    return response.text

Common Assignment Types

ASSIGNMENT OF ASSIGNORS INTEREST - Ownership transfer
SECURITY AGREEMENT - Collateral/security interest
MERGER - Corporate merger
CHANGE OF NAME - Name change
ASSIGNMENT OF PARTIAL INTEREST - Partial ownership

Task 5: Accessing Additional USPTO Data

Office Actions, Citations, and Litigation

Multiple specialized APIs provide additional patent data.

Office Action Text Retrieval

Retrieve full text of office actions using application number. Integrate with PEDS to identify which office actions exist, then retrieve full text.

Enriched Citation API

Analyze patent citations:

Forward citations (patents citing this patent)
Backward citations (prior art cited)
Examiner vs. applicant citations
Citation context

Patent Litigation Cases API

Access federal district court patent litigation records:

74,623+ litigation records
Patents asserted
Parties and venues
Case outcomes

PTAB API

Patent Trial and Appeal Board proceedings:

Inter partes review (IPR)
Post-grant review (PGR)
Appeal decisions

Reference Documentation

See references/additional_apis.md for comprehensive documentation on:

Enriched Citation API
Office Action APIs (Text, Citations, Rejections)
Patent Litigation Cases API
PTAB API
Cancer Moonshot Data Set
OCE Status/Event Codes

Complete Analysis Example

Comprehensive Patent Analysis

Combine multiple APIs for complete patent intelligence:

def comprehensive_patent_analysis(patent_number, api_key):
    """
    Full patent analysis using multiple USPTO APIs.
    """
    from scripts.patent_search import PatentSearchClient
    from scripts.peds_client import PEDSHelper

    results = {}

    # 1. Get patent details
    patent_client = PatentSearchClient(api_key)
    patent_data = patent_client.get_patent(patent_number)
    results['patent'] = patent_data

    # 2. Get examination history
    peds = PEDSHelper()
    results['prosecution'] = peds.analyze_prosecution(patent_number)
    results['status'] = peds.get_status_summary(patent_number)

    # 3. Get assignment history
    import requests
    assign_url = f"https://assignment-api.uspto.gov/patent/v1.4/assignment/patent/{patent_number}"
    assign_resp = requests.get(assign_url, headers={"X-Api-Key": api_key})
    results['assignments'] = assign_resp.text if assign_resp.status_code == 200 else None

    # 4. Analyze results
    print(f"\n=== Patent {patent_number} Analysis ===\n")
    print(f"Title: {patent_data['patent_title']}")
    print(f"Assignee: {', '.join(patent_data.get('assignee_organization', []))}")
    print(f"Issue Date: {patent_data['patent_date']}")

    print(f"\nProsecution:")
    print(f"  Office Actions: {results['prosecution']['total_office_actions']}")
    print(f"  Rejections: {results['prosecution']['non_final_rejections']} non-final, {results['prosecution']['final_rejections']} final")
    print(f"  Pendency: {results['prosecution']['pendency_days']} days")

    # Analyze citations
    if 'cited_patent_number' in patent_data:
        print(f"\nCitations:")
        print(f"  Cites: {len(patent_data['cited_patent_number'])} patents")
    if 'citedby_patent_number' in patent_data:
        print(f"  Cited by: {len(patent_data['citedby_patent_number'])} patents")

    return results

Best Practices

API Key Management
- Store API key in environment variables
- Never commit keys to version control
- Use same key across all USPTO APIs
Rate Limiting
- PatentSearch: 45 requests/minute
- Implement exponential backoff for rate limit errors
- Cache responses when possible
Query Optimization
- Use _text_* operators for text fields (more performant)
- Request only needed fields to reduce response size
- Use date ranges to narrow searches
Data Handling
- Not all fields populated for all patents/trademarks
- Handle missing data gracefully
- Parse dates consistently
Combining APIs
- Use PatentSearch for discovery
- Use PEDS for prosecution details
- Use Assignment APIs for ownership tracking
- Combine data for comprehensive analysis

Important Notes

Legacy API Sunset : PatentsView legacy API discontinued May 1, 2025 - use PatentSearch API
PAIR Bulk Data Decommissioned : Use PEDS instead
Data Coverage : PatentSearch has data through June 30, 2025; PEDS from 1981-present
Text Endpoints : Claims and description endpoints are in beta with ongoing backfilling
Rate Limits : Respect rate limits to avoid service disruptions

Resources

API Documentation

PatentSearch API : https://search.patentsview.org/docs/
USPTO Developer Portal : https://developer.uspto.gov/
USPTO Open Data Portal : https://data.uspto.gov/
API Key Registration : https://account.uspto.gov/api-manager/

Python Libraries

uspto-opendata-python : https://pypi.org/project/uspto-opendata-python/
USPTO Docs : https://docs.ip-tools.org/uspto-opendata-python/

Reference Files

references/patentsearch_api.md - Complete PatentSearch API reference
references/peds_api.md - PEDS API and library documentation
references/trademark_api.md - Trademark APIs (TSDR and Assignment)
references/additional_apis.md - Citations, Office Actions, Litigation, PTAB

Scripts

scripts/patent_search.py - PatentSearch API client
scripts/peds_client.py - PEDS examination data client
scripts/trademark_client.py - Trademark search client

Weekly Installs

158

Repository

davila7/claude-…emplates

GitHub Stars

23.4K

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

opencode131

claude-code131

gemini-cli124

cursor123

codex114

github-copilot109

DOCX文件创建、编辑与分析完整指南 - 使用docx-js、Pandoc和Python脚本

48,500 周安装

Logical : _and, _or, _not

/detail_description_text

USPTO数据库API使用指南：专利商标搜索、审查历史与知识产权分析

🇨🇳中文介绍

USPTO 数据库

概述

何时使用此技能

USPTO API 生态系统

核心 API

相关 Skills

附加 API

快速开始

API 密钥注册

辅助脚本

任务 1：搜索专利

使用 PatentSearch API

基本专利搜索示例

高级专利搜索

直接使用 API

查询操作符

可用的专利端点

参考文档

任务 2：检索专利审查数据

使用 PEDS（专利审查数据系统）

安装

基本 PEDS 用法

审查分析

常见交易代码

参考文档

任务 3：搜索和监控商标

使用 TSDR（商标状态和文件检索）

基本商标用法

商标组合监控

常见商标状态

参考文档

任务 4：跟踪转让和所有权

专利和商标转让

专利转让 API

常见转让类型

任务 5：访问其他 USPTO 数据

审查意见、引证和诉讼

审查意见文本检索

增强引证 API

专利诉讼案件 API

PTAB API

参考文档

完整分析示例

综合专利分析

最佳实践

重要说明

资源

API 文档

Python 库

参考文件

脚本

🇺🇸English

USPTO Database

Overview

When to Use This Skill

USPTO API Ecosystem

Core APIs

Additional APIs

Quick Start

API Key Registration

Helper Scripts

Task 1: Searching Patents

Using the PatentSearch API

Basic Patent Search Examples

Advanced Patent Search

Direct API Usage

Query Operators

Available Patent Endpoints

Reference Documentation

Task 2: Retrieving Patent Examination Data

Using PEDS (Patent Examination Data System)

Installation

Basic PEDS Usage

Prosecution Analysis

Common Transaction Codes

Reference Documentation

Task 3: Searching and Monitoring Trademarks

Using TSDR (Trademark Status & Document Retrieval)