pybliometrics.scopus.SerialTitle

class pybliometrics.scopus.SerialTitle(issn, refresh=False, view='ENHANCED', years=None)[source]

Interaction with the Serial Title API.

Parameters:
  • issn (str or int) – The ISSN or the E-ISSN of the source.
  • refresh (bool or int (optional, default=False)) – Whether to refresh the cached file if it exists or not. If int is passed, cached file will be refreshed if the number of days since last modification exceeds that value.
  • view (str (optional, default="ENHANCED")) – The view of the file that should be downloaded. Allowed values: BASIC, STANDARD, ENHANCED. For details see https://dev.elsevier.com/sc_serial_title_views.html.
  • years (str (optional, default=None)) – A string specifying a year or range of years (combining two years with a hyphen) for which yearly metric data (SJR, SNIP, yearly-data) should be looked up for. If None, only the most recent metric data values are provided. Note: If not None, refresh will always be True.

Examples

See https://pybliometrics.readthedocs.io/en/stable/examples/SerialTitle.html.

Notes

The directory for cached results is {path}/{view}/{source_id}, where path is specified in ~/.scopus/config.ini.

aggregation_type

The type of the source.

citescoreyearinfolist

A list of two tuples of the form (year, cite-score). The first tuple represents the current cite-score, the second tuple represents the tracker cite-score.

eissn

The electronic ISSN of the source.

issn

The ISSN of the source.

oaallowsauthorpaid

Whether under the Open-Access policy authors are allowed to pay.

openaccess

Open Access status (0 or 1).

openaccessstartdate

Starting availability date.

openaccesstype

Open Archive status (full or partial).

openaccessarticle

Open Access status (boolean).

openarchivearticle

Open Archive status (boolean).

openaccesssponsorname

The name of the Open Access sponsor.

openaccesssponsortype

The type of the Open Access sponsor.

openaccessuserlicense

The User license.

publisher

The publisher of the source.

URL to info site on scopus.com.

URL to the source’s API page.

sjrlist

The SCImago Journal Rank (SJR) indicator as list of (year, indicator)-tuples. See https://www.scimagojr.com/journalrank.php.

sniplist

The Source-Normalized Impact per Paper (SNIP) as list of (year, indicator)-tuples. See https://blog.scopus.com/posts/journal-metrics-in-scopus-source-normalized-impact-per-paper-snip.

source_id

The Scopus ID of the source.

subject_area

List of named tuples of subject areas in the form (area, abbreviation, code) of the source.

title

The title of the source.

get_cache_file_age()

Return the age of the cached file in days.

get_cache_file_mdate()

Return the modification date of the cached file.

get_key_remaining_quota()

Return number of remaining requests for the current key and the current API (relative on last actual request).

get_key_reset_time()

Return time when current key is reset (relative on last actual request).