Skip to main content
Semantic Scholar logo
  • Category: web search & research
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 21
  • Triggers: 0
  • Slug: SEMANTICSCHOLAR
  • Version: 20261101_00

Tools

Slug: SEMANTICSCHOLAR_DETAILS_ABOUT_AN_AUTHORRetrieve detailed information about an author from Semantic Scholar, including name, affiliations, publication statistics (paperCount, citationCount, h-index), external IDs (ORCID, DBLP), and optionally papers. By default returns authorId and name only. Use ‘fields’ parameter for additional data: name, url, affiliations, homepage, externalIds, paperCount, citationCount, hIndex, papers (supports nested fields like papers.title, papers.year). Limit: 10 MB per request.

Input Parameters

string
A comma-separated list of the fields to be returned. See the contents of Response Schema below for a list of all available fields that can be returned. The <code>authorId</code> field is always returned. If the fields parameter is omitted, only the <code>authorId</code> and <code>name</code> will be returned. <p>Use a period (“.”) for subfields of <code>papers</code>.

Examples: <ul> <li><code>fields=name,affiliations,papers</code></li> <li><code>fields=url,papers.year,papers.authors</code></li> </ul>
string
required
The unique Semantic Scholar author ID (e.g., ‘1688882’). This can be obtained from the author search endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_DETAILS_ABOUT_AN_AUTHOR_S_PAPERSRetrieves a list of papers authored or co-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, including all papers where the author is listed as an author regardless of their authorship position. 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. Use the offset and limit parameters to control pagination.

Input Parameters

integer
The maximum number of results to return.
Must be <= 1000
string
A comma-separated list of the fields to be returned. See the contents of the <code>data</code> array in Response Schema below for a list of all available fields that can be returned. The <code>paperId</code> field is always returned. If the fields parameter is omitted, only the <code>paperId</code> and <code>title</code> will be returned. To fetch more references or citations per paper, reduce the number of papers in the batch with <code>limit=</code>. <p>Use a period (“.”) for subfields of <code>citations</code> and <code>references</code>.

Examples: <ul> <li><code>fields=title,fieldsOfStudy,references</code></li> <li><code>fields=abstract,citations.url,citations.venue</code></li> </ul>
integer
Used for pagination. When returning a list of results, start with the element at this position in the list.
string
required
Author Id

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_DETAILS_ABOUT_A_PAPERRetrieve details for a paper by its ID, with selectable fields. By default the tool requests title, abstract, year, authors, citation and reference counts, URL, venue, publication date, and fields of study; responses are limited to 10 MB.

Input Parameters

string
A comma-separated list of the fields to be returned. The <code>paperId</code> field is always returned. If not specified, returns a useful default set of fields including title, abstract, year, authors, citation metrics, URL, venue, publication date, and fields of study. <p><b>Available fields:</b> paperId, corpusId, externalIds, url, title, abstract, venue, publicationVenue, year, publicationDate, publicationTypes, journal, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fieldsOfStudy, s2FieldsOfStudy, authors, citations, references, embedding, tldr</p><p><b>Nested field notation:</b> Use a period (”.”) for fields with subfields:</p><ul> <li><b>authors</b>: Default returns authorId and name. For additional subfields use: authors.url, authors.affiliations, authors.homepage, authors.paperCount, authors.citationCount, authors.hIndex</li> <li><b>citations/references</b>: Default returns paperId and title. For additional subfields use: citations.abstract, citations.year, citations.authors, references.venue, etc.</li> <li><b>embedding</b>: Use embedding.specter_v1 or embedding.specter_v2 for specific versions</li></ul><p><b>Examples:</b></p><ul> <li><code>title,url,year</code> - Basic paper info</li> <li><code>title,authors.url,authors.hIndex</code> - Paper with author metrics</li> <li><code>title,citations.title,citations.year</code> - Paper with citation details</li> <li><code>title,embedding.specter_v2,tldr</code> - Paper with AI summary and embeddings</li></ul>
string
required
The following types of IDs are supported: <ul> <li><code><sha></code> - a Semantic Scholar ID, e.g. <code>649def34f8be52c8b66281af98ae884c09aef38b</code></li> <li><code>CorpusId:<id></code> - a Semantic Scholar numerical ID, e.g. <code>CorpusId:215416146</code></li> <li><code>DOI:<doi></code> - a <a href=“http://doi.org”&gt;Digital Object Identifier</a>, e.g. <code>DOI:10.18653/v1/N18-3011</code></li> <li><code>ARXIV:<id></code> - <a href=“https://arxiv.org/“&gt;arXiv.rg&lt;/a>, e.g. <code>ARXIV:2106.15928</code></li> <li><code>MAG:<id></code> - Microsoft Academic Graph, e.g. <code>MAG:112218234</code></li> <li><code>ACL:<id></code> - Association for Computational Linguistics, e.g. <code>ACL:W12-3903</code></li> <li><code>PMID:<id></code> - PubMed/Medline, e.g. <code>PMID:19872477</code></li> <li><code>PMCID:<id></code> - PubMed Central, e.g. <code>PMCID:2323736</code></li> <li><code>URL:<url></code> - URL from one of the sites listed below, e.g. <code>URL:https://arxiv.org/abs/2106.15928v1&lt;/code&gt;&lt;/li> </ul> URLs are recognized from the following sites: <ul> <li><a href=“https://www.semanticscholar.org/“&gt;semanticscholar.org&lt;/a&gt;&lt;/li> <li><a href=“https://arxiv.org/“&gt;arxiv.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.aclweb.org”&gt;aclweb.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.acm.org/“&gt;acm.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.biorxiv.org/“&gt;biorxiv.org&lt;/a&gt;&lt;/li> </ul>

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_DETAILS_ABOUT_A_PAPER_S_AUTHORSRetrieve a paginated list of authors for a Semantic Scholar paper, identified by a supported ID such as a Semantic Scholar ID, DOI, or arXiv ID. Author IDs and names are returned by default; additional author details and paper subfields can be requested. Use offset and limit to page through results, with up to 1,000 authors per page.

