USPTO API - Patent & Trademark Data
Pricing
from $0.01 / 1,000 results
USPTO API - Patent & Trademark Data
USPTO patent data from the USPTO Open Data Portal using your own free USPTO API key (USPTO.gov account plus ID.me). Search applications and granted patents by keyword, assignee, or inventor, or look up one patent. Without a key, live runs return a notice and charge nothing.
Pricing
from $0.01 / 1,000 results
Rating
0.0
(0)
Developer
The Howlers
Maintained by CommunityActor stats
0
Bookmarked
65
Total users
1
Monthly active users
4 days ago
Last modified
Categories
Share
USPTO patent data from the USPTO Open Data Portal, using your own free USPTO API key. Search patent applications and granted patents by keyword, assignee, or inventor, or look up one patent by patent or application number.
You need your own USPTO API key (free)
USPTO serves patent data only through its Open Data Portal (ODP), and every ODP request needs an API key tied to a verified USPTO.gov account. This actor uses your key; it does not include one.
- Create a free USPTO.gov account at account.uspto.gov.
- Verify your identity with ID.me when the portal asks (a one-time step USPTO requires for API keys).
- Sign in at data.uspto.gov, open My ODP, and copy your API key.
- Paste it into the
usptoApiKeyinput (stored as a secret).
Without a key: Demo Mode (the default) returns built-in sample data. A live run without a key finishes successfully with one informational row (needsApiKey: true) explaining how to get a key, and charges nothing beyond the Actor start fee.
Quick Start
Test with Demo Mode (free, no API key needed)
{"demoMode": true}
Live search with your key
{"demoMode": false,"usptoApiKey": "YOUR_USPTO_ODP_KEY","task": "search_patents","searchQuery": "solid state battery","limit": 10}
Tasks
| Task | Input | Returns |
|---|---|---|
search_patents | searchQuery (optional cpcClass, dateFrom, dateTo) | Matching application records, including granted patents |
get_patent | patentNumber or applicationNumber | One application record |
search_by_assignee | assignee | Records where the company is the first applicant or an assignee |
search_by_inventor | inventor | Records naming the inventor |
get_patent_claims, get_citations | - | Not available: the ODP file-wrapper API has no claims text or citation list. Returns a notice, not charged |
search_trademarks, get_trademark | - | Built-in sample data only (isSample: true), never charged |
Each patent record has: applicationNumber, patentNumber (when granted), title, status, filingDate, grantDate, publicationNumber, applicationType, firstApplicant, firstInventor, inventors, applicants, cpcClasses, groupArtUnit, examiner, and a link to the record on data.uspto.gov. ODP covers applications filed in 2001 and later. limit is 1 to 100 per run.
Input Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
task | string | "search_patents" | The operation to perform |
usptoApiKey | string (secret) | - | Your USPTO Open Data Portal API key (required for live patent data) |
searchQuery | string | - | Keywords, or ODP query syntax such as applicationMetaData.inventionTitle:battery |
patentNumber | string | - | Granted patent number, for example US10123456B2 |
applicationNumber | string | - | Application number, for example 16123456 |
assignee | string | - | Applicant or assignee company name |
inventor | string | - | Inventor name |
cpcClass | string | - | CPC classification filter for search_patents |
dateFrom / dateTo | string | - | Filing date range (YYYY-MM-DD) |
limit | integer | 25 | Records per run (1 to 100) |
webhookUrl | string | - | URL to receive results |
demoMode | boolean | true | Return built-in sample data instead of calling USPTO |
Pricing
Each successful live call that returns at least one USPTO record charges one event named after the task (prices on the Pricing tab), plus the standard Actor start fee. Not charged: Demo Mode, runs without a key, rejected keys, errors, empty results, the claims and citations notices, and the trademark sample tasks.
Troubleshooting
"USPTO Open Data Portal rejected the API key"
Copy the key again from data.uspto.gov (My ODP). Keys are tied to a verified USPTO.gov account.
"rate limit reached (429)"
USPTO limits requests per key. Wait a minute and run again.
No results
Try fewer or broader keywords, or check the spelling of the company or inventor name.
Built by John Rippy | Actor Arsenal