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+

To access the Scopus database using scopus, you need an API key which you can get from after registration. Additionally, you need to be in your institution’s network or you need to have an InstToken. On first use, scopus will prompt you for authentication details and save them in your config.ini.

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.
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.

There is one class to provide reports:

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

Indices and tables