Input Parameters

integer
The maximum number of results to return.
Must be <= 1000
string
A comma-separated list of additional author fields to return. <strong>Default fields (always returned):</strong> <code>authorId</code>, <code>name</code>. <strong>Optional fields:</strong> <code>url</code>, <code>affiliations</code>, <code>homepage</code>, <code>paperCount</code>, <code>citationCount</code>, <code>hIndex</code>, <code>papers</code>. Use a period (.) for subfields of <code>papers</code> (e.g., <code>papers.title</code>, <code>papers.year</code>, <code>papers.authors</code>).
<strong>Examples:</strong><ul><li><code>affiliations,homepage</code> - adds affiliation and homepage to defaults</li><li><code>url,paperCount,citationCount</code> - adds profile URL and metrics</li><li><code>papers.title,papers.year</code> - includes author’s papers with title and year</li></ul>
integer
Used for pagination. When returning a list of results, start with the element at this position in the list.
string
required
The following types of IDs are supported: <ul> <li><code><sha></code> - a Semantic Scholar ID, e.g. <code>649def34f8be52c8b66281af98ae884c09aef38b</code></li> <li><code>CorpusId:<id></code> - a Semantic Scholar numerical ID, e.g. <code>CorpusId:215416146</code></li> <li><code>DOI:<doi></code> - a <a href=“http://doi.org”&gt;Digital Object Identifier</a>, e.g. <code>DOI:10.18653/v1/N18-3011</code></li> <li><code>ARXIV:<id></code> - <a href=“https://arxiv.org/“&gt;arXiv.rg&lt;/a>, e.g. <code>ARXIV:2106.15928</code></li> <li><code>MAG:<id></code> - Microsoft Academic Graph, e.g. <code>MAG:112218234</code></li> <li><code>ACL:<id></code> - Association for Computational Linguistics, e.g. <code>ACL:W12-3903</code></li> <li><code>PMID:<id></code> - PubMed/Medline, e.g. <code>PMID:19872477</code></li> <li><code>PMCID:<id></code> - PubMed Central, e.g. <code>PMCID:2323736</code></li> <li><code>URL:<url></code> - URL from one of the sites listed below, e.g. <code>URL:https://arxiv.org/abs/2106.15928v1&lt;/code&gt;&lt;/li> </ul> URLs are recognized from the following sites: <ul> <li><a href=“https://www.semanticscholar.org/“&gt;semanticscholar.org&lt;/a&gt;&lt;/li> <li><a href=“https://arxiv.org/“&gt;arxiv.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.aclweb.org”&gt;aclweb.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.acm.org/“&gt;acm.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.biorxiv.org/“&gt;biorxiv.org&lt;/a&gt;&lt;/li> </ul>

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_DETAILS_ABOUT_A_PAPER_S_CITATIONSRetrieve a paginated list of papers citing a specified paper. Optional fields can include citation contexts, intents, influence indicators, and citing-paper metadata.

Input Parameters

integer
The maximum number of results to return.
Must be <= 1000
string
A comma-separated list of the fields to be returned. If omitted, only <code>paperId</code> and <code>title</code> of the citing papers are returned. Available fields include: <ul> <li><code>contexts</code> - citation contexts (text snippets)</li> <li><code>intents</code> - citation intent categories</li> <li><code>isInfluential</code> - whether this is an influential citation</li> <li><code>citingPaper.*</code> - fields from the citing paper (e.g., <code>citingPaper.title</code>, <code>citingPaper.year</code>, <code>citingPaper.authors</code>, <code>citingPaper.abstract</code>, <code>citingPaper.citationCount</code>, <code>citingPaper.venue</code>)</li></ul> Examples: <ul> <li><code>fields=contexts,isInfluential,intents</code></li> <li><code>fields=citingPaper.title,citingPaper.year,citingPaper.authors</code></li></ul>
integer
Used for pagination. When returning a list of results, start with the element at this position in the list.
string
required
The following types of IDs are supported: <ul> <li><code><sha></code> - a Semantic Scholar ID, e.g. <code>649def34f8be52c8b66281af98ae884c09aef38b</code></li> <li><code>CorpusId:<id></code> - a Semantic Scholar numerical ID, e.g. <code>CorpusId:215416146</code></li> <li><code>DOI:<doi></code> - a <a href=“http://doi.org”&gt;Digital Object Identifier</a>, e.g. <code>DOI:10.18653/v1/N18-3011</code></li> <li><code>ARXIV:<id></code> - <a href=“https://arxiv.org/“&gt;arXiv.rg&lt;/a>, e.g. <code>ARXIV:2106.15928</code></li> <li><code>MAG:<id></code> - Microsoft Academic Graph, e.g. <code>MAG:112218234</code></li> <li><code>ACL:<id></code> - Association for Computational Linguistics, e.g. <code>ACL:W12-3903</code></li> <li><code>PMID:<id></code> - PubMed/Medline, e.g. <code>PMID:19872477</code></li> <li><code>PMCID:<id></code> - PubMed Central, e.g. <code>PMCID:2323736</code></li> <li><code>URL:<url></code> - URL from one of the sites listed below, e.g. <code>URL:https://arxiv.org/abs/2106.15928v1&lt;/code&gt;&lt;/li> </ul> URLs are recognized from the following sites: <ul> <li><a href=“https://www.semanticscholar.org/“&gt;semanticscholar.org&lt;/a&gt;&lt;/li> <li><a href=“https://arxiv.org/“&gt;arxiv.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.aclweb.org”&gt;aclweb.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.acm.org/“&gt;acm.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.biorxiv.org/“&gt;biorxiv.org&lt;/a&gt;&lt;/li> </ul>

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_DETAILS_ABOUT_A_PAPER_S_REFERENCESRetrieves 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).

