Skip to main content
POST
/
api
/
google
/
patents
/
patents
/
search
/google/patents/patents/search
curl --request POST \
  --url https://api.anysite.io/api/google/patents/patents/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "query": "<string>",
  "count": 2,
  "timeout": 300,
  "assignee": "<string>",
  "inventor": "<string>",
  "country": [
    "<string>"
  ],
  "language": "<string>",
  "cpc": "<string>",
  "before": "<string>",
  "after": "<string>",
  "before_type": "priority",
  "after_type": "priority",
  "sort": "relevance",
  "dedup": "family",
  "group_by_family": false
}
'
[
  {
    "id": "<string>",
    "@type": "@google_patent_search_result",
    "title": "",
    "snippet": "<string>",
    "inventor": "<string>",
    "assignee": "<string>",
    "priority_date": "<string>",
    "filing_date": "<string>",
    "grant_date": "<string>",
    "publication_date": "<string>",
    "language": "<string>",
    "pdf_url": "<string>",
    "thumbnail": "<string>",
    "web_url": ""
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
query
string
required

Search query

Minimum string length: 1
Examples:

"machine learning"

"solar panel"

​
count
integer
required

Number of patents to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
assignee
string | null

Filter by patent assignee / owner

​
inventor
string | null

Filter by inventor

​
country
string[] | null

Filter by jurisdiction country codes (e.g. US, EP, WO, CN, JP, DE, KR)

​
status
enum<string> | null

Filter by grant status

Available options:
GRANT,
APPLICATION
​
type
enum<string> | null

Filter by document type

Available options:
PATENT,
DESIGN
​
language
string | null

Filter by document language (e.g. ENGLISH, GERMAN, CHINESE)

​
cpc
string | null

Filter by CPC classification code (e.g. G06N)

​
litigation
enum<string> | null

Filter by litigation presence

Available options:
YES,
NO
​
before
string | null

Upper date bound as YYYYMMDD, applied with before_type

Pattern: ^\d{8}$
​
after
string | null

Lower date bound as YYYYMMDD, applied with after_type

Pattern: ^\d{8}$
​
before_type
enum<string>
default:priority

Which date the before bound applies to

Available options:
priority,
filing,
publication
​
after_type
enum<string>
default:priority

Which date the after bound applies to

Available options:
priority,
filing,
publication
​
sort
enum<string>
default:relevance

Result ordering

Available options:
relevance,
new,
old
​
dedup
enum<string>
default:family

Deduplicate results by patent family (one representative per family) or by individual publication

Available options:
family,
publication
​
group_by_family
boolean
default:false

Re-cluster results by patent family upstream so related publications collapse together. Results are always returned as a flat list; the visible effect depends on the matched data.

Response

Successful Response

​
id
string
required
​
@type
string
default:@google_patent_search_result
​
title
string
default:""
​
snippet
string | null
​
inventor
string | null
​
assignee
string | null
​
priority_date
string | null
​
filing_date
string | null
​
grant_date
string | null
​
publication_date
string | null
​
language
string | null
​
pdf_url
string | null
​
thumbnail
string | null
​
web_url
string
default:""