Skip to content

Google Patents

Overview

Method Endpoint Version Description
POST /api/v1/open/search v1 Google Search API endpoint for retrieving search results

Request Headers

Header Type Required Description
Content-Type string Yes Must be set to application/json
Accept string No Response format (defaults to application/json)

Authentication

API Key Authentication

  • Pass the API key as a request parameter: api_key=your_api_key
  • Example: "api_key": "your_api_key_here"

HTTP Status Codes

Code Status Description Retry
200 OK Request successful No

Response Codes

Code Description Retry
200 Request successful No
400100 Unsupported search engine No
400200 The search service is temporarily unavailable. Please try again later No
400300 ForUserQuery contains prohibited content No
400400 No results found, please adjust keywords and try again No
400500 Authorization failed, please check your API credentials No
400600 The request frequency is too high, please try again later No
400700 You have reached the daily search limit No
400710 Insufficient Balance No

Request Example

1
2
3
4
5
6
7
8
curl -X POST "https://domain/api/v1/open/search" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "coffee",
    "engine": "google_patents",
    "html": "0",
    "api_key": "your_api_key_here"
}'

Request Parameters

Parameter Type Required Description Default
api_key string Yes API key for authentication
engine string Yes Search engine type, currently engine value is google_patents google
q string Yes Search query, supports regular Google search syntax (like inurl:, site:, intitle:) and advanced search parameters
country string No Parameter filters patent results by countries. Split multiple country codes with , (comma). List of supported country codes. Example:WO,US.
language string No Parameter filters patent results by languages. Split multiple languages with , (comma). List of supported values are: ENGLISH, GERMAN, CHINESE, FRENCH, SPANISH, ARABIC, JAPANESE, KOREAN, PORTUGUESE, RUSSIAN, ITALIAN, DUTCH, SWEDISH, FINNISH, NORWEGIAN, DANISH. Example:ENGLISH,GERMAN.
date string No Time range filter: h-last hour, d-last day, w-last week, m-last month, y-last year
page number No Parameter defines the page number. It's used for pagination. (e.g., 0 (default) is the first page of results, 1 is the 2nd page of results, etc.).
num number No Parameter defines the maximum number of results to return. (e.g., 10 (default) returns 10 results, 40 returns 40 results, and 100 returns 100 results).
before string No Parameter defines the maximum date of the results. The format of this field is type:YYYYMMDD. type can be one of priority, filing, and publication. Example: - priority:20231231, - publication:20250101
after string No Parameter defines the minimum date of the results. The format of this field is type:YYYYMMDD. type can be one of priority, filing, and publication. Example: - priority:20231231, - publication:20250101
status string No Parameter filters patent results by status. List of supported values are: GRANT - Grant, APPLICATION - Application
type string No Parameter filters patent results by type. List of supported values are: PATENT - Patent, DESIGN - Design
litigation string No Parameter filters patent results by litigation status. List of supported values are: YES - Has Related Litigation, NO - No Known Litigation
inventor string No Parameter defines the inventors of the patents. Split multiple inventors with , (comma)
assignee string No Parameter defines the assignees of the patents. Split multiple assignees with , (comma)
sort string No Parameter defines the sorting method. By default, the results are sorted by Relevance. List of supported values are: new - Newest, old - Oldest, Patent results are sorted by filing_date while scholar results are sorted by publication_date for new and old values
clustered string No Parameter defines how the results should be grouped. List of supported values are: true - Classification
dups string No Parameter defines the method of deduplication. Either Family (default) or Publication. List of supported values are: language - Publication
patents string No Parameter controls whether or not to include Google Patents results. (Defaults to true) true
scholar string No Parameter controls whether or not to include Google Scholar results. (Defaults to false) false
html string No Whether to return HTML format, 1-yes, 0-no 0