Input Parameters

integer
The maximum number of results to return.
Must be <= 1000
string
A comma-separated list of the fields to be returned for each reference. If omitted, only paperId and title are returned for each cited paper. Available fields include: <ul><li><code>contexts</code> - Text snippets where the reference appears in the citing paper</li><li><code>intents</code> - Citation intent categories (e.g., ‘methodology’, ‘background’)</li><li><code>contextsWithIntent</code> - Combined context and intent objects</li><li><code>isInfluential</code> - Boolean indicating if this is a highly influential citation</li><li><code>citedPaper.<field></code> - Nested fields for the cited paper (use period notation)</li></ul>For citedPaper fields, use period notation: citedPaper.title, citedPaper.year, citedPaper.authors, citedPaper.abstract, citedPaper.venue, citedPaper.citationCount, citedPaper.referenceCount, etc.

Examples: <ul><li><code>contexts,isInfluential</code> - Get citation contexts and influence flag</li><li><code>citedPaper.title,citedPaper.year,citedPaper.authors</code> - Get cited paper metadata</li><li><code>contexts,isInfluential,citedPaper.title,citedPaper.abstract</code> - Combined request</li></ul>
integer
Used for pagination. When returning a list of results, start with the element at this position in the list.
string
required
The following types of IDs are supported: <ul> <li><code><sha></code> - a Semantic Scholar ID, e.g. <code>649def34f8be52c8b66281af98ae884c09aef38b</code></li> <li><code>CorpusId:<id></code> - a Semantic Scholar numerical ID, e.g. <code>CorpusId:215416146</code></li> <li><code>DOI:<doi></code> - a <a href=“http://doi.org”&gt;Digital Object Identifier</a>, e.g. <code>DOI:10.18653/v1/N18-3011</code></li> <li><code>ARXIV:<id></code> - <a href=“https://arxiv.org/“&gt;arXiv.rg&lt;/a>, e.g. <code>ARXIV:2106.15928</code></li> <li><code>MAG:<id></code> - Microsoft Academic Graph, e.g. <code>MAG:112218234</code></li> <li><code>ACL:<id></code> - Association for Computational Linguistics, e.g. <code>ACL:W12-3903</code></li> <li><code>PMID:<id></code> - PubMed/Medline, e.g. <code>PMID:19872477</code></li> <li><code>PMCID:<id></code> - PubMed Central, e.g. <code>PMCID:2323736</code></li> <li><code>URL:<url></code> - URL from one of the sites listed below, e.g. <code>URL:https://arxiv.org/abs/2106.15928v1&lt;/code&gt;&lt;/li> </ul> URLs are recognized from the following sites: <ul> <li><a href=“https://www.semanticscholar.org/“&gt;semanticscholar.org&lt;/a&gt;&lt;/li> <li><a href=“https://arxiv.org/“&gt;arxiv.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.aclweb.org”&gt;aclweb.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.acm.org/“&gt;acm.org&lt;/a&gt;&lt;/li> <li><a href=“https://www.biorxiv.org/“&gt;biorxiv.org&lt;/a&gt;&lt;/li> </ul>

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_GET_DATASET_DIFFSGet download links for incremental diffs between dataset releases. Returns a list of diffs required to update a dataset from start_release to end_release, enabling efficient dataset synchronization. Use when you need to update a local dataset copy without re-downloading the entire dataset.

Input Parameters

string
required
Name of the dataset to retrieve diffs for. Common datasets include ‘papers’, ‘authors’, ‘citations’, ‘abstracts’, etc.
string
required
ID of the ending release. Use date format YYYY-MM-DD (e.g., ‘2025-01-15’) or ‘latest’ for the most recent release.
string
required
ID of the starting release. Use date format YYYY-MM-DD (e.g., ‘2024-12-31’) or ‘latest’ for the most recent release.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_GET_DETAILS_FOR_MULTIPLE_AUTHORS_AT_ONCERetrieve details for up to 1,000 Semantic Scholar authors by ID in one batch, with selectable author and paper fields. By default the API returns author IDs and names.

Input Parameters

array
required
A list of Semantic Scholar author IDs to retrieve details for. Author IDs are unique identifiers in the format of numeric strings (e.g., ‘144388777’, ‘1688882’). You can obtain author IDs by searching for authors by name using the author search endpoint. The API will return author details for each valid ID, and null for any invalid or non-existent IDs.
string
A comma-separated list of the fields to be returned. See the contents of Response Schema below for a list of all available fields that can be returned. The <code>authorId</code> field is always returned. If the fields parameter is omitted, only the <code>authorId</code> and <code>name</code> will be returned. <p>Use a period (“.”) for subfields of <code>papers</code>.

