Semanticscholar

Learn how to use Semanticscholar with Composio

Overview

Enum

SEMANTICSCHOLAR

Description

Semantic Scholar is an AI-powered academic search engine that helps researchers discover and understand scientific literature

Authentication Details

api_key
stringRequired

Actions

Retrieves the list of references cited by a specific paper in the semantic scholar database. this endpoint allows users to explore the scholarly context of a publication by accessing its bibliography. it’s particularly useful for understanding the foundation of a paper’s research, tracing the development of ideas, or conducting literature reviews. the tool returns details about the cited papers, which may include their titles, authors, publication dates, and semantic scholar ids. it should be used when analyzing a paper’s sources or investigating the connections between different academic works. note that this endpoint only provides outgoing references (papers cited by the specified paper) and not incoming citations (papers that cite the specified paper).

Action Parameters

offset
integer
limit
integerDefaults to 100
fields
string
paper_id
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves a list of papers authored by a specific researcher identified by their unique semantic scholar author id. this endpoint is particularly useful for conducting literature reviews, analyzing an author’s body of work, or tracking a researcher’s publications over time. it provides a comprehensive view of an author’s contributions to their field of study. the endpoint returns only the papers associated with the specified author and does not include co-authored works where the specified author is not listed as a primary author. note that the response may be paginated for authors with a large number of publications, and additional api calls might be necessary to retrieve the complete list of papers.

Action Parameters

offset
integer
limit
integerDefaults to 100
fields
string
author_id
stringRequired

Action Response

data
object
successful
boolean
error

The authorsearch endpoint allows users to search for authors within the semantic scholar database. it provides a way to find academic authors based on their names or other identifying information. this endpoint is particularly useful when you need to retrieve author metadata, such as their publications, affiliations, or research areas. the search functionality supports partial name matches and is case-insensitive, making it flexible for various search scenarios. use this endpoint when you want to discover authors or verify author information in the context of academic research. note that the search results may be limited and paginated, so multiple requests might be necessary for comprehensive results.

Action Parameters

offset
integer
limit
integerDefaults to 100
fields
string
query
stringRequired

Action Response

data
object
successful
boolean
error

Examples: https://api.semanticscholar.org/graph/v1/author/1741101 returns the author’s authorid and name. https://api.semanticscholar.org/graph/v1/author/1741101?fields=url,papers returns the author’s authorid, url, and list of papers. each paper has its paperid plus its title. https://api.semanticscholar.org/graph/v1/author/1741101?fields=url,papers.abstract,papers.authors returns the author’s authorid, url, and list of papers. each paper has its paperid, abstract, and list of authors. in that list of authors, each author has their authorid and name. limitations: can only return up to 10 mb of data at a time.

Action Parameters

fields
string
author_id
stringRequired

Action Response

data
object
successful
boolean
error

The semanticscholar paper batch endpoint allows users to retrieve data for multiple academic papers in a single api call. this endpoint is particularly useful when you need to fetch information for a batch of papers efficiently, reducing the number of individual api requests. it accepts an array of paper ids and returns the corresponding data for each paper. use this endpoint when you have a list of known paper ids and want to retrieve their details simultaneously. keep in mind that while there’s no specified limit on the number of ids you can send, very large batches may be subject to api rate limiting or response size restrictions.

Action Parameters

fields
string
ids
array

Action Response

data
object
successful
boolean
error

Examples: https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884c09aef38b returns a paper with its paperid and title. https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884c09aef38b?fields=url,year,authors returns the paper’s paperid, url, year, and list of authors. each author has authorid and name. https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884c09aef38b?fields=citations.authors returns the paper’s paperid and list of citations. each citation has its paperid plus its list of authors. each author has their 2 always included fields of authorid and name. limitations: can only return up to 10 mb of data at a time.

Action Parameters

paper_id
stringRequired
fields
string

Action Response

data
object
successful
boolean
error

Retrieves the list of authors for a specific paper identified by its unique paper id in the semantic scholar database. this endpoint is useful when you need detailed information about the contributors to a particular academic publication. it provides access to the author data associated with the paper, which may include names, affiliations, and potentially other metadata. this tool should be used when users require author information for a known paper, such as when exploring collaborations or tracking an author’s body of work. it does not provide the full paper content or other paper metadata beyond author information.

Action Parameters

offset
integer
limit
integerDefaults to 100
fields
string
paper_id
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves detailed information for multiple authors from semantic scholar in a single api call. this endpoint allows users to efficiently fetch data for a batch of authors by providing their unique semantic scholar ids. it’s particularly useful for applications that need to gather information on multiple authors simultaneously, reducing the number of individual api calls required. the endpoint accepts a list of author ids and returns comprehensive details for each author, which may include their publications, citations, and other relevant academic information. while the exact response structure is not specified in the given schema, users can expect rich metadata about the requested authors.

Action Parameters

fields
string
ids
array

Action Response

data
object
successful
boolean
error

To support interactive query-completion, return minimal information about papers matching a partial query example: https://api.semanticscholar.org/graph/v1/paper/autocomplete?query=semanti

Action Parameters

query
stringRequired

Action Response

data
object
successful
boolean
error

Retrieves a list of citations for a specific academic paper using its unique semantic scholar paper id. this endpoint is useful for researchers and developers who want to explore the impact and connections of a particular academic work within the broader scientific literature. it provides information about other papers that have cited the specified paper, allowing users to trace the influence of research and discover related works. the endpoint should be used when analyzing the reception and impact of a specific paper, building citation networks, or conducting bibliometric studies. it does not provide the full text of citing papers or detailed information about the citations beyond basic metadata.

Action Parameters

offset
integer
limit
integerDefaults to 100
fields
string
paper_id
stringRequired

Action Response

data
object
successful
boolean
error