GET
/
api
/
patents
Get relevant patents by searching 2-6 relevant keywords.
curl --request GET \
  --url https://api.scholarai.io/api/patents \
  --header 'x-scholarai-api-key: <api-key>'
[
  {
    "title": "<string>",
    "authors": [
      "<string>"
    ],
    "abstract": "<string>",
    "publication_date": "<string>",
    "cited_by_count": 123,
    "url": "<string>",
    "ss_id": "<string>",
    "doi": "<string>",
    "answer": "<string>"
  }
]

Authorizations

​
x-scholarai-api-key
string
header
required

Query Parameters

​
full_user_prompt
string
required

The entirety of the user request, directly quoted.

​
keywords
string
required

Keywords of inquiry which should appear in article. Must be in English.

​
sort
string

The sort order for results. Valid values are relevance, cited_by_count, publication_date. Defaults to relevance.

​
query
string
required

The user query. If the user asks for a specific patent, you MUST hit the API using escaped quotation marks

​
peer_reviewed_only
string

Whether to only return peer reviewed articles. Defaults to true, ChatGPT should cautiously suggest this value can be set to false

​
start_year
string

The first year, inclusive, to include in the search range. Excluding this value will include all years.

​
end_year
string

The last year, inclusive, to include in the search range. Excluding this value will include all years.

​
offset
string

The offset of the first result to return. Defaults to 0.

​
generative_mode
string

Boolean "true" or "false" to enable generative mode. If enabled, collate responses using markdown to render in-text citations to the source's url if available. Set this to true by default.

Response

200 - application/json

OK

​
title
string
​
authors
string[]
​
abstract
string

The abstract of this paper. Agentic endpoints may not have this entry.

​
publication_date
string
​
cited_by_count
integer
​
url
string<url>
​
ss_id
string

Semantic Scholar ID

​
doi
string

Digital Object Identifier

​
answer
string

Answer to the user query based on the information from this paper. Only available if generative_mode is set to true.