Examples: <ul> <li><code>fields=name,affiliations,papers</code></li> <li><code>fields=url,papers.year,papers.authors</code></li> </ul>

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_GET_DETAILS_FOR_MULTIPLE_PAPERS_AT_ONCERetrieve detailed information for multiple academic papers in a single API call using the Semantic Scholar paper batch endpoint. This endpoint efficiently fetches data for up to 500 papers at once, significantly reducing the number of individual API requests needed. Key features: - Accepts multiple paper ID formats (Semantic Scholar ID, CorpusId, DOI, ArXiv, PMID, etc.) - Customizable field selection to retrieve only needed data - Papers not found return null in the corresponding array position - Results maintain the same order as input IDs - Supports nested field queries (e.g., authors.name, citations.title) Use this endpoint when you have a list of known paper IDs and want to retrieve their details simultaneously, rather than making individual requests for each paper.

Input Parameters

array
A list of paper IDs to retrieve (maximum 500 IDs per request). Supports multiple ID formats: Semantic Scholar Paper ID (e.g., ‘649def34f8be52c8b66281af98ae884c09aef38b’), CorpusId (e.g., ‘CorpusId:37220927’), DOI (e.g., ‘10.1038/nature14539’), ArXiv ID (e.g., ‘arXiv:1706.03762’), PubMed ID (e.g., ‘PMID:29446767’), PubMed Central ID (e.g., ‘PMCID:PMC5833129’), MAG ID, ACL ID, or paper URL. Papers not found will return null in the response array.
string
A comma-separated list of the fields to be returned. See the contents of Response Schema below for a list of all available fields that can be returned. The <code>paperId</code> field is always returned. If the fields parameter is omitted, only the <code>paperId</code> and <code>title</code> will be returned. <p>Use a period (“.”) for fields that have version numbers or subfields, such as the <code>embedding</code>, <code>authors</code>, <code>citations</code>, and <code>references</code> fields: <ul> <li>When requesting <code>authors</code>, the <code>authorId</code> and <code>name</code> subfields are returned by default. To request other subfields, use the format <code>author.url,author.paperCount</code>, etc. See the Response Schema below for available subfields.</li> <li>When requesting <code>citations</code> and <code>references</code>, the <code>paperId</code> and <code>title</code> subfields are returned by default. To request other subfields, use the format <code>citations.title,citations.abstract</code>, etc. See the Response Schema below for available subfields.</li> <li>When requesting <code>embedding</code>, the default <a href=“https://github.com/allenai/specter”&gt;Spector embedding version</a> is v1. Specify <code>embedding.specter_v2</code> to select v2 embeddings.</li> </ul> Examples: <ul> <li><code>fields=title,url</code></li> <li><code>fields=title,embedding.specter_v2</code></li> <li><code>fields=title,authors,citations.title,citations.abstract</code></li> </ul>

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_GET_PAPER_RECOMMENDATIONSTool to get paper recommendations based on positive and negative example papers. Use when you need to find papers similar to ones you like (positive examples) and optionally dissimilar to ones you don’t like (negative examples). The recommendation engine analyzes the provided examples and returns relevant papers from the Semantic Scholar database.

Input Parameters

integer
Maximum number of paper recommendations to return. Default is 100, maximum is 500.
string
Comma-separated list of fields to return for each recommended paper. If not specified, only paperId and title are returned. Available fields include: paperId, corpusId, externalIds, url, title, abstract, venue, publicationVenue, year, referenceCount, citationCount, influentialCitationCount, isOpenAccess, openAccessPdf, fieldsOfStudy, s2FieldsOfStudy, publicationTypes, publicationDate, journal, citationStyles, authors, embedding, tldr. Use dot notation for nested fields (e.g., ‘authors.authorId’, ‘citations.title’).
array
Array of paper IDs that represent negative examples (papers you don’t want similar recommendations for). This is optional and helps refine recommendations by excluding similar papers. Accepts the same ID formats as positive_paper_ids.
array
required
Array of paper IDs that represent positive examples (papers you like and want similar recommendations for). Supported ID formats include: Semantic Scholar ID (e.g., ‘649def34f8be52c8b66281af98ae884c09aef38b’), CorpusId (e.g., ‘CorpusId:215416146’), DOI (e.g., ‘DOI:10.18653/v1/N18-3011’), ArXiv (e.g., ‘ARXIV:2106.15928’), MAG (e.g., ‘MAG:112218234’), ACL (e.g., ‘ACL:W12-3903’), PMID (e.g., ‘PMID:19872477’), PMCID (e.g., ‘PMCID:2323736’), or URL from supported sites.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_GET_RECOMMENDATIONS_FOR_PAPERTool to get recommended papers for a single positive example paper. Use when you need to find papers similar to a given paper based on Semantic Scholar’s recommendation algorithm.

Input Parameters

