pyUSPTO 0.5.0__tar.gz → 0.5.2__tar.gz

{pyuspto-0.5.0 → pyuspto-0.5.2}/.github/workflows/publish-docs.yaml

@@ -19,7 +19,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.10"
+          python-version: "3.14"
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip

{pyuspto-0.5.0 → pyuspto-0.5.2}/.github/workflows/python-tests.yml

@@ -32,7 +32,7 @@ jobs:
           pytest tests/ --cov=src/pyUSPTO
 
       - name: Upload coverage report
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         with:
           fail_ci_if_error: false
 

{pyuspto-0.5.0 → pyuspto-0.5.2}/CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing to pyUSPTO
 
-We welcome contributions from the community! pyUSPTO is designed to be a useful tool for interacting with USPTO APIs, and your input helps make it better for everyone.
+We welcome contributions from the community! pyUSPTO is designed to be a useful tool for interacting with USPTO APIs, and your input helps make it better for everyone. The repository is hosted on [GitHub](https://github.com/DunlapCoddingPC/pyUSPTO).
 
 ## Ways to Contribute
 

{pyuspto-0.5.0 → pyuspto-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyUSPTO
-Version: 0.5.0
+Version: 0.5.2
 Summary: A Modern Python client for accessing the United States Patent and Trademark Office (USPTO) Open Data Portal (ODP) APIs.
 Author-email: Andrew Piechocki <apiechocki@dunlapcodding.com>
 License-Expression: MIT
@@ -42,7 +42,8 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.32.5
 Requires-Dist: typing-extensions>=4.15.0; python_version < "3.11"
-Requires-Dist: tzdata>=2025.3
+Requires-Dist: tzdata>=2026.1
+Requires-Dist: urllib3>=2.0.0
 Provides-Extra: test
 Requires-Dist: pytest>=9.0.2; extra == "test"
 Requires-Dist: pytest-cov>=7.0.0; extra == "test"
@@ -51,7 +52,6 @@ Requires-Dist: typing_extensions>=4.15.0; extra == "test"
 Provides-Extra: docs
 Requires-Dist: sphinx>=9.1.0; extra == "docs"
 Requires-Dist: sphinx-rtd-theme>=3.1.0; extra == "docs"
-Requires-Dist: sphinx_immaterial>=0.13.9; extra == "docs"
 Requires-Dist: sphinx-autodoc-typehints>=3.9.5; extra == "docs"
 Requires-Dist: sphinx-copybutton>=0.5.2; extra == "docs"
 Requires-Dist: myst-parser>=5.0.0; extra == "docs"
@@ -75,7 +75,7 @@ Dynamic: license-file
 
 A Python client library for interacting with the United Stated Patent and Trademark Office (USPTO) [Open Data Portal](https://data.uspto.gov/home) APIs.
 
-This package provides clients for interacting with the USPTO Bulk Data API, Patent Data API, Final Petition Decisions API, and PTAB (Patent Trial and Appeal Board) APIs.
+This package provides clients for interacting with the USPTO Bulk Data API, Patent Data API, Final Petition Decisions API, PTAB (Patent Trial and Appeal Board) APIs, Enriched Citations API, Office Action Text Retrieval API, Office Action Rejections API, and Office Action Citations API.
 
 > [!IMPORTANT]
 > The USPTO is in the process of moving their Developer API. This package is only concerned with the new API. The [old API](https://developer.uspto.gov/) was officially retired at the end of 2025; however, some products have not yet been fully transitioned to the Open Data Portal API. The USPTO expects the remaining products to be transitioned to the Open Data Portal in early 2026.
@@ -123,6 +123,10 @@ Then use it in your Python code:
 ```python
 from pyUSPTO import (
     BulkDataClient,
+    EnrichedCitationsClient,
+    OAActionsClient,
+    OACitationsClient,
+    OARejectionsClient,
     PatentDataClient,
     FinalPetitionDecisionsClient,
     PTABTrialsClient,
@@ -140,6 +144,10 @@ petition_client = FinalPetitionDecisionsClient(config=config)
 trials_client = PTABTrialsClient(config=config)
 appeals_client = PTABAppealsClient(config=config)
 interferences_client = PTABInterferencesClient(config=config)
+citations_client = EnrichedCitationsClient(config=config)
+oa_client = OAActionsClient(config=config)
+oa_citations_client = OACitationsClient(config=config)
+rejections_client = OARejectionsClient(config=config)
 ```
 
 ### Direct API Key
@@ -157,6 +165,17 @@ config = USPTOConfig(api_key="your_api_key_here")
 > [!TIP]
 > For comprehensive examples with detailed explanations, see the [`examples/`](examples/) directory.
 
+1. [Patent Data API](#patent-data-api)
+2. [Bulk Data API](#bulk-data-api)
+3. [Final Petition Decisions API](#final-petition-decisions-api)
+4. [PTAB Trials API](#ptab-trials-api)
+5. [PTAB Appeals API](#ptab-appeals-api)
+6. [PTAB Interferences API](#ptab-interferences-api)
+7. [Enriched Citations API](#enriched-citations-api)
+8. [Office Action Text Retrieval API](#office-action-text-retrieval-api)
+9. [Office Action Rejections API](#office-action-rejections-api)
+10. [Office Action Citations API](#office-action-citations-api)
+
 ### Patent Data API
 
 ```python
@@ -302,6 +321,79 @@ print(f"Found {response.count} interference decisions since 2023")
 
 See [`examples/ptab_interferences_example.py`](examples/ptab_interferences_example.py) for detailed examples including searching by party name and outcome.
 
+### Enriched Citations API
+
+```python
+from pyUSPTO import EnrichedCitationsClient, USPTOConfig
+
+config = USPTOConfig(api_key="your_api_key_here")
+client = EnrichedCitationsClient(config=config)
+
+# Search for enriched citations by technology center
+response = client.search_citations(
+    tech_center_q="1700",
+    rows=5,
+)
+print(f"Found {response.count} citations from TC 1700")
+```
+
+See [`examples/enriched_citations_example.py`](examples/enriched_citations_example.py) for detailed examples including searching by application number and citation category.
+
+### Office Action Text Retrieval API
+
+```python
+from pyUSPTO import OAActionsClient, USPTOConfig
+
+config = USPTOConfig(api_key="your_api_key_here")
+client = OAActionsClient(config=config)
+
+# Search for office actions by technology center
+response = client.search(
+    tech_center_q="1700",
+    rows=5,
+)
+print(f"Found {response.count} office actions from TC 1700")
+```
+
+See [`examples/oa_actions_example.py`](examples/oa_actions_example.py) for detailed examples including searching by document code and paginating results.
+
+### Office Action Rejections API
+
+```python
+from pyUSPTO import OARejectionsClient, USPTOConfig
+
+config = USPTOConfig(api_key="your_api_key_here")
+client = OARejectionsClient(config=config)
+
+# Search for rejections by application number
+response = client.search(
+    patent_application_number_q="12190351",
+    rows=5,
+)
+print(f"Found {response.count} rejection records for application 12190351")
+```
+
+See [`examples/oa_rejections_example.py`](examples/oa_rejections_example.py) for detailed examples including searching by document code and inspecting rejection flags.
+
+### Office Action Citations API
+
+```python
+from pyUSPTO import OACitationsClient, USPTOConfig
+
+config = USPTOConfig(api_key="your_api_key_here")
+client = OACitationsClient(config=config)
+
+# Search for citations by legal section code
+response = client.search(
+    legal_section_code_q="103",
+    tech_center_q="2800",
+    rows=5,
+)
+print(f"Found {response.count} section 103 citations in tech center 2800")
+```
+
+See [`examples/oa_citations_example.py`](examples/oa_citations_example.py) for detailed examples including searching by examiner-cited indicator and paginating results.
+
 ## Documentation
 
 Full documentation may be found on [Read the Docs](https://pyuspto.readthedocs.io/).

{pyuspto-0.5.0 → pyuspto-0.5.2}/README.md

@@ -8,7 +8,7 @@
 
 A Python client library for interacting with the United Stated Patent and Trademark Office (USPTO) [Open Data Portal](https://data.uspto.gov/home) APIs.
 
-This package provides clients for interacting with the USPTO Bulk Data API, Patent Data API, Final Petition Decisions API, and PTAB (Patent Trial and Appeal Board) APIs.
+This package provides clients for interacting with the USPTO Bulk Data API, Patent Data API, Final Petition Decisions API, PTAB (Patent Trial and Appeal Board) APIs, Enriched Citations API, Office Action Text Retrieval API, Office Action Rejections API, and Office Action Citations API.
 
 > [!IMPORTANT]
 > The USPTO is in the process of moving their Developer API. This package is only concerned with the new API. The [old API](https://developer.uspto.gov/) was officially retired at the end of 2025; however, some products have not yet been fully transitioned to the Open Data Portal API. The USPTO expects the remaining products to be transitioned to the Open Data Portal in early 2026.
@@ -56,6 +56,10 @@ Then use it in your Python code:
 ```python
 from pyUSPTO import (
     BulkDataClient,
+    EnrichedCitationsClient,
+    OAActionsClient,
+    OACitationsClient,
+    OARejectionsClient,
     PatentDataClient,
     FinalPetitionDecisionsClient,
     PTABTrialsClient,
@@ -73,6 +77,10 @@ petition_client = FinalPetitionDecisionsClient(config=config)
 trials_client = PTABTrialsClient(config=config)
 appeals_client = PTABAppealsClient(config=config)
 interferences_client = PTABInterferencesClient(config=config)
+citations_client = EnrichedCitationsClient(config=config)
+oa_client = OAActionsClient(config=config)
+oa_citations_client = OACitationsClient(config=config)
+rejections_client = OARejectionsClient(config=config)
 ```
 
 ### Direct API Key
@@ -90,6 +98,17 @@ config = USPTOConfig(api_key="your_api_key_here")
 > [!TIP]
 > For comprehensive examples with detailed explanations, see the [`examples/`](examples/) directory.
 
+1. [Patent Data API](#patent-data-api)
+2. [Bulk Data API](#bulk-data-api)
+3. [Final Petition Decisions API](#final-petition-decisions-api)
+4. [PTAB Trials API](#ptab-trials-api)
+5. [PTAB Appeals API](#ptab-appeals-api)
+6. [PTAB Interferences API](#ptab-interferences-api)
+7. [Enriched Citations API](#enriched-citations-api)
+8. [Office Action Text Retrieval API](#office-action-text-retrieval-api)
+9. [Office Action Rejections API](#office-action-rejections-api)
+10. [Office Action Citations API](#office-action-citations-api)
+
 ### Patent Data API
 
 ```python
@@ -235,6 +254,79 @@ print(f"Found {response.count} interference decisions since 2023")
 
 See [`examples/ptab_interferences_example.py`](examples/ptab_interferences_example.py) for detailed examples including searching by party name and outcome.
 
+### Enriched Citations API
+
+```python
+from pyUSPTO import EnrichedCitationsClient, USPTOConfig
+
+config = USPTOConfig(api_key="your_api_key_here")
+client = EnrichedCitationsClient(config=config)
+
+# Search for enriched citations by technology center
+response = client.search_citations(
+    tech_center_q="1700",
+    rows=5,
+)
+print(f"Found {response.count} citations from TC 1700")
+```
+
+See [`examples/enriched_citations_example.py`](examples/enriched_citations_example.py) for detailed examples including searching by application number and citation category.
+
+### Office Action Text Retrieval API
+
+```python
+from pyUSPTO import OAActionsClient, USPTOConfig
+
+config = USPTOConfig(api_key="your_api_key_here")
+client = OAActionsClient(config=config)
+
+# Search for office actions by technology center
+response = client.search(
+    tech_center_q="1700",
+    rows=5,
+)
+print(f"Found {response.count} office actions from TC 1700")
+```
+
+See [`examples/oa_actions_example.py`](examples/oa_actions_example.py) for detailed examples including searching by document code and paginating results.
+
+### Office Action Rejections API
+
+```python
+from pyUSPTO import OARejectionsClient, USPTOConfig
+
+config = USPTOConfig(api_key="your_api_key_here")
+client = OARejectionsClient(config=config)
+
+# Search for rejections by application number
+response = client.search(
+    patent_application_number_q="12190351",
+    rows=5,
+)
+print(f"Found {response.count} rejection records for application 12190351")
+```
+
+See [`examples/oa_rejections_example.py`](examples/oa_rejections_example.py) for detailed examples including searching by document code and inspecting rejection flags.
+
+### Office Action Citations API
+
+```python
+from pyUSPTO import OACitationsClient, USPTOConfig
+
+config = USPTOConfig(api_key="your_api_key_here")
+client = OACitationsClient(config=config)
+
+# Search for citations by legal section code
+response = client.search(
+    legal_section_code_q="103",
+    tech_center_q="2800",
+    rows=5,
+)
+print(f"Found {response.count} section 103 citations in tech center 2800")
+```
+
+See [`examples/oa_citations_example.py`](examples/oa_citations_example.py) for detailed examples including searching by examiner-cited indicator and paginating results.
+
 ## Documentation
 
 Full documentation may be found on [Read the Docs](https://pyuspto.readthedocs.io/).

pyuspto-0.5.2/docs/source/about.rst

@@ -0,0 +1,58 @@
+About pyUSPTO
+=============
+
+pyUSPTO is a Python client library for interacting with the `USPTO Open Data Portal (ODP) <https://data.uspto.gov/home>`_ APIs.
+The library handles authentication, HTTP session management, pagination, and response deserialization,
+so you can work directly with typed Python objects instead of raw JSON.
+
+The source code for the pyUSPTO library is available on `GitHub <https://github.com/DunlapCoddingPC/pyUSPTO>`_ and is licensed under the MIT License. Contributions are welcome! Please see the :doc:`contributing guidelines <development>`.
+
+What is the USPTO Open Data Portal?
+------------------------------------
+
+The USPTO Open Data Portal is the United States Patent and Trademark Office's primary API platform
+for publicly available patent and trademark data. It provides programmatic access to patent applications,
+grants, bulk data downloads, PTAB proceedings, Office Actions, and more.
+
+.. note::
+
+   An API key is required to use the ODP APIs. You can register for one at the
+   `USPTO Open Data Portal <https://data.uspto.gov/myodp/landing>`_.
+
+Available Clients
+-----------------
+
+pyUSPTO provides the following clients:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 35 65
+
+   * - Client
+     - Description
+   * - :class:`~pyUSPTO.PatentDataClient`
+     - Search patent applications and grants, retrieve file wrappers and Image File Wrapper (IFW) documents, and download individual documents and publications.
+   * - :class:`~pyUSPTO.BulkDataClient`
+     - Search and download bulk data products from the ODP Bulk Dataset Directory, including patent grants, applications, assignments, and research datasets.
+   * - :class:`~pyUSPTO.FinalPetitionDecisionsClient`
+     - Search and retrieve Final Petition Decisions issued by the USPTO Director.
+   * - :class:`~pyUSPTO.PTABTrialsClient`
+     - Search PTAB trial proceedings (IPR, PGR, CBM, and derivation), documents, and decisions.
+   * - :class:`~pyUSPTO.PTABAppealsClient`
+     - Search PTAB ex parte appeal decisions by application number, technology center, examiner, and more.
+   * - :class:`~pyUSPTO.PTABInterferencesClient`
+     - Search PTAB interference decisions.
+   * - :class:`~pyUSPTO.EnrichedCitationsClient`
+     - Search enriched citation data linking cited references to the specific claims and rejections they support.
+   * - :class:`~pyUSPTO.OAActionsClient`
+     - Full-text search of Office Action documents, including body text and structured section data.
+   * - :class:`~pyUSPTO.OARejectionsClient`
+     - Search rejection-level data from Office Actions, including rejection type, claims, and examiner metadata.
+   * - :class:`~pyUSPTO.OACitationsClient`
+     - Search citation data from Office Actions derived from Form PTO-892, Form PTO-1449, and Office Action text.
+
+Requirements
+------------
+
+- Python 3.10 or higher
+- A USPTO Open Data Portal API key

pyuspto-0.5.2/docs/source/api/clients/bulk_data.rst

@@ -0,0 +1,268 @@
+Bulk Data Client
+================
+
+.. automodule:: pyUSPTO.clients.bulk_data
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. _bulk-data-product-identifiers:
+
+Bulk Data Product Identifiers
+------------------------------
+
+The table below lists all product identifiers available in the USPTO Open Data Portal Bulk Dataset Directory.
+Pass these identifiers to :meth:`~pyUSPTO.BulkDataClient.get_product_by_id` or use them as a filter
+when calling :meth:`~pyUSPTO.BulkDataClient.search_products`.
+
+.. note::
+
+   This table reflects the Bulk Dataset Directory as of 2026-Mar-30 (47 products).
+   Source: `2026 Bulk Data Product Descriptions <https://data.uspto.gov/documents/documents/2026BulkDataProductDescriptions.xlsx>`_.
+   USPTO adds new products over time; use :meth:`~pyUSPTO.BulkDataClient.search_products`
+   without filters to retrieve the current full list.
+
+.. list-table::
+   :header-rows: 1
+   :widths: 10 25 15 8 42
+
+   * - Identifier
+     - Name
+     - Dates Available
+     - File Types
+     - Description
+   * - OACT
+     - Office Actions Weekly Archives
+     - 2023-Dec-18 – Present
+     - JSON
+     - Full-text of public Office Actions bundled as JSON in downloadable weekly ZIP files. Data covers 2020-01-06 to present.
+   * - PTFWPRD
+     - Patent File Wrapper (Bulk Datasets) – Daily
+     - 2026-Mar-23 – Present
+     - JSON
+     - Bibliographic and assignment static patent data as daily delta increments.
+   * - PTFWPRE
+     - Patent File Wrapper (Bulk Datasets) – Weekly
+     - 2001-Jan-01 – Present
+     - JSON
+     - Bibliographic and assignment static patent data as weekly datasets in 10-year increments.
+   * - TRTDXFAP
+     - Trademark Full Text XML Data (No Images) – Daily Applications
+     - 2025-Jan-01 – Present
+     - XML
+     - Pending and registered trademark text data (no images) for the current calendar year per the U.S. Trademark Applications Version 2.3 DTD.
+   * - TTABTDXF
+     - Trademark Full Text XML Data (No Images) – Daily TTAB
+     - 2025-Jan-01 – Present
+     - XML
+     - TTAB text data (no images) for the current calendar year per the TTAB Version 1.0 DTD.
+   * - PTGRMP2
+     - Patent Grant Multi-page PDF Images
+     - 1790-Jul-31 – Present
+     - PDF
+     - Multi-page PDF images of each patent grant issued weekly (Tuesdays) from 1790 to present. Includes Certificates-of-Correction and rescanned older grants.
+   * - APPXML
+     - Patent Application Full-Text Data (No Images)
+     - 2001-Mar-15 – Present
+     - XML
+     - Concatenated full-text XML of non-provisional utility and plant patent applications published weekly (Thursdays).
+   * - APPMP2
+     - Patent Application Multi-Page PDF Images
+     - 2001-Mar-15 – Present
+     - PDF
+     - Multi-page PDF images of non-provisional utility and plant patent applications published weekly (Thursdays).
+   * - APPBLXML
+     - Patent Application Bibliographic (Front Page) Data
+     - 2001-Mar-15 – Present
+     - XML
+     - Concatenated bibliographic (front page) text of patent applications published weekly (Thursdays); excludes images. Subset of APPXML.
+   * - APPDT
+     - Patent Application Full Text Data with Embedded TIFF Images
+     - 2001-Mar-15 – Present
+     - XML
+     - Full text, images/drawings, and complex work units (tables, math, chemical structures, genetic sequences) of patent applications published weekly (Thursdays).
+   * - PTMNFEE2
+     - Patent Maintenance Fee Events
+     - 2026-Jan-06 – Present
+     - ASCII
+     - Cumulative weekly file of recorded maintenance fee events for patents granted from 1981-Sep-01 to present.
+   * - PTGRDT
+     - Patent Grant Full Text Data with Embedded TIFF Images (Grant Red Book / WIPO ST.36)
+     - 2002-Jan-01 – Present
+     - XML
+     - Full text, images/drawings, and complex work units of patent grants issued weekly (Tuesdays).
+   * - GZLST
+     - Patent Official Gazettes
+     - 2002-Jul-02 – Present
+     - HTML
+     - Weekly bibliographic information, representative claim, and drawing for each patent grant, plus USPTO Notices.
+   * - PTGRXML
+     - Patent Grant Full-Text Data (No Images)
+     - 2002-Jan-01 – Present
+     - ASCII, XML
+     - Concatenated full-text of patent grant documents issued weekly (Tuesdays); excludes images.
+   * - PTBLXML
+     - Patent Grant Bibliographic (Front Page) Text Data
+     - 2002-Jan-01 – Present
+     - ASCII, XML
+     - Concatenated bibliographic (front page) text of patent grant documents issued weekly (Tuesdays); excludes images. Subset of PTGRXML.
+   * - CPCMCPT
+     - CPC Master Classification Files for U.S. Patent Grants
+     - 2025-Jun-17 – Present
+     - TXT, XML
+     - CPC classification data for all U.S. patent grants from 1790-Jul-31 to present, updated monthly.
+   * - CPCMCAPP
+     - CPC Master Classification Files for U.S. Patent Applications
+     - 2025-Jun-17 – Present
+     - TXT, XML
+     - CPC classification data for all U.S. patent applications published from 2001-Mar-15 to present, updated monthly.
+   * - PVPGPUBTXT
+     - PatentsView Pre-Grant Publication Long Text Data
+     - 2001-Mar-15 – Present
+     - TSV
+     - Annual files of long-text fields (Brief Summary, Claims, Detail Description, Drawing Description) for pre-grant publications from 2001 to present.
+   * - PVGPATTXT
+     - PatentsView Granted Patent Long Text Data
+     - 1976-Jan-01 – Present
+     - TSV
+     - Annual files of long-text fields (Brief Summary, Claims, Detail Description, Drawing Description) for granted patents from 1976 to present.
+   * - PVPGPUBDIS
+     - PatentsView Pre-Grant Publication Disambiguated Data
+     - 2001-Mar-15 – Present
+     - TSV
+     - 25 files for pre-grant publications from 2001 to present, including disambiguated applicants, assignees, inventors, locations, technology categories, and government interest statements.
+   * - PVGPATDIS
+     - PatentsView Granted Patent Disambiguated Data
+     - 1976-Jan-01 – Present
+     - TSV
+     - 35 files for granted patents from 1976 to present, including disambiguated assignees, inventors, locations, cited prior art, examiner name, and government interest statements.
+   * - PVSORTED
+     - PatentsView Sorted Data (Beta)
+     - 1976-Jan-01 – Present
+     - TSV
+     - Reorganized bibliographic data correcting inventor/applicant/assignee ordering inconsistencies introduced by the Leahy-Smith America Invents Act.
+   * - PVANNUAL
+     - PatentsView Annualized Patent Data
+     - 1976-Jan-01 – Present
+     - CSV
+     - Small annual CSV files derived from PatentsView Granted Patent Disambiguated Data, including inventor gender attribution.
+   * - TRTYRAP
+     - Trademark Full Text XML Data (No Images) – Annual Applications
+     - 1884-Apr-07 – Present
+     - XML
+     - Backfile of pending and registered trademark text data (no images) from 1884-Apr through 2025-Dec per the U.S. Trademark Applications Version 2.3 DTD.
+   * - TRTDXFAG
+     - Trademark Full Text XML Data (No Images) – Daily Assignments
+     - 2025-Jan-01 – Present
+     - XML
+     - Trademark assignment text data (no images) for the current calendar year per the Trademark Assignments Version 0.4 DTD.
+   * - PASDL
+     - Patent Assignment XML (Ownership) Text – Daily
+     - 2025-Jan-01 – Present
+     - XML
+     - Daily patent assignment text (no images) for the current calendar year derived from USPTO assignment recordations.
+   * - PASYR
+     - Patent Assignment XML (Ownership) Text – Annual
+     - 1980-Jan-01 – Present
+     - XML
+     - Annual backfile of patent assignment text (no images) from 1980-Aug through 2025-Dec.
+   * - ECOPATAI
+     - Artificial Intelligence Patent Dataset (AIPD)
+     - 2021-Jul-30 – 2026-Feb-03
+     - DTA, TSV
+     - AI patent landscape data classifying 13.2M granted patents and PGPubs from 1976–2020 across eight AI component technologies using machine learning models.
+   * - TRTYRAG
+     - Trademark Full Text XML Data (No Images) – Annual Assignments
+     - 1951-Oct-02 – Present
+     - XML
+     - Backfile of trademark assignment text data from 1955-Jan-03 through 2025-Dec per the Trademark Assignments Version 0.4 DTD.
+   * - TTABYR
+     - Trademark Full Text XML Data (No Images) – Annual TTAB
+     - 1951-Oct-02 – Present
+     - XML
+     - Backfile of TTAB text data from 1951-Oct-02 through 2025-Dec per the TTAB Version 1.0 DTD.
+   * - PEDSJSON
+     - Patent Examination Data System (Bulk Datasets) – JSON
+     - 1900-Jan-01 – 2000-Dec-31
+     - JSON
+     - Static snapshot (created 2025-Mar-17) of patent application data from 1900–2000, migrated from the retired PEDS system, in 20-year increment downloads.
+   * - PEDSXML
+     - Patent Examination Data System (Bulk Datasets) – XML
+     - 1900-Jan-01 – 2000-Dec-31
+     - XML
+     - Static snapshot (created 2025-Mar-16) of patent application data from 1900–2000, migrated from the retired PEDS system, in 20-year increment downloads.
+   * - ECORSEXC
+     - Patent Assignment Data for Academia and Researchers
+     - 2015-Aug-05 – 2024-Apr-19
+     - DTA, TSV
+     - ~10M patent assignments and transactions recorded at USPTO since 1970, covering ~17.8M patents and applications.
+   * - TRASECO
+     - Trademark Assignment Data for Academia and Researchers
+     - 2014-Apr-18 – 2024-Apr-01
+     - CSV, DTA
+     - 1.29M trademark assignments and transactions recorded at USPTO between 1952 and 2023, covering 2.28M unique trademark properties.
+   * - TRCFECO2
+     - Trademark Case File Data for Academia and Researchers
+     - 2013-Jan-02 – 2024-Mar-27
+     - CSV, DTA
+     - 12.1M trademark applications filed with or registrations issued by USPTO between 1870 and January 2023.
+   * - PTLITIG
+     - Patent Litigation Docket Report Data Files for Academia and Researchers
+     - 2016-Dec-29 – 2024-Mar-27
+     - CSV, DTA
+     - U.S. District Court patent litigation data on 81,350 unique cases filed 1963–2020, sourced from PACER and RECAP, including parties, cause of action, court location, key dates, and 5M+ docket documents.
+   * - ECOPAIR
+     - Patent Examination Research Dataset (PatEx)
+     - 2015-Dec-02 – 2023-Sep-26
+     - CSV, DTA
+     - 13M+ publicly viewable patent applications and 1M+ PCT applications through June 2023, including prosecution history, continuation history, foreign priority claims, and PTA history.
+   * - PTAPOATH
+     - Patent and Patent Application Oath Signature Dataset
+     - 2022-Sep-30 – 2022-Sep-30
+     - JPEG, JSON
+     - 883,811 signature images extracted from patent inventor oath documents from 1998-Sep to 2022-Sep, broken into 8 ZIP files by series code (12–17, 29, 35). 40.5 GB total.
+   * - PTOFFACT
+     - Patent Application Office Actions Research Dataset
+     - 2017-Nov-29 – 2017-Nov-29
+     - CSV, DTA
+     - 4.4M Office actions mailed 2008–June 2017 for 2.2M publicly viewable applications, including grounds for rejection, claims, and pertinent prior art.
+   * - PTGRAPS
+     - Patent Grant Full-Text Data (No Images) – APS
+     - 1976-Jan-06 – Present
+     - ASCII, XML
+     - Concatenated full-text of patent grants issued weekly (Tuesdays) from 1976-Jan-01 to 2001-Dec-25; excludes images.
+   * - PTBLAPS
+     - Patent Grant Bibliographic (Front Page) Text Data – APS
+     - 1976-Jan-01 – Present
+     - ASCII, XML
+     - Concatenated bibliographic (front page) text of patent grants issued weekly (Tuesdays) from 1976-Jan-01 to 2000-Dec-26; excludes images. Subset of PTGRAPS.
+   * - PTAPPCLM
+     - Patent and Patent Application Claims Research Dataset
+     - 2016-Oct-07 – 2016-Oct-11
+     - CSV, DTA
+     - Claims data for U.S. patents granted 1976–2014 and applications published 2001–2014, including individual claim text, dependency relationships, claim-level and document-level statistics.
+   * - MOONSHOT
+     - Cancer Moonshot Patent Data Files
+     - 2016-Aug-19 – 2016-Aug-19
+     - CSV
+     - 269,353 patent documents from 1976–2016 curated to identify R&D in diagnostics, therapeutics, data analytics, and model biological systems.
+   * - HISTEXC
+     - Historical Patent Data Files for Academia and Researchers
+     - 2015-Jun-25 – 2015-Jul-02
+     - CSV, DTA
+     - Four NBER research datasets with time-series and micro-level data by technology sub-category spanning two centuries of patent applications, grants, and in-force patents.
+   * - PTBLSGM
+     - Patent Grant Bibliographic (Front Page) Text Data – SGML
+     - 2001-Jan-02 – Present
+     - ASCII, XML
+     - Concatenated bibliographic (front page) text of patent grants issued weekly (Tuesdays) from 2001-Jan-02 to 2001-Dec-25; excludes images. Subset of PTGRDSGM.
+   * - PTGRDSGM
+     - Patent Grant Full Text Data with Embedded TIFF Images (Grant Red Book / WIPO ST.36) – SGML
+     - 2001-Jan-02 – Present
+     - XML
+     - Full text, images/drawings, and complex work units of patent grants issued weekly (Tuesdays) from 2001-Jan-02 to 2001-Dec-25.
+   * - PTGRSGM
+     - Patent Grant Full-Text Data (No Images) – SGML
+     - 2001-Jan-02 – Present
+     - ASCII, XML
+     - Concatenated full-text of patent grants issued weekly (Tuesdays) from 2001-Jan-02 to 2001-Dec-25; excludes images.

{pyuspto-0.5.0 → pyuspto-0.5.2}/docs/source/api/clients/index.rst

@@ -6,6 +6,9 @@ Clients
 
    bulk_data
    enriched_citations
+   oa_actions
+   oa_citations
+   oa_rejections
    patent_data
    petition_decisions
    ptab_appeals

pyuspto-0.5.2/docs/source/api/clients/oa_actions.rst

@@ -0,0 +1,7 @@
+OA Actions Client
+=================
+
+.. automodule:: pyUSPTO.clients.oa_actions
+   :members:
+   :undoc-members:
+   :show-inheritance:

pyuspto-0.5.2/docs/source/api/clients/oa_citations.rst

@@ -0,0 +1,7 @@
+OA Citations Client
+===================
+
+.. automodule:: pyUSPTO.clients.oa_citations
+   :members:
+   :undoc-members:
+   :show-inheritance:

pyuspto-0.5.2/docs/source/api/clients/oa_rejections.rst

@@ -0,0 +1,7 @@
+Office Action Rejections Client
+===============================
+
+.. automodule:: pyUSPTO.clients.oa_rejections
+   :members:
+   :undoc-members:
+   :show-inheritance: