Python-based API-Wrapper to access Scopus

Installation

Install stable version from PyPI:

pip install scopus

or directly from the GitHub repository:

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

Documentation: https://scopus.readthedocs.io.

Get a Scopus API key

Using Scopus is not free. You need to have a license or institutional access to use it. Got to http://dev.elsevier.com/myapikey.html to register and get a key. scopus expects this key to be in a variable called MY_API_KEY defined in ~/.scopus/my_scopus.py:

MY_API_KEY = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

Examples of usage

scopus_api

from scopus.scopus_api import ScopusAbstract

ab = ScopusAbstract("2-s2.0-84930616647", refresh=True)
print(ab)

2-s2.0-84930616647 John R. Kitchin, Examples of effective data sharing in scientific publishing, ACS Catalysis, 5(6), p. 3894-3899, (2015). http://dx.doi.org/10.1021/acscatal.5b00538, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=84930616647&origin=inward, cited 3 times (Scopus). Affiliations: id:60027950 Carnegie Mellon University

You can print the abstract in a variety of formats, including LaTeX, bibtex, HTML, and RIS. Here is an example. For bibtex entries, you get a uuid for the key.

from scopus.scopus_api import ScopusAbstract

ab = ScopusAbstract("2-s2.0-84930616647")
print(ab.bibtex)
print(ab.ris)

@article{9b0ff2dc-1550-11e7-b54a-48d705e201bd,
  author = {John R. Kitchin},
  title = {Examples of effective data sharing in scientific publishing},
  journal = {ACS Catalysis},
  year = {2015},
  volume = {5},
  number = {6},
  pages = {3894-3899},
  doi = {10.1021/acscatal.5b00538}
}


TY  - JOUR
AU  - Kitchin J.R.
TI  - Examples of effective data sharing in scientific publishing
JO  - ACS Catalysis
VL  - 5
IS  - 6
DA  - 2015-06-05
SP  - 3894-3899
PY  - 2015
DO  - 10.1021/acscatal.5b00538
UR  - http://dx.doi.org/10.1021/acscatal.5b00538
ER  -

Interacting with the abstract

from scopus.scopus_api import ScopusAbstract

ab = ScopusAbstract("2-s2.0-84930662492")
for au in ab.authors:
    print(au)

1. John D. Michael scopusid:56673592900 affiliation_id:60027950
2. Ethan L. Demeter scopusid:55328415000 affiliation_id:60027950
3. Steven M. Illes scopusid:56674328100 affiliation_id:60027950
4. Qingqi Fan scopusid:56673468200 affiliation_id:60027950
5. Jacob R. Boes scopusid:56522803500 affiliation_id:60027950
6. John R. Kitchin scopusid:7004212771 affiliation_id:60027950

from scopus.scopus_api import ScopusAbstract, ScopusJournal

ab = ScopusAbstract("2-s2.0-84930616647")

print(ScopusJournal(ab.issn))

ACS Catalysis http://www.scopus.com/source/sourceInfo.url?sourceId=19700188320
    Homepage:
    SJR:  3.277 (2014)
    SNIP: 1.997 (2014)
    IPP:  8.458 (2014)

:

scopus_search

from scopus.scopus_search import ScopusSearch

s = ScopusSearch('FIRSTAUTH ( kitchin  j.r. )', refresh=True)
print(s.org_summary)

2-s2.0-84971324241 J.R. Kitchin and A.J. Gellman, High-throughput methods using composition and structure spread libraries, AIChE Journal, 62(11), p. 3826-3835, (2016). http://dx.doi.org/10.1002/aic.15294, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=84971324241&origin=inward, cited 0 times (Scopus). Affiliations: id:60027950 Carnegie Mellon University
2-s2.0-84930349644 John R. Kitchin, Data sharing in Surface Science, Surface Science, 647, p. 103-107, (2016). http://dx.doi.org/10.1016/j.susc.2015.05.007, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=84930349644&origin=inward, cited 0 times (Scopus). Affiliations: id:60027950 Carnegie Mellon University
2-s2.0-84930616647 John R. Kitchin, Examples of effective data sharing in scientific publishing, ACS Catalysis, 5(6), p. 3894-3899, (2015). http://dx.doi.org/10.1021/acscatal.5b00538, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=84930616647&origin=inward, cited 3 times (Scopus). Affiliations: id:60027950 Carnegie Mellon University
2-s2.0-67449106405 John R. Kitchin, Correlations in coverage-dependent atomic adsorption energies on Pd(111), Physical Review B - Condensed Matter and Materials Physics, 79(20), Art. No. 205412 (2009). http://dx.doi.org/10.1103/PhysRevB.79.205412, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=67449106405&origin=inward, cited 39 times (Scopus). Affiliations: id:60027950 Carnegie Mellon University
2-s2.0-40949100780 J.R. Kitchin, K. Reuter and M. Scheffler, Alloy surface segregation in reactive environments: First-principles atomistic thermodynamics study of Ag3 Pd(111) in oxygen atmospheres, Physical Review B - Condensed Matter and Materials Physics, 77(7), Art. No. 075437 (2008). http://dx.doi.org/10.1103/PhysRevB.77.075437, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=40949100780&origin=inward, cited 68 times (Scopus). Affiliations: id:60027950 Carnegie Mellon University id:60008644 Fritz Haber Institute of the Max Planck Society
2-s2.0-20544467859 J.R. Kitchin, J.K. Nørskov, M.A. Barteau and J.G. Chen, Trends in the chemical properties of early transition metal carbide surfaces: A density functional study, Catalysis Today, 105(1 SPEC. ISS.), p. 66-73, (2005). http://dx.doi.org/10.1016/j.cattod.2005.04.008, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=20544467859&origin=inward, cited 91 times (Scopus). Affiliations: id:60011373 Danmarks Tekniske Universitet id:60023004 University of Delaware
2-s2.0-13444307808 J.R. Kitchin, J.K. Nørskov, M.A. Barteau and J.G. Chen, Role of strain and ligand effects in the modification of the electronic and chemical Properties of bimetallic surfaces, Physical Review Letters, 93(15), (no pages found) (2004). http://dx.doi.org/10.1103/PhysRevLett.93.156801, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=13444307808&origin=inward, cited 495 times (Scopus). Affiliations: id:60011373 Danmarks Tekniske Universitet id:60023004 University of Delaware
2-s2.0-2942640180 J.R. Kitchin, J.K. Nørskov, M.A. Barteau and J.G. Chen, Modification of the surface electronic and chemical properties of Pt(111) by subsurface 3d transition metals, Journal of Chemical Physics, 120(21), p. 10240-10246, (2004). http://dx.doi.org/10.1063/1.1737365, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=2942640180&origin=inward, cited 582 times (Scopus). Affiliations: id:60011373 Danmarks Tekniske Universitet id:60023004 University of Delaware
2-s2.0-0141924604 J.R. Kitchin, N.A. Khan, M.A. Barteau, J.G. Chen, B. Yakshinskiy and T.E. Madey, Elucidation of the active surface and origin of the weak metal-hydrogen bond on Ni/Pt(1 1 1) bimetallic surfaces: A surface science and density functional theory study, Surface Science, 544(2-3), p. 295-308, (2003). http://dx.doi.org/10.1016/j.susc.2003.09.007, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=0141924604&origin=inward, cited 117 times (Scopus). Affiliations: id:60023004 University of Delaware id:60030623 Rutgers, The State University of New Jersey
2-s2.0-0037368024 J.R. Kitchin, M.A. Barteau and J.G. Chen, A comparison of gold and molybdenum nanoparticles on TiO2(1 1 0) 1 × 2 reconstructed single crystal surfaces, Surface Science, 526(3), p. 323-331, (2003). http://dx.doi.org/10.1016/S0039-6028(02)02679-1, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=0037368024&origin=inward, cited 30 times (Scopus). Affiliations: id:60023004 University of Delaware

scopus_report

from scopus.scopus_search import ScopusSearch
from scopus.scopus_reports import report

s = ScopusSearch('FIRSTAUTH ( kitchin  j.r. )')
report(s, 'Kitchin - first author')

Document type	count
Conference Proceeding	1
Journal	10