string ("recent" | "all-cs")
Pool of papers to recommend from
integer
How many recommendations to return. Default 100, maximum 500.
string
Comma-separated list of fields to return for each recommended paper. paperId is always included. Available fields: title, abstract, year, authors, venue, publicationDate, citationCount, referenceCount, fieldsOfStudy, openAccessPdf, url, embedding, citations, references. Use dot notation for nested fields (e.g., ‘authors.authorId’, ‘citations.title’). Examples: ‘title,year,authors’ or ‘title,abstract,citationCount,url’
string
required
Paper ID to find recommendations for. Supports various ID formats: <sha> (Semantic Scholar ID), CorpusId:<id>, DOI:<doi>, ARXIV:<id>, MAG:<id>, ACL:<id>, PMID:<id>, PMCID:<id>, URL:<url>. Example: ‘ArXiv:1810.04805’ or ‘649def34f8be52c8b66281af98ae884c09aef38b’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_GET_RELEASETool to retrieve metadata for a specific Semantic Scholar dataset release. Returns release information including available datasets with their descriptions. Use when you need to discover what datasets are available in a release or get release documentation.

Input Parameters

string
required
ID of the release in date format (e.g., ‘2023-08-01’) or ‘latest’ for the most recent release

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_LIST_RELEASESTool to list all available dataset releases from Semantic Scholar. Use when you need to discover available release dates for downloading datasets.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_PAPER_RELEVANCE_SEARCHDEPRECATED: Use SEMANTICSCHOLAR_SEARCH_PAPERS instead. The SearchPapers endpoint allows users to search for academic papers within the Semantic Scholar database. It provides a powerful way to discover relevant scientific literature based on user-defined search criteria. This endpoint should be used when researchers, students, or developers need to find papers related to specific topics, authors, or time periods. The search functionality supports various query parameters to refine and customize the search results, making it suitable for both broad exploratory searches and targeted inquiries. However, users should be aware that the search is limited to papers indexed by Semantic Scholar, and very recent publications might not be immediately available. The endpoint returns a list of papers matching the search criteria, along with selected metadata fields, facilitating efficient literature review and analysis.

Input Parameters

string
Restricts results to the given publication year or range of years (inclusive).

Examples: <ul> <li><code>2019</code> in 2019</li> <li><code>2016-2020</code> as early as 2016 or as late as 2020</li> <li><code>2010-</code> during or after 2010</li> <li><code>-2015</code> before or during 2015</li> </ul>
integer
Maximum number of results to return per request (must be <= 100). Total results capped at 1,000.
string
required
Plain-text search query for papers (no special query syntax supported). Use spaces instead of hyphens in search terms. Example: ‘machine learning’ or ‘neural networks’
string
Restricts results to papers published in the given venues, formatted as a comma-separated list.

Input could also be an ISO4 abbreviation. Examples include: <ul> <li>Nature</li> <li>New England Journal of Medicine</li> <li>Radiology</li> <li>N. Engl. J. Med.</li> </ul> Example: <code>Nature,Radiology</code> will return papers from venues Nature and/or Radiology.
string
Comma-separated list of fields to return. paperId is always included; if omitted, only paperId and title are returned. Available fields include: title, abstract, year, authors, venue, publicationDate, citationCount, referenceCount, fieldsOfStudy, openAccessPdf, url, embedding.specter_v2, citations, references. Use dot notation for subfields (e.g., ‘authors.authorId’, ‘citations.title’). Examples: ‘title,abstract,year’ or ‘title,authors,citationCount,url’
integer
Pagination offset: skip this many results before returning data. Use with limit for pagination.
string
Restricts results to papers in the given fields of study, formatted as a comma-separated list: <ul> <li>Computer Science</li> <li>Medicine</li> <li>Chemistry</li> <li>Biology</li> <li>Materials Science</li> <li>Physics</li> <li>Geology</li> <li>Psychology</li> <li>Art</li> <li>History</li> <li>Geography</li> <li>Sociology</li> <li>Business</li> <li>Political Science</li> <li>Economics</li> <li>Philosophy</li> <li>Mathematics</li> <li>Engineering</li> <li>Environmental Science</li> <li>Agricultural and Food Sciences</li> <li>Education</li> <li>Law</li> <li>Linguistics</li> </ul> Example: <code>Physics,Mathematics</code> will return papers with either Physics or Mathematics in their list of fields-of-study.
string
Restricts results to only include papers with a public PDF. This parameter does not accept any values.
integer
Restricts results to only include papers with at least this many citations. Must be a non-negative integer. Example: 200
string
Restricts results to any of the following paper publication types: <ul> <li>Review</li> <li>JournalArticle</li> <li>CaseReport</li> <li>ClinicalTrial</li> <li>Conference</li> <li>Dataset</li> <li>Editorial</li> <li>LettersAndComments</li> <li>MetaAnalysis</li> <li>News</li> <li>Study</li> <li>Book</li> <li>BookSection</li> </ul> Use a comma-separated list to include papers with any of the listed publication types.

Example: <code>Review,JournalArticle</code> will return papers with publication types Review and/or JournalArticle.
string
Restricts results to the given range of publication dates or years (inclusive). Accepts the format <code><startDate>:<endDate></code> with each date in <code>YYYY-MM-DD</code> format.

Each term is optional, allowing for specific dates, fixed ranges, or open-ended ranges. In addition, prefixes are suported as a shorthand, e.g. <code>2020-06</code> matches all dates in June 2020.

Specific dates are not known for all papers, so some records returned with this filter will have a <code>null</code> value for </code>publicationDate</code>. <code>year</code>, however, will always be present. For records where a specific publication date is not known, they will be treated as if published on January 1st of their publication year.

