Endpoint Playground
Searches USPTO Patent Public Search's full-text index of granted patents and published applications, returning bibliographic results (title, applicant/assignee, inventors, filing and publication dates, application number, IPC/CPC classifications, page count). q accepts USPTO's full Advanced Search query syntax -- field-specific search (e.g. battery.ti., Microsoft.as.), date ranges (@pd>=20200101<=20241231), boolean and proximity operators, and wildcards -- see the markdown doc for the full field-code table and syntax reference.
14 Oct 2026: 20 results; 14 fields had a value in every checked item and 1 varied between items.
Sample value profiles: filing_date: 2022-01-13 to 2024-02-08; publication_number: “US12761285B1” and 19 other values; title: median 60 characters.
curl 'https://api.crawlora.net/api/v1/usptoppubs/search?q=battery' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | Yes | battery | Search query text -- accepts USPTO's full Advanced Search (BRS) query syntax: field codes, date ranges, boolean/proximity operators, wildcards |
| databases | string | No | Comma-separated subset of databases to search. Allowed values: US-PGPUB, USPAT, USOCR. Defaults to all three | |
| num | integer | No | Results to return, default 20, max 100 | |
| page | integer | No | Results page, 0-indexed, default 0 |
{
"code": 200,
"msg": "OK",
"data": {
"query": "battery",
"num_found": 500,
"per_page": 20,
"page": 0,
"results": [
{
"publication_number": "US10758101B2",
"guid": "US-10758101-B2",
"title": "UPRIGHT VACUUM CLEANER WITH BATTERY SUPPORT PLATE",
"database": "USPAT",
"applicant_names": [
"Emerson Electric Co."
],
"assignee_name": "Emerson Electric Co.",
"inventors_short": "Fogarty; Thomas E. et al.",
"application_number": "15/620,213",
"filing_date": "2017-06-12T00:00:00Z",
"publication_date": "2020-09-01T00:00:00Z",
"ipc_codes": "A47L9/00",
"kind_codes": [
"B2"
],
"page_count": 15,
"language": "EN"
}
],
"source_url": "https://ppubs.uspto.gov/api/searches/searchWithBeFamily",
"fetched_at": "2026-08-15T19:00:00Z"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.