alterlab-uspto

USPTO データベース

概要

特許および商標に関する USPTO データです。特許・出願の書誌情報検索、審査（プロセキューション）履歴、継続性、譲渡、オフィスアクション、PTAB の手続き、商標のステータス（TSDR）を提供し、知的財産の分析や先行技術調査に活用できます。現在、特許関連 API のほとんどは USPTO Open Data Portal（ODP）（https://api.uspto.gov）で提供されています。旧サービスの一部は 2025～2026 年に廃止されたため、古いコードを再利用する前に以下のステータス表を確認してください。

このスキルを使用する場面

• 特許・出願の検索：タイトルのキーワード、出願人、発明者、日付、ステータスで検索
• 審査履歴：取引、オフィスアクション、特許査定・放棄、係属期間
• 継続性と所有権：親・子出願、記録された譲渡
• オフィスアクション：本文、引用文献、拒絶理由の種類（101／102／103／112）
• PTAB：IPR／PGR の審判、審判およびインターフェアレンスの決定
• 商標：TSDR によるステータス、所有者、商品・サービス、審査履歴
• ポートフォリオ分析：企業または発明者の特許や商標

該当しない場面

シナリオ	代わりに使用
学術文献（特許以外の先行技術）、被引用数	alterlab-openalex
生物医学文献の検索	alterlab-pubmed
FDA による医薬品・医療機器の承認、ラベル、510(k)／PMA	alterlab-fda
SEC EDGAR による企業の届出書類や財務情報	alterlab-edgartools
市場規模の推定／競合状況のレポート	alterlab-market-research

USPTO API のステータス（2026-09-23 に確認済み）

必要な情報	現在のサービス	認証	ステータス
書誌情報の検索、ステータス、取引履歴、継続出願、譲渡、書類（2001-01-01 以降に出願された出願、毎日更新）	ODP Patent File Wrapper：https://api.uspto.gov/api/v1/patent/applications/search（GET q= または POST JSON）および /{applicationNumberText} と /meta-data、/transactions、/continuity、/assignment、/documents、/adjustment、/attorney、/foreign-priority、/associated-documents	X-API-KEY（ODP キー）	稼働中 — PEDS に代わるサービス
オフィスアクション：テキスト、引用、拒絶理由、拡充された引用情報	ODP POST https://api.uspto.gov/api/v1/patent/oa/{oa_actions/v1, oa_citations/v2, oa_rejections/v2, enriched_cited_reference_metadata/v3}/records（フォームフィールドは criteria［Lucene］、start、rows）	ODP キー	2026 年初頭から ODP ホストで稼働中
PTAB の審判、審判の決定・書類、審判請求、インターフェアレンス	ODP /api/v1/patent/trials/proceedings/search、/trials/decisions/search、/trials/documents/search、/appeals/decisions/search、/interferences/decisions/search	ODP キー	稼働中
申立てに関する決定	ODP /api/v1/petition/decisions/search	ODP キー	稼働中
バルクデータ（特許付与／公開前の XML 全文、PatentsView テーブル、オフィスアクションの週次アーカイブなど）	ODP /api/v1/datasets/products/search、/api/v1/datasets/products/{productIdentifier}	ODP キー	稼働中
商標のステータスと書類	TSDR https://tsdrapi.uspto.gov/ts/cd/casestatus/sn{serial}/info（XML。info.json も提供）	USPTO-API-KEY ヘッダー（TSDR キー）	稼働中。キーごとに 60 リクエスト／分、PDF／ZIP は 4 リクエスト／分
発明者／譲受人を名寄せした全文特許検索	PatentsView PatentSearch API（search.patentsview.org）	—	オフライン：PatentsView が 2026-03-20 に ODP に移行した際に一時停止。ホスト名は名前解決できず、再開予定日は未発表。以前の PatentsView キーは ODP では使用不可
審査履歴	PEDS（ped.uspto.gov）、uspto-opendata-python の PEDS クライアント	—	2025-03-14 に廃止（ホスト消失）— Patent File Wrapper を使用してください
特許／商標の譲渡検索	assignment-api.uspto.gov	—	消失（ホスト名は名前解決できず）— /{app}/assignment または譲渡のバルクデータを使用してください
旧 DSAPI エンドポイント（developer.uspto.gov/ds-api/...）	—	—	廃止 — ホストは data.uspto.gov にリダイレクトします

その結果、現在、譲受人を名寄せした全文のクレーム／要約検索を行える公開 API はありません。対象の発見には ODP の書誌情報検索を、全文には ODP の特許付与／公開特許公報 XML（または ODP 上の PatentsView バルクテーブル）を使用してください。また、ユーザーから PatentsView 形式のクエリを求められた場合は、その旨を伝えてください。

クイックスタート

API キー

