S2Paper

class s2.models.S2Paper(*, abstract: str = None, arxivId: str = None, authors: List[s2.models.S2PaperAuthor] = None, citationVelocity: int = None, citations: List[s2.models.S2Reference] = None, corpusId: int = None, doi: str = None, fieldsOfStudy: List[str] = None, influentialCitationCount: int = None, is_open_access: bool, is_publisher_licensed: bool, paperId: str = None, references: List[s2.models.S2Reference] = None, title: str = None, topics: List[s2.models.S2Topic] = None, url: str = None, venue: str = None, year: int = None)

Class for Semantic Scholar paper object

Attributes

abstract (str, optional):

Extracted abstract of the paper

arxivId (str, optional):

ArXiv identifier of the paper

authors (list of S2PaperAuthor, optional):

List of authors of the paper

citationVelocity (int, optional):

Weighted average of the publication’s citations for the last 3 years

citations (list of S2Reference, optional):

List of papers cited by the paper

corpusId (int, optional):

Semantic Scholar Corpus ID (or S2CID for short) of the paper

doi (str, optional):

Digital Object Identifier registered at doi.org

fieldsOfStudy (list of str, optional):

Zero or more fields of study this paper addresses

influentialCitationCount (int, optional):

Number of influential citations, see https://www.semanticscholar.org/faq#influential-citations)

is_open_access (bool, optional):

If the paper is open access.

is_publisher_licensed (bool, optional):

If the paper is published licensed.

paperId (str, optional):

Semantic Scholar identifier of the paper

references (list of S2Reference, optional):

List of papers referenced by the paper

title (str, optional):

Title of the paper

topics (list of S2Topic, optional):

List of extracted topics, see https://www.semanticscholar.org/faq#extract-key-phrases

url (str, optional):

Semantic Scholar URL of the paper

venue (str, optional):

Extracted publication venue of the paper

year (int, optional):

Publication year of the paper

class s2.models.S2Reference(*, arxivId: str = None, authors: List[s2.models.S2PaperAuthor] = None, doi: str = None, intent: List[str] = None, isInfluential: bool, paperId: str = None, title: str = None, url: str = None, venue: str = None, year: int = None)

Class for papers that are references/citations in S2Paper

Attributes

arxivId (str, optional):

ArXiv identifier of the paper

authors (list of S2PaperAuthor, optional):

List of authors of the paper

doi (str, optional):

Digital Object Identifier registered at doi.org

intent (list of str, optional):

List of citation intents, see https://medium.com/ai2-blog/citation-intent-classification-bd2bd47559de

isInfluential: (bool, optional):

If the paper is influential, see https://www.semanticscholar.org/faq#influential-citations)

paperId: (str, optional):

Semantic Scholar identifier of the paper

title: (str, optional):

Title of the paper

url: (str, optional):

Semantic Scholar URL of the paper

venue: (str, optional):

Extracted publication venue of the paper

year: (int, optional):

Publication year of the paper

class s2.models.S2PaperAuthor(*, authorId: str = None, name: str = None, url: str = None)

Class for authors in S2Paper or S2Reference

Attributes

authorId (str, optional):

Semantic Scholar identifier of the author

name (str, optional):

Name of author

url (str, optional):

Semantic Scholar URL to author page.

Not included for authors from S2Reference, but easily reconstructed as https://www.semanticscholar.org/author/authorId

class s2.models.S2Topic(*, topic: str = None, topicId: str = None, url: str = None)

Class for topics in models.S2Paper

Attributes

topic (str, optional):

Name of the topic

topicId (str, optional):

Semantic Scholar identifier of the topic

url (str, optional):

Semantic Scholar URL of the topic page with format https://www.semanticscholar.org/topic/topicId

Note

This list of attributes is subject to change based on updates to the Semantic Scholar API. Please open an issue if you notice this.