10 articles (1425 citations) found by 10 authors

name	count	categories
Kitchin J.R.	10	Chemical Engineering (all) (24), Physical and Theoretical Chemistry (21), Chemistry (all) (20)
Barteau M.A.	5	Physical and Theoretical Chemistry (166), Catalysis (109), Condensed Matter Physics (79)
Chen J.G.	5	Physical and Theoretical Chemistry (164), Catalysis (139), Condensed Matter Physics (78)
Norskov J.K.	3	Physical and Theoretical Chemistry (213), Catalysis (173), Condensed Matter Physics (154)
Madey T.E.	1	Condensed Matter Physics (248), Surfaces and Interfaces (214), Physical and Theoretical Chemistry (186)
Khan N.A.	1	Physical and Theoretical Chemistry (14), Catalysis (9), Surfaces and Interfaces (6)
Reuter K.	1	Condensed Matter Physics (58), Physics and Astronomy (all) (55), Physical and Theoretical Chemistry (41)
Yakshinskiy B.	1	Condensed Matter Physics (26), Electrical and Electronic Engineering (15), Physical and Theoretical Chemistry (14)
Gellman A.J.	1	Physical and Theoretical Chemistry (92), Surfaces and Interfaces (65), Condensed Matter Physics (61)
Scheffler M.	1	Condensed Matter Physics (256), Physics and Astronomy (all) (202), Physical and Theoretical Chemistry (94)

Journal	count	IPP
Surface Science	3	1.773
Physical Review B - Condensed Matter and Materials	2	3.153
Physical Review Letters	1	6.471
Catalysis Today	1	3.764
ACS Catalysis	1	8.458
Journal of Chemical Physics	1	2.536
AIChE Journal	1	2.6

Journal	count	IPP
ACS Catalysis	1	8.458
Physical Review Letters	1	6.471
Catalysis Today	1	3.764
Physical Review B - Condensed Matter and Materials	2	3.153
AIChE Journal	1	2.6
Journal of Chemical Physics	1	2.536
Surface Science	3	1.773