Examples: <ul> <li><code>2019-03-05</code> on March 3rd, 2019</li> <li><code>2019-03</code> during March 2019</li> <li><code>2019</code> during 2019</li> <li><code>2016-03-05:2020-06-06</code> as early as March 5th, 2016 or as late as June 6th, 2020</li> <li><code>1981-08-25:</code> on or after August 25th, 1981</li> <li><code>:2015-01</code> before or on January 31st, 2015</li> <li><code>2015:2020</code> between January 1st, 2015 and December 31st, 2020</li> </ul>

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_PAPER_TITLE_SEARCHBehaves similarly to <code>/paper/search</code>, but is intended for retrieval of a single paper based on closest title match to given query. Examples: <ul> <li><code>https://api.semanticscholar.org/graph/v1/paper/search/match?query=Construction of the Literature Graph in Semantic Scholar</code></li> <ul> <li>Returns a single paper that is the closest title match.</li> <li>Each paper has its paperId, title, and matchScore as well as any other requested fields.</li> </ul> <li><code>https://api.semanticscholar.org/graph/v1/paper/search/match?query=totalGarbageNonsense&lt;/code&gt;&lt;/li> <ul> <li>Returns with a 404 error and a “Title match not found” message.</li> </ul> </ul>
Limitations: <ul> <li>Will only return the single highest match result.</li> </ul> </ul>

Input Parameters

string
Restricts results to the given publication year or range of years (inclusive).

Examples: <ul> <li><code>2019</code> in 2019</li> <li><code>2016-2020</code> as early as 2016 or as late as 2020</li> <li><code>2010-</code> during or after 2010</li> <li><code>-2015</code> before or during 2015</li> </ul>
string
required
A plain-text search query string. * No special query syntax is supported. See our <a href=“https://medium.com/ai2-blog/building-a-better-search-engine-for-semantic-scholar-ea23a0b661e7”&gt;blog post</a> for a description of our search relevance algorithm.
string
Restricts results to papers published in the given venues, formatted as a comma-separated list.

Input could also be an ISO4 abbreviation. Examples include: <ul> <li>Nature</li> <li>New England Journal of Medicine</li> <li>Radiology</li> <li>N. Engl. J. Med.</li> </ul> Example: <code>Nature,Radiology</code> will return papers from venues Nature and/or Radiology.
string
A comma-separated list of the fields to be returned. See the contents of the <code>data</code> array in Response Schema below for a list of all available fields that can be returned. The <code>paperId</code> field is always returned. If the fields parameter is omitted, only the <code>paperId</code> and <code>title</code> will be returned. <p>Use a period (“.”) for fields that have version numbers or subfields, such as the <code>embedding</code>, <code>authors</code>, <code>citations</code>, and <code>references</code> fields: <ul> <li>When requesting <code>authors</code>, the <code>authorId</code> and <code>name</code> subfields are returned by default. To request other subfields, use the format <code>author.url,author.paperCount</code>, etc. See the Response Schema below for available subfields.</li> <li>When requesting <code>citations</code> and <code>references</code>, the <code>paperId</code> and <code>title</code> subfields are returned by default. To request other subfields, use the format <code>citations.title,citations.abstract</code>, etc. See the Response Schema below for available subfields.</li> <li>When requesting <code>embedding</code>, the default <a href=“https://github.com/allenai/specter”&gt;Spector embedding version</a> is v1. Specify <code>embedding.specter_v2</code> to select v2 embeddings.</li> </ul> Examples: <ul> <li><code>fields=title,url</code></li> <li><code>fields=title,embedding.specter_v2</code></li> <li><code>fields=title,authors,citations.title,citations.abstract</code></li> </ul>
string
Restricts results to papers in the given fields of study, formatted as a comma-separated list: <ul> <li>Computer Science</li> <li>Medicine</li> <li>Chemistry</li> <li>Biology</li> <li>Materials Science</li> <li>Physics</li> <li>Geology</li> <li>Psychology</li> <li>Art</li> <li>History</li> <li>Geography</li> <li>Sociology</li> <li>Business</li> <li>Political Science</li> <li>Economics</li> <li>Philosophy</li> <li>Mathematics</li> <li>Engineering</li> <li>Environmental Science</li> <li>Agricultural and Food Sciences</li> <li>Education</li> <li>Law</li> <li>Linguistics</li> </ul> Example: <code>Physics,Mathematics</code> will return papers with either Physics or Mathematics in their list of fields-of-study.
string
Restricts results to only include papers with a public PDF. This parameter does not accept any values.
integer
Restricts results to only include papers with at least this many citations. Must be a non-negative integer. Example: 200
string
Restricts results to any of the following paper publication types: <ul> <li>Review</li> <li>JournalArticle</li> <li>CaseReport</li> <li>ClinicalTrial</li> <li>Conference</li> <li>Dataset</li> <li>Editorial</li> <li>LettersAndComments</li> <li>MetaAnalysis</li> <li>News</li> <li>Study</li> <li>Book</li> <li>BookSection</li> </ul> Use a comma-separated list to include papers with any of the listed publication types.

Example: <code>Review,JournalArticle</code> will return papers with publication types Review and/or JournalArticle.
string
Restricts results to the given range of publication dates or years (inclusive). Accepts the format <code><startDate>:<endDate></code> with each date in <code>YYYY-MM-DD</code> format.

Each term is optional, allowing for specific dates, fixed ranges, or open-ended ranges. In addition, prefixes are suported as a shorthand, e.g. <code>2020-06</code> matches all dates in June 2020.

Specific dates are not known for all papers, so some records returned with this filter will have a <code>null</code> value for </code>publicationDate</code>. <code>year</code>, however, will always be present. For records where a specific publication date is not known, they will be treated as if published on January 1st of their publication year.

