Google Patents API Documentation

Search Query

Name

q

Required

Required

Description

Parameter defines the query you want to search. You can use anything that you would use in a regular Google Patents search. e.g. AND, OR. For example (ChatGPT OR GPT-4).
For multiple queries, split them with semicolon ;. For example: ChatGPT;GPT-4.
For more advanced syntax, refer to the official Google documentation on Google Patents search query syntax.

Localization

Name

countries

Required

Optional

Description

Parameter filters results by country. Use the ISO 3166-1 alpha-2 country code, e.g., US for the United States, DE for Germany. To use multiple countries, separate them with a comma ,. For example: US,DE. Check the full list of supported Google Patents countries.
Name

language

Required

Optional

Description

Parameter filters results by language. To specify multiple languages, separate them with a comma ,. For example: SWEDISH,ITALIAN
Supported languages include: ARABIC, CHINESE, DANISH, DUTCH, ENGLISH, FINNISH, FRENCH, GERMAN, ITALIAN, JAPANESE, KOREAN, NORWEGIAN, PORTUGUESE, RUSSIAN, SPANISH, SWEDISH.

Filters

Name

patent_status

Required

Optional

Description

Parameter filters patent results by status. Use GRANT for granted patents and APPLICATION for patent applications.
Name

patent_type

Required

Optional

Description

Parameter filters patent results by type. Use PATENT for patents, DESIGN for design patents.
Name

litigation

Required

Optional

Description

Parameter filterss patent results by litigation status. Use YES to include results with related litigation, NO to exclude them.
Name

clustered

Required

Optional

Description

Parameter groups the results by classification. Set the value to true to enable clustering.
Name

dups

Required

Optional

Description

arameter defines how duplicates are handled. The default value is family. Alternatively, use language to filter duplicates based on publication.
Name

sort

Required

Optional

Description
Parameter controls the sorting order. The default is relevance. Other options include:
- new - Sort by filing date for patents, and by publication date for scholarly results.
- old - Sort by filing date for patents, and by publication date for scholarly results, in ascending order.
Name

patents

Required

Optional

Description

Parameter controls the inclusion of patent results. Set to false to exclude patents. Default value is true.
Name

scholar

Required

Optional

Description

Parameter controls the inclusion of scholarly results. Set to true to include scholarly results. Default value is false.
Name

inventor

Required

Optional

Description

Parameter filters results by inventor names. To specify multiple inventors, separate them with a comma ,. For example: John Doe,Jane Doe.
Name

assignee

Required

Optional

Description

Parameter filters results by assignee names. To specify multiple assignees, separate them with a comma ,. For example: Apple Inc,Google LLC.
Name

before

Required

Optional

Description

Parameter restricts results to those published before a specific date. The date must be in the format YYYYMMDD. You can specify a type of date by prefixing it, e.g., publication:20220101.
Supported date types include: priority, filing, publication.
Name

after

Required

Optional

Description

Parameter restricts results to those published after a specific date. The date must be in the format YYYYMMDD. You can specify a type of date by prefixing it, e.g., publication:20220101.
Supported date types include: priority, filing, publication.

Pagination

Name

num

Required

Optional

Description

This parameter specifies the number of results to display per page. By default, it is set to 10. Use in combination with the page parameter to implement pagination functionality. Max num per page is 100, min - 10.
Name

page

Required

Optional

Description

This parameter indicates which page of results to return. By default, it is set to 1. Use in combination with the num parameter to implement pagination.

Engine

Name

engine

Required

Required

Description

Parameter defines an engine that will be used to retrieve real-time data. It must be set to google_patents.

API key

Name

api_key

Required

Required

Description

The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Full Response

GET

https://www.searchapi.io/api/v1/search?engine=google_patents&q=ChatGPT

Request

import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_patents",
  "q": "ChatGPT"
}

response = requests.get(url, params = params)
print(response.text)

Response

