USPTO Patent Public Search

Search USPTO's own patent full-text search index

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.

get/usptoppubs/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/usptoppubs/search
  • Auth: API key in header x-api-key

Query parameters

qstring required

Search query text -- accepts USPTO's full Advanced Search (BRS) query syntax: field codes, date ranges, boolean/proximity operators, wildcards

databasesstring

Comma-separated subset of databases to search. Allowed values: US-PGPUB, USPAT, USOCR. Defaults to all three

numinteger

Results to return, default 20, max 100

pageinteger

Results page, 0-indexed, default 0

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "num_found": 500,
    "per_page": 20,
    "query": "battery",
    "results": [
      {
        "application_number": "15/620,213",
        "database": "USPAT",
        "filing_date": "2017-06-12",
        "guid": "US-10758101-B2",
        "language": "EN",
        "publication_date": "2020-09-01",
        "publication_number": "US10758101B2",
        "title": "UPRIGHT VACUUM CLEANER WITH BATTERY SUPPORT PLATE"
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.