S2Paper

class s2.models.S2Paper(**data)

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

obtained_utc (datetime, optional):

UTC datetime when obtained from API (converted to and from ISO 8601 by pydantic in JSON (de)serialization)

class s2.models.S2Reference(**data)

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(**data)

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(**data)

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.