Skip to main content
POST
/
api
/
kipris
/
patents
/
search
/kipris/patents/search
curl --request POST \
  --url https://api.anysite.io/api/kipris/patents/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "query": "battery",
  "title": "lithium battery",
  "abstract": "<string>",
  "applicant": "삼성전자",
  "inventor": "<string>",
  "agent": "<string>",
  "ipc": "H01M",
  "cpc": "H01M4/88",
  "application_number": "1020130096423",
  "publication_number": "<string>",
  "application_date_from": "20200101",
  "application_date_to": "20201231",
  "publication_date_from": "<string>",
  "publication_date_to": "<string>",
  "collection": "korea",
  "offices": [],
  "sort": "relevance"
}
'
[
  {
    "id": "<string>",
    "@type": "@kipris_patent",
    "country_code": "<string>",
    "category": "<string>",
    "kind_code": "<string>",
    "title": "<string>",
    "title_en": "<string>",
    "abstract": "<string>",
    "claims": "<string>",
    "application_number": "<string>",
    "application_date": "<string>",
    "publication_number": "<string>",
    "publication_date": "<string>",
    "registration_number": "<string>",
    "registration_date": "<string>",
    "international_application_number": "<string>",
    "international_publication_number": "<string>",
    "legal_status": "<string>",
    "legal_status_detail": "<string>",
    "ipc": [],
    "cpc": [],
    "applicants": [],
    "applicants_en": [],
    "applicant_addresses": [],
    "inventors": [],
    "inventors_en": [],
    "inventor_addresses": [],
    "agents": [],
    "agents_en": [],
    "agent_addresses": [],
    "rights_holders": [],
    "rights_holders_en": [],
    "rights_holder_addresses": [],
    "priority_numbers": [],
    "family_members": [],
    "image": "<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 searched across title, abstract and claims

Example:

"battery"

title
string | null

Words in the invention title

Example:

"lithium battery"

abstract
string | null

Words in the abstract

applicant
string | null

Applicant / owner name

Example:

"삼성전자"

inventor
string | null

Inventor name

agent
string | null

Patent agent / attorney name

ipc
string | null

IPC classification symbol

Example:

"H01M"

cpc
string | null

CPC classification symbol

Example:

"H01M4/88"

application_number
string | null

Application number

Example:

"1020130096423"

publication_number
string | null

Publication (laid-open) 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)

collection
enum<string>
default:korea

Which collection to search: Korean records or foreign offices

Available options:
korea,
foreign
category
enum<string> | null

Restrict Korean results to patents or utility models only

Available options:
patent,
utility
offices
enum<string>[] | null

Foreign offices to include when collection is foreign

Available options:
US,
EP,
WO,
JP,
CN
sort
enum<string>
default:relevance

Result ordering

Available options:
relevance,
application_date,
publication_date,
registration_date

Response

Successful Response

id
string
required
@type
string
default:@kipris_patent
country_code
string | null
category
string | null
kind_code
string | null
title
string | null
title_en
string | null
abstract
string | null
claims
string | null
application_number
string | null
application_date
string | null
publication_number
string | null
publication_date
string | null
registration_number
string | null
registration_date
string | null
international_application_number
string | null
international_publication_number
string | null
ipc
string[]
cpc
string[]
applicants
string[]
applicants_en
string[]
applicant_addresses
string[]
inventors
string[]
inventors_en
string[]
inventor_addresses
string[]
agents
string[]
agents_en
string[]
agent_addresses
string[]
rights_holders
string[]
rights_holders_en
string[]
rights_holder_addresses
string[]
priority_numbers
string[]
family_members
string[]
image
string | null