title	cite count
Modification of the surface electronic and chemical properti	582
Role of strain and ligand effects in the modification of the	495
Elucidation of the active surface and origin of the weak met	117
Trends in the chemical properties of early transition metal	91
Alloy surface segregation in reactive environments: First-pr	68
Correlations in coverage-dependent atomic adsorption energie	39
A comparison of gold and molybdenum nanoparticles on TiO2(1	30
Examples of effective data sharing in scientific publishing	3
Data sharing in Surface Science	0
High-throughput methods using composition and structure spre	0

Bibliography

2-s2.0-84971324241 J.R. Kitchin and A.J. Gellman, High-throughput methods using composition and structure spread libraries, AIChE Journal, 62(11), p. 3826-3835, (2016). http://dx.doi.org/10.1002/aic.15294, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=84971324241&origin=inward, cited 0 times (Scopus). Affiliations: id:60027950 Carnegie Mellon University
2-s2.0-84930349644 John R. Kitchin, Data sharing in Surface Science, Surface Science, 647, p. 103-107, (2016). http://dx.doi.org/10.1016/j.susc.2015.05.007, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=84930349644&origin=inward, cited 0 times (Scopus). Affiliations: id:60027950 Carnegie Mellon University
2-s2.0-84930616647 John R. Kitchin, Examples of effective data sharing in scientific publishing, ACS Catalysis, 5(6), p. 3894-3899, (2015). http://dx.doi.org/10.1021/acscatal.5b00538, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=84930616647&origin=inward, cited 3 times (Scopus). Affiliations: id:60027950 Carnegie Mellon University
2-s2.0-67449106405 John R. Kitchin, Correlations in coverage-dependent atomic adsorption energies on Pd(111), Physical Review B - Condensed Matter and Materials Physics, 79(20), Art. No. 205412 (2009). http://dx.doi.org/10.1103/PhysRevB.79.205412, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=67449106405&origin=inward, cited 39 times (Scopus). Affiliations: id:60027950 Carnegie Mellon University
2-s2.0-40949100780 J.R. Kitchin, K. Reuter and M. Scheffler, Alloy surface segregation in reactive environments: First-principles atomistic thermodynamics study of Ag3 Pd(111) in oxygen atmospheres, Physical Review B - Condensed Matter and Materials Physics, 77(7), Art. No. 075437 (2008). http://dx.doi.org/10.1103/PhysRevB.77.075437, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=40949100780&origin=inward, cited 68 times (Scopus). Affiliations: id:60027950 Carnegie Mellon University id:60008644 Fritz Haber Institute of the Max Planck Society
2-s2.0-20544467859 J.R. Kitchin, J.K. Nørskov, M.A. Barteau and J.G. Chen, Trends in the chemical properties of early transition metal carbide surfaces: A density functional study, Catalysis Today, 105(1 SPEC. ISS.), p. 66-73, (2005). http://dx.doi.org/10.1016/j.cattod.2005.04.008, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=20544467859&origin=inward, cited 91 times (Scopus). Affiliations: id:60011373 Danmarks Tekniske Universitet id:60023004 University of Delaware
2-s2.0-13444307808 J.R. Kitchin, J.K. Nørskov, M.A. Barteau and J.G. Chen, Role of strain and ligand effects in the modification of the electronic and chemical Properties of bimetallic surfaces, Physical Review Letters, 93(15), (no pages found) (2004). http://dx.doi.org/10.1103/PhysRevLett.93.156801, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=13444307808&origin=inward, cited 495 times (Scopus). Affiliations: id:60011373 Danmarks Tekniske Universitet id:60023004 University of Delaware
2-s2.0-2942640180 J.R. Kitchin, J.K. Nørskov, M.A. Barteau and J.G. Chen, Modification of the surface electronic and chemical properties of Pt(111) by subsurface 3d transition metals, Journal of Chemical Physics, 120(21), p. 10240-10246, (2004). http://dx.doi.org/10.1063/1.1737365, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=2942640180&origin=inward, cited 582 times (Scopus). Affiliations: id:60011373 Danmarks Tekniske Universitet id:60023004 University of Delaware
2-s2.0-0141924604 J.R. Kitchin, N.A. Khan, M.A. Barteau, J.G. Chen, B. Yakshinskiy and T.E. Madey, Elucidation of the active surface and origin of the weak metal-hydrogen bond on Ni/Pt(1 1 1) bimetallic surfaces: A surface science and density functional theory study, Surface Science, 544(2-3), p. 295-308, (2003). http://dx.doi.org/10.1016/j.susc.2003.09.007, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=0141924604&origin=inward, cited 117 times (Scopus). Affiliations: id:60023004 University of Delaware id:60030623 Rutgers, The State University of New Jersey
2-s2.0-0037368024 J.R. Kitchin, M.A. Barteau and J.G. Chen, A comparison of gold and molybdenum nanoparticles on TiO2(1 1 0) 1 × 2 reconstructed single crystal surfaces, Surface Science, 526(3), p. 323-331, (2003). http://dx.doi.org/10.1016/S0039-6028(02)02679-1, https://www.scopus.com/inward/record.uri?partnerID=HzOxMe3b&scp=0037368024&origin=inward, cited 30 times (Scopus). Affiliations: id:60023004 University of Delaware

scopus_author

from scopus.scopus_author import ScopusAuthor

au = ScopusAuthor(7004212771)
print([a.name for a in au.get_coauthors()])

['Jens Kehlet Nørskov', 'Bruce C. Gates', 'Matthias Scheffler', 'Dionisios G. Vlachos', 'R. J. Gorte', 'Theodore E. Madey', 'Inkyu Song', 'Israel E. Wachs', 'David S. Sholl', 'Marc T M Koper', 'Christopher W. Jones', 'Jingguang Chen', 'Ulrich Stimming', 'Anatoly I. Frenkel', 'Mark A. Barteau', 'Andrew J. Gellman', 'William D. Jones', 'Karsten Reuter', 'Morris Morris Bullock', 'Hannes Jónsson', 'Terrence J. Collins', 'Henry W. Pennline', 'Jan Rossmeisl', 'Edward S. Rubin', 'Thomas Francisco Jaramillo', 'Susannah Scott', 'Paul A. Salvador', 'E. Charles H Sykes', 'David R. Luebke', 'David C M Miller', 'Thomas Bligaard', 'Evan Jacob Granite', 'John R. Kitchin', 'Newell R. Washburn', 'Bryan D. Morreale', 'Krishnan V. Damodaran', 'Venkatasubramanian K. Viswanathan', 'Lars Lindqvist', 'José Ignacio Martínez', 'Lisa Mauck Weiland', 'Kirk R. Gerdes', 'James B. Miller', 'Federico Calle-Vallejo', 'Mc Mahan L Gray', 'Edward M. Sabolsky', 'Heine Anton Hansen', 'Ashish B. Mhadeshwar', 'Jeongwoo Han', 'John A. Keith', 'Shelley Lynn Anna', 'Ashleigh E. Baber', 'Boris V. Yakshinskiy', 'Hunaid B. Nulwala', 'Nicholas S. Siefert', 'Wei Shi', 'James Landon', 'Victor A. Kusuma', 'Jingguang G. Chen', 'Vladimir V. Pushkarev', 'Heather L. Tierney', 'Christina R. Myers', 'Relja Vasić', 'Haiyan Su', 'Áshildur Logadóttir', 'David P. Hopkinson', 'Robert L. Thompson', 'Kevin P. Resnik', 'Adefemi A. Egbebi', 'Erik J. Albenze', 'John C. Eslick', 'Isabelacostinela Man', 'Yogesh V. Joshi', 'Neetha A. Khan', 'Hari Chandan Mantripragada', 'B. A. Calfa', 'Sneha A. Akhade', 'Nilay G. Inoǧlu', 'Stanislav V. Pandelov', 'Christopher J. Keturakis', 'Carmeline J. Dsilva', 'Jacob R. Boes', 'John R. McCormick', 'Peter L. Versteeg', 'Spencer D. Miller', 'Fei Gao', 'Petro Kondratyuk', 'Zhongnan Xu', 'Gamze Gumuslu', 'W. Richard Alesi', 'James X. Mao', 'Anita S. Lee', 'Matthew T. Curnan', 'Peter Kondratyuk', 'John D. Watkins', 'Ratiporn Munprom', 'Mitchell C. Groenenboom', 'Paul A. Salvador', 'Rumyana V. Petrova', 'Ethan L. Demeter', 'Bruno A. Calfa', 'Charles T. Campbell', 'Chunrong Yin', 'Alexander P. Hallenbeck', 'Robin Chao', 'Charles H. Sykes', 'Shayna L. Hilburg', 'Sumathy Raman', 'Prateek Mehta', 'Xu Zhou', 'Nilay Inolu', 'Walter Richard Alesi', 'Qingqi Fan', 'Hari Thirumalai', 'Steven M. Illes', 'Aaron Marks', 'John D. Michael', 'Siddharth Deshpande', 'Feiyang Geng']

You can generate a report about an author just by printing it.

from scopus.scopus_author import ScopusAuthor

au = ScopusAuthor(7004212771)
print(au)

(output omitted)

Contributing

Please see CONTRIBUTING.rst. For a list of contributors see AUTHORS.rst.

License

MIT License, see LICENSE.

Name		Name	Last commit message	Last commit date
Latest commit History 166 Commits
docs		docs
scopus		scopus
.gitignore		.gitignore
AUTHORS.rst		AUTHORS.rst
CHANGES.rst		CHANGES.rst
CONTRIBUTING.rst		CONTRIBUTING.rst
Kitchin - first author-nauthors-per-publication.png		Kitchin - first author-nauthors-per-publication.png
LICENSE		LICENSE
README.ipynb		README.ipynb
README.org		README.org
requirements.txt		requirements.txt
setup.cfg		setup.cfg
setup.py		setup.py

License

computron/scopus

Folders and files

Latest commit

History

Repository files navigation

Python-based API-Wrapper to access Scopus

Installation

Get a Scopus API key

Examples of usage

scopus_api

Interacting with the abstract

scopus_search

scopus_report

Bibliography

scopus_author

Contributing

License

About

Resources

License

Stars

Watchers

Forks

Languages