• ODP キー（Patent File Wrapper、オフィスアクション、PTAB、申立て、バルクデータ）： USPTO.gov アカウントで https://data.uspto.gov にサインインし（2026-06-18 以降、ODP では必須）、APIs → Getting Started からキーをリクエストします。キーは X-API-KEY として送信します。90 日間未使用のキーは ODP によって削除されます。
• TSDR キー（商標）：https://account.uspto.gov/api-manager/ から TSDR 製品をリクエストし、USPTO-API-KEY として送信します。X-Api-Key ヘッダーは無視されるため、キーなしのリクエストとして処理されます（HTTP 401）。

export USPTO_ODP_API_KEY="..."    # ODP scripts (USPTO_API_KEY is read as a fallback)
export USPTO_TSDR_API_KEY="..."   # trademark_client.py

ヘルパースクリプト

• scripts/patent_search.py — ODP Patent File Wrapper 検索（タイトル、 発明者、出願人、特許付与日の範囲、特許番号の検索）
• scripts/peds_client.py — ODP ファイルラッパークライアント。PEDS の後継 （FileWrapperClient、別名 PEDSHelper）：ステータスの概要、取引履歴、 オフィスアクションのイベント、審査統計、継続出願、譲渡
• scripts/trademark_client.py — 商標のステータス、所有者、 商品／サービス、審査履歴を扱う TSDR クライアント

スクリプトは ODP OpenAPI 仕様と実際のエンドポイントのルーティング（キーなしでは 401／403）に照らして確認済みです。スクリプトを信頼して使用する前に、ご自身のキーを使って実行してください。

タスク 1：特許の検索

次の URL に JSON 本文を POST します：https://api.uspto.gov/api/v1/patent/applications/search

import os, requests

body = {
    "q": 'applicationMetaData.inventionTitle:"lidar"',
    "filters": [{"name": "applicationMetaData.applicationTypeLabelName", "value": ["Utility"]}],
    "rangeFilters": [{"field": "applicationMetaData.grantDate",
                      "valueFrom": "2024-01-01", "valueTo": "2024-12-31"}],
    "sort": [{"field": "applicationMetaData.grantDate", "order": "desc"}],
    "pagination": {"offset": 0, "limit": 25},
}
r = requests.post("https://api.uspto.gov/api/v1/patent/applications/search",
                  headers={"X-API-KEY": os.environ["USPTO_ODP_API_KEY"]}, json=body, timeout=60)
for rec in r.json().get("patentFileWrapperDataBag", []):
    meta = rec["applicationMetaData"]
    print(rec["applicationNumberText"], meta.get("patentNumber"), meta.get("inventionTitle"))

クエリ言語は Solr に似ています（field:value、AND／OR／NOT、ワイルドカード、引用符で囲んだフレーズ）。便利な applicationMetaData フィールド：inventionTitle、patentNumber、filingDate、grantDate、applicationStatusDescriptionText、firstApplicantName、firstInventorName、cpcClassificationBag、groupArtUnitNumber、examinerNameText。一致するレコードがない検索では、空の 200 ではなく HTTP 404（「一致するレコードが見つかりません」）が返されます。ファイルラッパーに含まれるのは書誌データのみで、請求項や要約は含まれません。

references/patentsearch_api.md では、オフラインの PatentsView PatentSearch API（クエリ演算子、フィールド）について説明しています。古いコードを読む場合や、USPTO が API を復旧した場合に参照してください。references/usage_examples.md（タスク 1）には、動作するコード例があります。

タスク 2：特許審査データの取得

GET https://api.uspto.gov/api/v1/patent/applications/{applicationNumberText}/transactions は、{eventCode, eventDescriptionText, eventDate} の eventDataBag[] 項目を返します。/meta-data はステータス、日付、審査官、審査部門を返します。scripts/peds_client.py はこれらをラップします（get_status_summary、get_transaction_history、get_office_actions、analyze_prosecution、get_continuity、get_assignments）。

一般的な取引コード：CTNF（最終前拒絶）、CTFR（最終拒絶）、NOA（許可通知）、WRIT（応答提出）、ISS.FEE（発行手数料）、ABND（放棄）、AOPF（オフィスアクション発送）。申請の ステータス コード（イベントコードではありません）は、GET /api/v1/patent/status-codes に記載されています。

references/peds_api.md では、取引コードと審査分析について説明しています。PEDS／ライブラリの各セクションは過去の情報です。

タスク 3：商標の検索と監視

TSDR（Trademark Status & Document Retrieval）の使用

GET https://tsdrapi.uspto.gov/ts/cd/casestatus/sn{serial}/info（または rn{registration}）は ST96 XML のステータスレコードを返します。casedocs/{caseid}/info は案件の文書一覧を返し、.../content.pdf／download.zip で取得できます（1 分あたり 4 件）。scripts/trademark_client.py の TrademarkClient は、シリアル番号または登録番号で商標を検索し、ステータスを取得し、check_trademark_health を実行して、ポートフォリオの監視をサポートします。

