scientific-skills/database-lookup/references/uspto.md
The newer Elasticsearch-based API is the recommended endpoint.
https://search.patentsview.org/api/v1/
API key required — register at https://patentsview.org/apis/keyrequest
Pass as query parameter: ?api_key=YOUR_KEY
GET or POST /patent/
Query parameter q accepts a JSON query object.
Operators: _eq, _neq, _gt, _gte, _lt, _lte, _begins, _contains, _text_any, _text_all, _text_phrase, _and, _or, _not
Parameters:
q — JSON queryf — fields to return (JSON array)o — options: {"size": 25} for paginations — sort: [{"patent_date": "desc"}]GET /patent/?q={"_text_any":{"patent_abstract":"autonomous vehicle"}}&f=["patent_id","patent_title","patent_date"]&o={"size":5}&api_key=KEY
GET /patent/?q={"inventors.inventor_name_last":"Tesla"}&f=["patent_id","patent_title","patent_date"]&api_key=KEY
GET /patent/?q={"assignees.assignee_organization":"Google LLC"}&f=["patent_id","patent_title","patent_date","assignees"]&api_key=KEY
GET /patent/{patent_number}/?api_key=KEY
/inventor/
/assignee/
/cpc_group/
{
"patents": [
{
"patent_id": "11234567",
"patent_title": "...",
"patent_date": "2022-03-15",
"patent_abstract": "...",
"assignees": [{"assignee_organization": "..."}],
"inventors": [{"inventor_name_first": "...", "inventor_name_last": "..."}]
}
],
"count": 1,
"total_hits": 8923
}
~45 requests per minute per API key.
The user must have a PatentsView API key for this endpoint. If they don't have one, let them know they need to register at https://patentsview.org/apis/keyrequest. Load the key from .env as PATENTSVIEW_API_KEY.
Note: The legacy API at api.patentsview.org has been decommissioned (returns 410 Gone). Only the new API above works.
URL: https://ped.uspto.gov/api/queries
Method: POST
For patent prosecution data (application status, filing dates, examiner info).
{
"searchText": "applicationNumberText:16123456",
"fl": "*",
"mm": "100%",
"df": "patentTitle",
"facet": "false",
"sort": "applId asc",
"start": 0
}
No API key required but heavily rate limited. Availability can be unreliable.
For trademark lookup by serial or registration number (not full-text search).
GET https://tsdr.uspto.gov/documentxml/status/{serial_number}
GET https://tsdr.uspto.gov/documentxml/status/rn{registration_number}
Returns XML with mark details, status, owner, goods/services, prosecution history.
No API key. Rate limited. No JSON endpoint — responses are XML.