Skip to main content
POST
Search Google Patents by words, inventor, assignee, office, dates and status
Searches Google Patents by words, inventor, assignee, office, dates and status.

Request

This method has no required parameters.

Response

If successful, the response body contains the standard envelope. data.results[] contains the patents, each with its owner, inventor, dates and link. The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.

Optional parameters

Billing

Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.

Pagination

Results are paginated. To retrieve the next page, increment page. An empty data.results indicates the last page. The maximum value of page is 100.
  • Google Patents: Accepts an assignee or inventor from results. Searches Google Patents by words, inventor, assignee, office, dates and status.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string
Required string length: 1 - 500
inventor
string
Required string length: 1 - 200
assignee
string
Required string length: 1 - 200
office
string

Google Patents' own Patent office, like US, EP, WO, CN or JP.

Pattern: ^[A-Za-z]{2}$
language
enum<string>
Available options:
english,
german,
chinese,
french,
spanish,
arabic,
japanese,
korean,
portuguese,
russian,
italian,
dutch,
swedish,
finnish,
norwegian,
danish
dateType
enum<string>
default:priority

Which date before and after compare: Google Patents' own date choice.

Available options:
priority,
filing,
publication
after
string<date>
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
before
string<date>
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
status
enum<string>
Available options:
grant,
application
type
enum<string>
Available options:
patent,
design
litigation
enum<string>

Google Patents' own Litigation: has related litigation, or no known.

Available options:
has,
none
sort
enum<string>
default:relevance
Available options:
relevance,
newest,
oldest
page
integer
default:1

Page number, starting at 1.

Required range: 1 <= x <= 100

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required