一般的なステータス：REGISTERED、PENDING、PUBLISHED FOR OPPOSITION、ABANDONED、CANCELLED、SUSPENDED、REGISTERED AND RENEWED。

動作するコード例については references/usage_examples.md（タスク 3）を、ステータスコード、審査履歴、所有権の追跡については references/trademark_api.md を参照してください。

タスク 4：譲渡と所有権の追跡

Assignment Search API のホスト（assignment-api.uspto.gov）は廃止されています。特定の申請については、GET https://api.uspto.gov/api/v1/patent/applications/{app}/assignment が reelAndFrameNumber、conveyanceText、assignmentRecordedDate、assignorBag、assigneeBag を含む assignmentBag[] を返します（scripts/peds_client.py --assignments {app}）。企業全体の所有権に関する問い合わせには、ODP バルクデータカタログの譲渡データセットを使用してください。

一般的な譲渡の種類：ASSIGNMENT OF ASSIGNORS INTEREST（所有権の移転）、SECURITY AGREEMENT、MERGER、CHANGE OF NAME、ASSIGNMENT OF PARTIAL INTEREST。

タスク 5：オフィスアクション、引用、PTAB

• オフィスアクション（テキスト取得、PTO-892/1449 からの引用、法令 101/102/103/112/二重特許に基づく拒絶、および AI で抽出された拡充引用）は、Lucene の criteria 文字列を含むフォームエンコードされた POST として ODP ホストから提供されます。例：criteria=patentApplicationNumber:12190351、start=0、rows=25、送信先は https://api.uspto.gov/api/v1/patent/oa/oa_rejections/v2/records です。
• PTABの審理手続（IPR、PGR、CBM）、決定、文書、および当事者系再審査の決定には、ODP の検索エンドポイントがあります（上表を参照）。
• 訴訟および Cancer Moonshot データセットは、廃止された developer.uspto.gov 上の DSAPI サービスでした。ODP の一括データカタログで探してください。

references/additional_apis.md では、各データセットに含まれる内容と、それらを組み合わせる方法を説明しています。

分析の完全な例

特許に関する包括的な情報を得るには、Patent File Wrapper の検索で出願を見つけ、/meta-data と /transactions を取得して審査経過を確認し、/continuity でファミリーを、/assignment で所有権を確認してから、オフィスアクションの拒絶 API で拒絶理由を調べます。references/usage_examples.md の「分析の完全な例」に、実例があります。

ベストプラクティス

1. キー：ODP と TSDR のキーは環境変数に保存し、コードやバージョン管理には決して含めないでください。これらは別々のキーであり、異なるヘッダーで送信します。
2. レート制限：TSDR では、キーごとに 1 分あたり 60 リクエスト（PDF/ZIP は 1 分あたり 4 リクエスト）が許可されています。すべての USPTO API で HTTP 429 が返された場合は、指数バックオフを行ってください。
3. 対象範囲：Patent File Wrapper には 2001-01-01 以降に出願されたものが含まれます。それ以前の特許や、請求項・説明文の全文には一括データを使用してください。
4. データの取り扱い：係属中または古い出願では、多くのフィールドが存在しない場合があります。キーの欠落に対応し、日付は YYYY-MM-DD 形式の文字列として解析してください。
5. 再現性：ODP は毎日更新されます。結果とともにクエリの日付を記録してください。

リソース

• Open Data Portal：https://data.uspto.gov/（APIs → Getting Started。インタラクティブな Swagger UI の利用には ODP キーが必要です）
• PatentsView → ODP 移行ガイド：https://data.uspto.gov/support/transition-guide/patentsview
• PEDS → ODP 移行ガイド（PEDS-to-ODP API マッピング）：https://data.uspto.gov/support/transition-guide/peds
• TSDR キーマネージャー：https://account.uspto.gov/api-manager/
• ODP サポート：[email protected]

参照ファイル

• references/usage_examples.md - タスクごとの Python 実例
• references/patentsearch_api.md - PatentsView PatentSearch API（2026-03-20 以降オフライン。過去の資料）
• references/peds_api.md - 取引コードと審査分析（PEDS の各セクションは過去の資料）
• references/trademark_api.md - TSDR 商標 API
• references/additional_apis.md - オフィスアクション、引用、PTAB、訴訟データセット

スクリプト

• scripts/patent_search.py - ODP Patent File Wrapper 検索クライアント
• scripts/peds_client.py - ODP ファイルラッパークライアント（PEDS の後継）
• scripts/trademark_client.py - TSDR 商標クライアント