# Changelog of USPTO Patent + Trademark Scraper - Co-Assignees, Citations (`seibs.co/uspto-patent-intel`) Actor

- **URL**: https://apify.com/seibs.co/uspto-patent-intel/changelog.md
- **Full Actor documentation**: https://apify.com/seibs.co/uspto-patent-intel.md

## Changelog

### 0.5 - 2026-06-13

- Recovered the last two fields - **abstract** and **claims\_count** - from ODP's grant/publication full-text XML (`grantDocumentMetaData.fileLocationURI` -> `PTGRXML-SPLT/.../{app}_{patent}.xml`). patent\_search downloads the full-text XML and parses the abstract + claim count when `include_full_text` is on (off by default; ~1 MB/doc, capped at 10 downloads/run, concurrency 2). Charges the full-text enrichment event ($0.005, the repurposed citation\_enrichment key).
- Only remaining gap: **citation\_analysis** (ODP exposes no forward/backward citation graph). All other modes + fields now return real ODP data.

### 0.4 - 2026-06-13

- Recovered CPC codes + assignees from ODP's per-application detail endpoint (`/patent/applications/{appNum}` -> `cpcClassificationBag`, `applicantBag`). patent\_search now enriches results with CPC + assignees (toggle `include_full_detail`, capped at 40 detail fetches/run for rate safety).
- Re-enabled **co\_assignee\_mapping** (co-applicants on an assignee's patents), **inventor\_mobility** (inventor -> assignee history), and **tech\_cluster\_analysis** (dominant CPC + YoY for an assignee) via applicant/inventor search + per-app enrichment. assignees are now a searchable dimension (applicant-name filter).
- Still NOT available on ODP (documented note, no charge): **citation\_analysis** (no citation graph), plus **abstract** and **claims\_count** (only in downloadable full-text XML, not structured fields).

### 0.3 - 2026-06-13

- Migrated the patent data source from PatentsView to the official **USPTO Open Data Portal (ODP)** API (`api.uspto.gov`, `X-API-KEY`). Key read from the `USPTO_ODP_API_KEY` secret env var.
- Fully supported on ODP: `patent_search`, `family_lookup` (parent/child continuity), `expiration_calendar`, `trademark_search` (keyless TSDR, unchanged).
- Not available on ODP (return a documented note, no charge): `co_assignee_mapping`, `tech_cluster_analysis`, `inventor_mobility`, `citation_analysis` - ODP's search API exposes no assignee, CPC, or citation-graph data.
- Output dataset schema kept stable; `patent_id` now mirrors the ODP application number.

### 0.2 - 2026-05-14

- Added Apify output schema (`.actor/output_schema.json`).
- Added `overview`, `detailed`, and `expiration` dataset views.
- README restructured with Features / Use cases / FAQ / Support.

### 0.1 - Initial release

- Eight modes: patent\_search, trademark\_search, co\_assignee\_mapping, tech\_cluster\_analysis, inventor\_mobility, expiration\_calendar, family\_lookup, citation\_analysis.
- PatentsView + TSDR integration; relational intelligence: co-assignee mapping, inventor mobility, CPC tech-cluster trends, expiration calendar, family / citation graphs.