JustSERPDocs
Google

Google Patents

Google Patents search (patents and, with `scholar`, scholarly articles), answered as the document: `search_metadata`, `search_parameters`, `search_information` (`total_results`, `total_pages`, `page_number`), `organic_results`, `summary` (assignee, inventor and CPC shares) and `pagination` (`current`, `next`).

GET
/v1/google/patents

Google Patents search (patents and, with scholar, scholarly articles), answered as the document: search_metadata, search_parameters, search_information (total_results, total_pages, page_number), organic_results, summary (assignee, inventor and CPC shares) and pagination (current, next). The thumbnail, pdf and figures addresses are the site's relative paths on patentimages.storage.googleapis.com, not all of which resolve. No snapshot.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
q?string

Terms; several queries split with ;.

countries?string

Two-letter ISO codes, comma-separated.

language?string

ENGLISH, GERMAN ..., comma-separated.

patent_status?string
Value in"GRANT""APPLICATION"
patent_type?string
Value in"PATENT""DESIGN"
litigation?string
Value in"YES""NO"
clustered?boolean

Group results by CPC class (cpc, cpc_description on each result).

Defaultfalse
dups?string
Default"family"
Value in"family""language"
sort?string
Default"relevance"
Value in"relevance""new""old"
patents?boolean

false leaves out patents.

Defaulttrue
scholar?boolean

true adds scholarly results.

Defaultfalse
inventor?string

Names, comma-separated.

assignee?string

Names, comma-separated.

before?string

YYYYMMDD, optionally prefixed priority:, filing: or publication:.

after?string

YYYYMMDD, optionally prefixed priority:, filing: or publication:.

num?integer

Results a page.

Range10 <= value <= 100
Default10
page?integer
Range1 <= value
Default1

Response Body

The results, as the document. When the answer could not be parsed, the usual envelope.

application/json
  1. response

The Patents document.

search_metadata?
search_parameters?

The request as sent.

search_information?
organic_results?array<>

A patent or, with scholar, a scholarly article (author, publication_venue, publication_date, source).

summary?
pagination?
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/patents?q=ChatGPT'
Example Response
{  "search_metadata": {    "id": "string",    "status": "string",    "created_at": "string",    "request_url": "string"  },  "search_parameters": {},  "search_information": {    "total_results": 0,    "total_pages": 0,    "page_number": 0  },  "organic_results": [    {      "position": 0,      "rank": 0,      "patent_id": "string",      "title": "string",      "snippet": "string",      "priority_date": "string",      "filing_date": "string",      "grant_date": "string",      "publication_date": "string",      "inventor": "string",      "assignee": "string",      "publication_number": "string",      "language": "string",      "thumbnail": "string",      "pdf": "string",      "figures": [        {}      ],      "country_status": {},      "cpc": "string",      "cpc_description": "string",      "author": "string",      "publication_venue": "string",      "source": "string"    }  ],  "summary": {    "assignee": [      {        "key": "string",        "percentage": 0,        "frequency": [          {            "year_range": "string",            "percentage": 0          }        ]      }    ],    "inventor": [      {        "key": "string",        "percentage": 0,        "frequency": [          {            "year_range": "string",            "percentage": 0          }        ]      }    ],    "cpc": [      {        "key": "string",        "percentage": 0,        "frequency": [          {            "year_range": "string",            "percentage": 0          }        ]      }    ]  },  "pagination": {    "current": 0,    "next": "string"  }}

Google About This Domain GET

What Google says about a site: the "About the source" panel of a result's "About this result" menu.

Google Patents Details GET

One patent or scholarly article of Google Patents by `patent_id`, answered as the document: `search_metadata`, `search_parameters`, `search_information` and the record's fields at the top level (title, type, pdf, publication_number, country, inventors, assignees, dates, legal_status, classifications, abstract, description, claims, patent_citations, cited_by, similar_documents, legal_events ...; a scholarly article has publication_year, publication_venue, authors, snippet and its links).