{
  "search_metadata": {
    "id": "search_YzO8NlMJg5M9UVvgnBvQxXR0",
    "status": "Success",
    "created_at": "2024-02-23T00:26:31Z",
    "request_time_taken": 1.72,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.73,
    "request_url": "https://patents.google.com/xhr/query?url=q%3DChatGPT",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_YzO8NlMJg5M9UVvgnBvQxXR0.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_YzO8NlMJg5M9UVvgnBvQxXR0"
  },
  "search_parameters": {
    "engine": "google_patents",
    "q": "ChatGPT"
  },
  "search_information": {
    "total_results": 3164,
    "total_pages": 100,
    "page_number": 1
  },
  "organic_results": [
    {
      "position": 1,
      "rank": 0,
      "patent_id": "patent/CN116977558A/en",
      "title": "Three-dimensional model updating method and device, computer equipment and &hellip;",
      "snippet": "The corresponding three-dimensional model is generated according to modeling requirements, so that the three-dimensional model participates in an actual design process, a BIM engineer can automatically generate the three-dimensional model only by proposing requirements, the ChatGPT model provides &hellip;",
      "priority_date": "2023-07-28",
      "filing_date": "2023-07-28",
      "publication_date": "2023-10-31",
      "inventor": "于琦",
      "assignee": "中国长江三峡集团有限公司",
      "publication_number": "CN116977558A",
      "language": "en",
      "pdf": "https://patentimages.storage.googleapis.com/11/3b/de/361e9da6df164a/CN116977558A.pdf",
      "country_status": {
        "CN": "ACTIVE"
      }
    },
    {
      "position": 2,
      "rank": 1,
      "patent_id": "patent/US20240003950A1/en",
      "title": "Detection of electric discharges that precede fires in electrical wiring",
      "snippet": "Described herein are methods and systems for detecting electrical discharges that precede electrical fires in electrical wiring. One or more sensor devices coupled to a circuit detect one or more signal waveforms generated by electrical activity on the circuit. The sensor devices identify one or &hellip;",
      "priority_date": "2018-03-20",
      "filing_date": "2023-08-29",
      "publication_date": "2024-01-04",
      "inventor": "Robert S. Marshall",
      "assignee": "Whisker Labs, Inc.",
      "publication_number": "US20240003950A1",
      "language": "en",
      "thumbnail": "https://patentimages.storage.googleapis.com/df/88/ef/7500fc07591c38/US20240003950A1-20240104-D00000.png",
      "pdf": "https://patentimages.storage.googleapis.com/0c/14/1b/80f31b38ad86fa/US20240003950A1.pdf",
      "figures": [
        {
          "thumbnail": "https://patentimages.storage.googleapis.com/37/5f/72/1150b590ca8463/US20240003950A1-20240104-D00000.png",
          "full": "https://patentimages.storage.googleapis.com/9f/0d/59/87c816ec5c41f9/US20240003950A1-20240104-D00000.png"
        },
        ...
      ],
      "country_status": {
        "WO": "UNKNOWN",
        "EP": "ACTIVE",
        ...
      }
    },
    ...
  ],
  "summary": {
    "assignee": [
      {
        "key": "Total",
        "percentage": 100,
        "frequency": [
          {
            "year_range": "2022-2025",
            "percentage": 99.8
          }
        ]
      },
    ],
    "inventor": [
      {
        "key": "Total",
        "percentage": 100,
        "frequency": [
          {
            "year_range": "2022-2025",
            "percentage": 99.8
          }
        ]
      },
      ...
    ]
  },
  "pagination": {
    "current": 1,
    "next": "https://patents.google.com/xhr/query?url=q%3DChatGPT%26page%3D2"
  }
}

Organic Results

Development tips:

The Cooperative Patent Classification (CPC) and its description are returned only when the parameter clustered=true is used.

GET

https://www.searchapi.io/api/v1/search?engine=google_patents&q=%28Rocket+science%29%3B%28Space%29

Request

import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_patents",
  "q": "(Rocket science);(Space)"
}

response = requests.get(url, params = params)
print(response.text)

Response

{
  "organic_results": [
    {
      "position": 2,
      "rank": 1,
      "patent_id": "patent/US10963735B2/en",
      "title": "Methods for object recognition and related arrangements",
      "snippet": "that further includes, after said estimating act, comparing profile information derived from the query data with profile information corresponding to objects in said subset of candidate 3D objects, to identify a further-reduced search space of candidate 3D reference objects to which the query data &hellip;",
      "priority_date": "2013-04-11",
      "filing_date": "2018-06-01",
      "grant_date": "2021-03-30",
      "publication_date": "2021-03-30",
      "inventor": "Geoffrey B. Rhoads",
      "assignee": "Digimarc Corporation",
      "publication_number": "US10963735B2",
      "language": "en",
      "thumbnail": "https://patentimages.storage.googleapis.com/13/96/5b/88da3b7d215dbd/US10963735-20210330-D00000.png",
      "pdf": "https://patentimages.storage.googleapis.com/f6/a8/dd/cc854f61ca7c1e/US10963735.pdf",
      "figures": [
        {
          "thumbnail": "https://patentimages.storage.googleapis.com/d4/82/8a/6c70b2dec3bbff/US10963735-20210330-D00000.png",
          "full": "https://patentimages.storage.googleapis.com/8c/aa/d4/34c4a5af8d287b/US10963735-20210330-D00000.png"
        },
        ...
      ],
      "country_status": {
        "WO": "ACTIVE",
        "US": "ACTIVE"
      }
    }
    ...
  ]
}

Summary

GET

https://www.searchapi.io/api/v1/search?engine=google_patents&q=Rocket+Science

Request

import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_patents",
  "q": "Rocket Science"
}

response = requests.get(url, params = params)
print(response.text)

Response

{
  "summary": {
    "assignee": [
      {
        "key": "Total",
        "percentage": 100,
        "frequency": [
          {
            "year_range": "2022-2025",
            "percentage": 4.6
          },
          ...
        ]
      },
      {
        "key": "C4Cast.Com, Inc.",
        "percentage": 0.4,
        "frequency": [
          {
            "year_range": "2013-2016",
            "percentage": 0.1
          },
          ...
        ]
      },
      {
        "key": "Aerojet-General Corporation",
        "percentage": 0.1,
        "frequency": [
          {
            "year_range": "2007-2010",
            "percentage": 0.1
          },
          ...
        ]
      },
      ...
    ],
    "inventor": [
      {
        "key": "Total",
        "percentage": 100,
        "frequency": [
          {
            "year_range": "2022-2025",
            "percentage": 4.6
          },
          ...
        ]
      },
      {
        "key": "m harmata",
        "percentage": 2.5,
        "frequency": [
          {
            "year_range": "2019-2022",
            "percentage": 2.9
          }
        ]
      },
      ...
    ],
    "cpc": [
      {
        "key": "Total",
        "percentage": 100,
        "frequency": [
          {
            "year_range": "2022-2025",
            "percentage": 4.6
          },
          ...
        ]
      },
      {
        "key": "G06Q",
        "percentage": 42.7,
        "frequency": [
          {
            "year_range": "2022-2025",
            "percentage": 1.4
          },
          ...
        ]
      },
      ...
    ]
  }
}

Google Patents API Documentation

API Parameters

Search Query

Localization

Filters

Engine

API key

API Examples

Full Response

Organic Results

Summary