Skip to main content
POST
/
api
/
patentscope
/
patents
/
search
/patentscope/patents/search
curl --request POST \
  --url https://api.anysite.io/api/patentscope/patents/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "query": "quantum",
  "applicant": "IBM",
  "inventor": "Hassabis",
  "title": "neural network",
  "ipc": "G06N",
  "cpc": "G06N3/04",
  "country": "US",
  "application_number": "93110696",
  "publication_number": "0594947",
  "grant_number": "<string>",
  "application_date_from": "20200101",
  "application_date_to": "20201231",
  "publication_date_from": "<string>",
  "publication_date_to": "<string>",
  "priority_date_from": "<string>",
  "priority_date_to": "<string>",
  "grant_date_from": "<string>",
  "grant_date_to": "<string>",
  "lang": "en",
  "sort": "relevance"
}
'
[
  {
    "doc_id": "<string>",
    "@type": "@patentscope_search_item",
    "publication_number": "<string>",
    "title": "<string>",
    "country_code": "<string>",
    "publication_date": "<string>",
    "ipc": [],
    "application_number": "<string>",
    "applicant": "<string>",
    "inventor": "<string>",
    "abstract": "<string>"
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
count
integer
required

Max number of results to return

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

Max scrapping execution timeout (in seconds)

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

Free keyword or raw CQL expression to combine with the other filters

Example:

"quantum"

​
applicant
string | null

Applicant / owner name

Example:

"IBM"

​
inventor
string | null

Inventor name

Example:

"Hassabis"

​
title
string | null

Words in the patent title

Example:

"neural network"

​
ipc
string | null

IPC classification symbol

Example:

"G06N"

​
cpc
string | null

CPC classification symbol

Example:

"G06N3/04"

​
country
string | null

Two-letter office / country code

Example:

"US"

​
application_number
string | null

Application number

Example:

"93110696"

​
publication_number
string | null

Publication number (as printed, without country prefix)

Example:

"0594947"

​
grant_number
string | null

Grant number

​
application_date_from
string | null

Earliest application date (YYYYMMDD)

Example:

"20200101"

​
application_date_to
string | null

Latest application date (YYYYMMDD)

Example:

"20201231"

​
publication_date_from
string | null

Earliest publication date (YYYYMMDD)

​
publication_date_to
string | null

Latest publication date (YYYYMMDD)

​
priority_date_from
string | null

Earliest priority date (YYYYMMDD)

​
priority_date_to
string | null

Latest priority date (YYYYMMDD)

​
grant_date_from
string | null

Earliest grant date (YYYYMMDD)

​
grant_date_to
string | null

Latest grant date (YYYYMMDD)

​
lang
enum<string>
default:en

Language used to match the title filter

Available options:
en,
fr,
de,
es,
pt,
ru,
ja,
zh,
ko,
ar
​
sort
enum<string>
default:relevance

Result ordering

Available options:
relevance,
publication_date_desc,
publication_date_asc,
application_date_desc,
application_date_asc

Response

Successful Response

​
doc_id
string
required
​
@type
string
default:@patentscope_search_item
​
publication_number
string | null
​
title
string | null
​
country_code
string | null
​
publication_date
string | null
​
ipc
string[]
​
application_number
string | null
​
applicant
string | null
​
inventor
string | null
​
abstract
string | null