Response Example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
{
    "code": 200,
    "data": {
        "search_metadata": {
            "raw_html_file": "oss_html",
            "total_time_taken": 2.032416469,
            "id": "1985902431212408832",
            "json_endpoint": "oss_json",
            "created_at": "2025-10-29 08:53:31",
            "processed_at": "2025-10-29 08:53:33",
            "google_url": "https://patents.google.com/xhr/query?url=q%3Dcoffee%26num%3D10",
            "status": "Success"
        },
        "search_information": {
            "organic_results_state": "",
            "page_number": 1,
            "time_taken_displayed": 0.63,
            "total_results": "",
            "total_pages": 100
        },
        "search_parameters": {
            "engine": "google_patents",
            "html": "0",
            "google_domain": "patents.google.com",
            "q": "coffee",
            "tbm": "pts"
        },
        "organic_results": [
            {
                "position": 1,
                "title": "Single serve brewing machine",
                "snippet": "136 and/or dispenser nozzles to accommodate higher throughput needs and/or to reduc",
                "patent_id": "patent/US10405690B2/en",
                "patent_link": "https://patents.google.com/patent/US10405690B2/en",
                "priority_date": "2014-06-19",
                "filing_date": "2015-04-21",
                "grant_date": "2019-09-10",
                "publication_date": "2019-09-10",
                "inventor": "Massimo Tentorio",
                "assignee": "Massimo Tentorio",
                "publication_number": "US10405690B2",
                "language": "en",
                "pdf": "5c/c6/6c/ea5952be6ba227/US10405690.pdf",
                "figures": [
                    {
                        "thumbnail": "4d/af/b4/7eaa2071298a4b/US10405690-20190910-D00000.png",
                        "full": "1c/a1/df/33b6ad145fd9f5/US10405690-20190910-D00000.png"
                    }
                ],
                "country_status": {
                  "EP": "ACTIVE",
                  "US": "ACTIVE",
               }
            }
        ],
        "pagination": {
            "current": 1,
            "next": "https://www.google.com/search?q=coffee&sca_esv=552fb68e3d08662a&gl=us&hl=en&tbm=nws&ei=OU7vaObMlsCU4-EP1quP2Qw&start=10&sa=N&ved=2ahUKEwimzfea2KWQAxVAyjgGHdbVI8sQ8NMDegQIBhAW"
        },
        "summary": {
            "assignee": [
                {
                    "key": "Total",
                    "percentage": 100,
                    "frequency": [
                        {
                            "year_range": "2025-2028",
                            "percentage": 0.2
                        }
                    ]
                }
            ]
        }
    },
    "msg": "string",
    "reqId": "string"
}

Complete Response Parameters Overview

search_metadata

object Contains metadata about the search execution

Parameter Type Description Applicable Terminal
id string Unique identifier for the search request
json_endpoint string Provide an interface endpoint for searching related JSON data, through which JSON-formatted search data can be obtained
created_at string The timestamp when the search request was created, recording the time when the search was initiated
processed_at string The timestamp when the search results were processed and became available for return, recording the time point from processing to completion of the search
google_url string The Google search URL, which contains the search keyword "coffee" along with language parameters (hl=en for English), regional parameters (gl=us for the United States), and other search parameters, used to redirect to the corresponding Google search page
status string Status of the search execution (e.g., Success)
raw_html_file string Identifier for the original HTML file
total_time_taken number The total time spent on the entire search process (including request sending, result parsing, and other stages)

search_information

object Contains information about the search results

Parameter Type Description Applicable Terminal
organic_results_state string State of organic results
page_number number Current page number (indicating the current pagination index of the search results, used for browsing search results by pages)
time_taken_displayed number TDisplay time (i.e., the time spent on displaying the search results)
total_results string Total results count (the total number of results returned by this search)
total_pages number Total number of search result pages

search_parameters

object Contains the parameters used for the search

Parameter Type Description Applicable Terminal
q string Keywords used for this query
engine string Search engine used for this query (e.g., google_web)
html string When HTML=0, returns JSON; when HTML=1, returns HTML; when HTML=2, returns both JSON and HTML
google_domain string Specifies the corresponding Google domain (e.g., google.com, etc., used to distinguish Google services in different regions/locales)
tbm string pts

organic_results

object[] Google Patents Search aggregates global patent documents and patent information (such as patent texts, legal status, etc.).

Parameter Type Description Applicable Terminal
position number The patent's ranking position in the search results.
title string Patent title
snippet string Excerpt from the patent abstract
patent_id string Patent unique identifier
patent_link string Patent page URL (direct link to Google Patents details page)
priority_date string Priority date
filing_date string Filing date
grant_date string Grant date
publication_date string ‌Publication date
inventor string Inventor(s)
assignee string Assignee(s)
publication_number string Publication number
language string ‌Language of patent document
figures object[] Patent drawing information set
figures[].thumbnail string Drawing thumbnail resource path (for preview)
figures[].full string Drawing full-version resource path (for high-resolution viewing)
country_status object Patent legal status by jurisdiction

pagination

object (Pagination) related fields used to describe pagination navigation information for search results

Parameter Type Description Applicable Terminal
current number Current page number
next string Next page navigation link (can directly jump to the next page of search results)

summary

object (Pagination) related fields used to describe pagination navigation information for search results

Parameter Type Description Applicable Terminal
assignee object[] List of patentee-related statistical items, where each object in the array corresponds to statistics for a specific type of patentee (or aggregated dimension)
assignee[].key string Classification identifier for statistical items
assignee[].percentage number Percentage proportion of statistical items
assignee[].frequency object[] Temporal distribution / frequency list under statistical items, with each object in the array corresponding to statistics for a year interval
assignee[].frequency[].year_range string Patent statistics year coverage
assignee[].frequency[].percentage number Proportion within statistical items for a given year interval