Examples: <ul> <li><code>2019-03-05</code> on March 3rd, 2019</li> <li><code>2019-03</code> during March 2019</li> <li><code>2019</code> during 2019</li> <li><code>2016-03-05:2020-06-06</code> as early as March 5th, 2016 or as late as June 6th, 2020</li> <li><code>1981-08-25:</code> on or after August 25th, 1981</li> <li><code>:2015-01</code> before or on January 31st, 2015</li> <li><code>2015:2020</code> between January 1st, 2015 and December 31st, 2020</li> </ul>

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_SEARCH_BULK_PAPERSTool to perform bulk search for academic papers. Intended for bulk retrieval of basic paper data without search relevance scoring. Use when you need to retrieve large sets of papers with optional text filtering and various criteria. Supports token-based pagination for efficient fetching of up to 10 million papers (use Datasets API for larger needs).

Input Parameters

string
Sort results by field:order. Available fields: paperId, publicationDate, citationCount. Default field is paperId, default order is asc. Ties broken by paperId. Records with null sort values appear at end regardless of order. Examples: ‘publicationDate:asc’ (oldest first), ‘citationCount:desc’ (most cited first), ‘paperId’ (ID order).
string
Publication year or year range filter (inclusive). Examples: ‘2019’ (year 2019), ‘2016-2020’ (range), ‘2010-’ (on or after 2010), ‘-2015’ (before or on 2015).
string
Optional text query matched against paper title and abstract. All terms are stemmed in English. By default, all query terms must be present. Supports boolean operators: + (AND), | (OR), - (NOT), "" (phrase), * (prefix match), () (precedence), N (fuzzy match with edit distance N, default 2). When omitted, returns all papers (subject to filters). Examples: ‘fish ladder’ (both terms), ‘fish | ladder’ (either term), ‘“fish ladder”’ (exact phrase), ‘fish’ (fuzzy match), ‘(fish ladder) | outflow’ (boolean logic).
string
Pagination token from previous response. Used to fetch the next batch of papers. Each response returns a new token when more results are available.
string
Comma-separated list of venue names. ISO4 abbreviations supported. Papers from any listed venue are returned. Examples: Nature, New England Journal of Medicine, Radiology, N. Engl. J. Med.
string
Comma-separated list of fields to return. paperId is always returned. If omitted, only paperId and title are returned. Available fields: title, abstract, venue, publicationVenue, year, publicationDate, authors, externalIds, url, referenceCount, citationCount, influentialCitationCount, isOpenAccess, openAccessPdf, fieldsOfStudy, s2FieldsOfStudy, publicationTypes, journal, citationStyles, corpusId.
string
Comma-separated list of fields of study. Papers in any listed field are returned. Available fields: Computer Science, Medicine, Chemistry, Biology, Materials Science, Physics, Geology, Psychology, Art, History, Geography, Sociology, Business, Political Science, Economics, Philosophy, Mathematics, Engineering, Environmental Science, Agricultural and Food Sciences, Education, Law, Linguistics.
string
Restricts results to papers with a public PDF. This parameter does not accept any values - its presence activates the filter.
integer
Minimum number of citations required. Must be non-negative.
string
Comma-separated list of publication types to include. Available types: Review, JournalArticle, CaseReport, ClinicalTrial, Conference, Dataset, Editorial, LettersAndComments, MetaAnalysis, News, Study, Book, BookSection. Papers matching any listed type are returned.
string
Date or year range filter (inclusive) in format <startDate>:<endDate>. Each date in YYYY-MM-DD format. Each term optional for open-ended ranges. Prefixes supported (e.g., 2020-06 matches June 2020). Papers without specific dates treated as published January 1st of their year. Examples: ‘2019-03-05’ (specific date), ‘2019-03’ (March 2019), ‘2019’ (year 2019), ‘2016-03-05:2020-06-06’ (date range), ‘1981-08-25:’ (on or after), ‘:2015-01’ (before or on), ‘2015:2020’ (year range).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_SEARCH_FOR_AUTHORS_BY_NAMESearch for academic authors in the Semantic Scholar database by name. This action searches for authors using plain-text name queries. The search is case-insensitive and supports partial name matches (e.g., “Smith” will match “John Smith”, “Adam Smith”, etc.). Use cases: - Find authors by their name to get their author ID - Discover authors in a specific research area by searching common names - Retrieve author metadata including publications, affiliations, citation counts, and h-index - Build author directories or research networks The response includes pagination metadata (total, offset, next) to help retrieve large result sets. Use the ‘fields’ parameter to customize which author attributes are returned, and use ‘offset’ and ‘limit’ for pagination through result sets larger than 1000 authors. Note: Results are paginated with a maximum of 1000 results per request. Use the ‘next’ field in the response to determine the offset for the next page.

Input Parameters

integer
Maximum number of results to return per request. Must be between 1 and 1000. Default: 100
string
required
Author name to search for (plain text). The search is case-insensitive and supports partial matches. Note: Hyphenated names should use spaces instead of hyphens for better results (e.g., use ‘Alan Turing’ not ‘Alan-Turing’). No special query syntax (wildcards, operators, etc.) is supported.
string
Comma-separated list of author fields to include in the response. Available fields: name, url, affiliations, homepage, paperCount, citationCount, hIndex, papers. The ‘authorId’ field is always returned. If omitted, only ‘authorId’ and ‘name’ are returned. For nested paper fields, use dot notation (e.g., ‘papers.title,papers.year’). Examples: ‘name,affiliations,paperCount’ or ‘url,papers.title,papers.year’
integer
Starting position for pagination. Use this with ‘limit’ to retrieve results in batches. For example, offset=0 returns the first batch, offset=100 returns the second batch (if limit=100). Default: 0

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_SEARCH_PAPERSTool to search for academic papers by relevance in the Semantic Scholar database. Use when searching for papers on specific topics, keywords, or research areas. Returns papers ordered by relevance score with support for extensive filtering by publication type, date, venue, field of study, and citation metrics.

