Skip to main content
POST /v1/data/google-patents/patents/run Pricing: $0.01 per patent ($10.50 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
required
Search Query.
string
Assignee.
date
Date From as a date (YYYY-MM-DD).
date
Date To as a date (YYYY-MM-DD).
string
default:"publication"
Date Type to use. Publication Date by default.Allowed values: priority (Priority Date), filing (Filing Date), publication (Publication Date).
string
Patent office to search, picked by name (stored as its two-letter office code). Leave empty to search every office. Example: United States (US), European Patent Office (EP), Japan (JP).40 allowed values, for example AR (Argentina), AU (Australia), AT (Austria), BE (Belgium), BR (Brazil), CA (Canada), CN (China), CZ (Czech Republic), DK (Denmark), EP (European Patent Office). Fetch the full list with GET /v1/data/google-patents/patents?expand=options.
string
default:"ANY"
Status to use. Any by default.Allowed values: ANY (Any), GRANT (Granted only), APPLICATION (Applications only).
string
default:"relevance"
Sort By to use. Relevance by default.Allowed values: relevance (Relevance), new (Newest first), old (Oldest first).
integer
default:"100"
How many patents to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one patent, keyed by these fields.

Example response

Abridged: long text and lists are shortened.