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.


Install scopus from PyPI:

$ pip install scopus

or directly from the GitHub repository (may be unstable):

$ pip install git+git://

You need to have a license or institutional access to access Scopus. Additionally, you need an API which you can obtain from after registration. On first usage, scopus asks you to enter your key which will be stored in ~/.scopus/

See extended description and examples in the Examples section.


scopus provides classes to interact with the various Scopus APIs (see

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

There is one class to provide reports:

report(scopus_search, label) Print out an org-mode report for search results.

Indices and tables