scopus: Python-based API-Wrapper to access Scopus

scopus is an easy to use Python library to pull, cache and extract data from the Scopus database.

Installation

Install scopus from PyPI:

$ pip install scopus

or the development version from the GitHub repository (requires git on your system):

$ pip install git+https://github.com/scopus-api/scopus

To access the Scopus database using scopus, get an API key from http://dev.elsevier.com/myapikey.html. On first usage, scopus prompts you for authentication details and stores them in ~/.scopus/config.ini, where you can change it manually (see Configuration). Additionally, you may need to be in your institution’s network or you need to have an InstToken, which can also be saved in the configuration.

See extended description and examples in the Examples section.

Classes

scopus provides classes to interact with the various Scopus APIs (see https://dev.elsevier.com/api_docs.html):

ScopusAbstract(EID[, view, refresh]) Class to represent the results from a Scopus abstract.
ScopusAffiliation(aff_id[, refresh]) Class to represent an Affiliation in Scopus.
ScopusAuthor(author_id[, refresh, …]) Class to represent a Scopus Author query by the scopus-id.
AffiliationSearch(query[, count, start, …]) Class to perform a search for an affiliation.
AuthorSearch(query[, count, start, …]) Class to search a query, and retrieve a list of author IDs as results.
ScopusSearch(query[, refresh, view]) Class to search a query, and retrieve a list of EIDs as results.
CitationOverview(eid, start[, end, refresh]) Class to represent the results from a Scopus Citation Overview.

Citation

If scopus helped you getting data for research, please cite our corresponding paper:

Indices and tables