scopus.ScopusSearch

class scopus.ScopusSearch(query, refresh=False)[source]

Class to search a query, and retrieve a list of EIDs as results.

Parameters:
  • query (str) – A string of the query.
  • refresh (bool (optional, default=False)) – Whether to refresh the cached file if it exists or not.
Raises:

Exception – If the number of search results exceeds 5000.

Notes

Json results are cached in ~/.scopus/search_scoups/{fname} where fname is the md5-hashed version of query.

The COMPLETE view is used to access more fields, see https://dev.elsevier.com/guides/ScopusSearchViews.htm.

get_eids()[source]

EIDs of retrieved documents.

EIDS

Outdated property, will be removed in a future release. Please use get_eids() instead. For details see https://scopus.readthedocs.io/en/latest/tips.html#migration-guide-to-0-x-to-1-x.

results

A list of namedtuples in the form (eid doi pii title subtype creator authname authid afid coverDate coverDisplayDate publicationName issn source_id aggregationType volume issueIdentifier pageRange citedby_count openaccess). Field definitions correspond to https://dev.elsevier.com/guides/ScopusSearchViews.htm, except for authname, authid and afid: These are the ;-joined names resp. Scopus IDs resp. Affiliation IDs of the authors of the document. In case the author has multiple affiliations, they are joined on “-“.