Input Parameters

string
Filter by publication year or year range (inclusive). Examples: ‘2019’ (in 2019), ‘2016-2020’ (from 2016 to 2020), ‘2010-’ (2010 or after), ‘-2015’ (2015 or before)
integer
Maximum number of results to return per request. Must be between 1 and 100
string
required
Plain-text search query string. No special query syntax is supported. Use spaces instead of hyphens in search terms. Example: ‘machine learning’ or ‘neural networks’
string
Comma-separated list of publication venues to filter by. Can use full names or ISO4 abbreviations. Examples: ‘Nature’, ‘New England Journal of Medicine’, ‘N. Engl. J. Med.’, ‘Nature,Radiology’
string
Comma-separated list of fields to return. paperId is always returned. If omitted, only paperId and title are returned. Available fields: title, abstract, year, venue, publicationDate, authors, citationCount, referenceCount, influentialCitationCount, isOpenAccess, openAccessPdf, fieldsOfStudy, s2FieldsOfStudy, publicationTypes, publicationVenue, journal, externalIds, url, embedding, citations, references, tldr. Use dot notation for subfields (e.g., ‘authors.authorId,authors.name’, ‘citations.title’, ‘embedding.specter_v2’). Examples: ‘title,abstract,year’ or ‘title,authors,citationCount,url’
integer
Pagination offset: number of results to skip before returning data. Used with limit for pagination
string
Comma-separated list of fields of study to filter by. Available fields: Computer Science, Medicine, Chemistry, Biology, Materials Science, Physics, Geology, Psychology, Art, History, Geography, Sociology, Business, Political Science, Economics, Philosophy, Mathematics, Engineering, Environmental Science, Agricultural and Food Sciences, Education, Law, Linguistics. Example: ‘Physics,Mathematics’
string
Set to any value (e.g., ”) to restrict results to papers with a public PDF available
integer
Minimum number of citations required. Restricts results to papers with at least this many citations. Must be non-negative
string
Comma-separated list of publication types to filter by. Available types: Review, JournalArticle, CaseReport, ClinicalTrial, Conference, Dataset, Editorial, LettersAndComments, MetaAnalysis, News, Study, Book, BookSection. Example: ‘Review,JournalArticle’
string
Filter by publication date or year range (inclusive). Format: ‘<startDate>:<endDate>’ with dates in YYYY-MM-DD format. Each term is optional for open-ended ranges. Prefixes supported (e.g., ‘2020-06’ for June 2020). Examples: ‘2019-03-05’ (specific date), ‘2019-03’ (March 2019), ‘2019’ (entire 2019), ‘2016-03-05:2020-06-06’ (date range), ‘1981-08-25:’ (on or after), ‘:2015-01’ (before or on), ‘2015:2020’ (year range)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_SUGGEST_PAPER_QUERY_COMPLETIONSGet autocomplete suggestions for paper queries. Returns a list of papers matching the partial query string, useful for interactive search experiences. Each suggestion includes the paper ID, title, and authors with publication year. Example: For query “machine learning”, returns papers like “Machine learning - a probabilistic perspective” by Murphy, 2012.

Input Parameters

string
required
Plain-text partial query string for autocomplete suggestions. Must be at least 3 characters long. Will be truncated to first 100 characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SEMANTICSCHOLAR_TEXT_SNIPPET_SEARCHSearch for text snippets matching a plain-text query in academic papers. Results are ranked by relevance and include paper information and a score; excerpts are drawn from titles, abstracts, and body text. Filter by author, year, or venue, choose snippet fields, and set a result limit (default 10, maximum 1,000).

Input Parameters

string
Filter results by publication year. Supports specific years (‘2022’) or ranges (‘2020-2023’).
integer
Maximum number of snippet results to return. Must be between 1 and 1000. Default is 10. Use smaller limits for faster responses.
string
required
Plain-text search query to find matching text snippets in academic papers. No special query syntax is supported - just use natural language. Example: ‘machine learning neural networks’
string
Filter results by publication venue (journal or conference name). Example: ‘Nature’ or ‘ICML’
string
Comma-separated list of snippet fields to include in the response. Available fields: text, snippetKind, section, snippetOffset, annotations. If not specified, all fields are returned by default.
string
Filter results to papers by specific authors. Provide comma-separated author names (fuzzy matching supported). Uses AND logic - all authors must match. Maximum 10 authors.
string
Filter results to only snippets from specific papers. Provide a comma-separated list of paper IDs (supports multiple ID formats: corpusId, DOI, arXiv ID, etc.). Maximum ~100 paper IDs.
string
Filter results by academic field. Comma-separated list of fields like ‘Computer Science’, ‘Medicine’, ‘Physics’, etc.
string
Filter results to papers with at least this many citations. Useful for finding influential papers. Example: ‘10’ or ‘100’
string
Filter results by publication date range. Supports ranges like ‘2020-2023’ or specific years like ‘2022’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not