Goole Patents

SERP API Google Query Parameters

Configure Google search queries using Thordata’s SERP API, including Date Range parameters, Participants, pagination, and "advanced parameter" output options.

q ,Search Query(Required)

Define the search query used for data scraping (Default value: q=pizza). Any keywords in any language are supported.

Example Request: Example using the parameter q: pizza

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1"

Date Range

before,Date before(Optional)

The parameter limits the latest date of the results. The format of this field is "type:YYYYMMDD", where type can be priority date (priority), application date (filing), or publication date (publication).

Example:

priority:20241231

filing:20250615

publication:20250101

Example Request:

Example results for q : pizza ,before:priority:20241231

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "before=priority:20241231"

after ,Date after(Optional)

The number is used to limit the results to the earliest date. The format of this field is "type:YYYYMMDD", where type can be priority date (priority), application date (filing), or publication date (publication).

Example:

priority:20241231

filing:20250615

publication:20250101

Example Request:

Example results for q : pizza,after: filing:20250615

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "after=filing:20250615"

Participants

inventor,Inventors(Optional)

The parameter defines the inventor of the patent. Multiple inventors are separated by commas using ,.

Example Request:

Example results for q : pizza,location:India,inventor:A,B

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "inventor=A,B" \
 -d "assignee=A,B"

assignee ,Assignees(Optional)

The parameter defines the assignee of the patent. Multiple assignees are separated by commas using ,.

Example Request:

Example results for q : pizza,location:India,assignee:A,B

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "inventor=A,B" \
 -d "assignee=A,B"

Pagination

page ,Page number(Optional)

Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.).

Example Request:

Example results for q : pizza,page:30

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "page=30"

num ,Results per page(Optional)

This parameter defines the maximum number of results returned per page in the search results. For example, setting it to 10 means 10 results will be returned.

Example Request:

Example results for q : pizza,num:20

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "num=20"

Advanced Parameters

sort,Sort By(Optional)

Parameter defines the sorting method. By default, the results are sorted by Relevance. List of supported values are: new - Newest old - Oldest

Example Request:

Example results for q : pizza,sort:new

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "sort=new"

clustered ,Group by(Optional)

Parameter defines how the results should be grouped. List of supported values are: true - Classification

Example Request:

Example results for q : pizza,clustered:ture

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "clustered=ture"

dups ,Deduplicate by(Optional)

Parameter defines the method of deduplication. Either Family (default) or Publication. List of supported values are: language - Publication

Code Example:

Example results for q : pizza,dups:language

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "dups=language"

patents ,Include Patents results(Optional)

This parameter controls whether to include Google Patents search results. (Default is true)

Code Example:

Example results for q : pizza,patents:ture

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "patents=ture"

scholar,Include Scholar results(Optional)

Parameter controls whether or not to include Google Scholar results. (Defaults to false)

Code Example:

Example results for q : pizza,scholar:ture

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer bb33aa0ec81de3fef7a61e9dddec973e" \
 -d "engine=google_patents" \
 -d "q=pizza" \
 -d "json=1" \
 -d "scholar=ture"

For further assistance, contact us at [email protected].