/scopus

Python API for Accessing Scopus databases with their REST API

Primary LanguagePythonMIT LicenseMIT

A Python API for accessing Scopus data

Installation

Feeling brave? Try:

pip install git+git://github.com/jkitchin/scopus

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

Documentation Status

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)
  1. 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. 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
  3. 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
  4. 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
  5. 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
  6. 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
  7. 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
  8. 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
  9. 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
  10. 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 typecount
Conference Proceeding1
Journal10

10 articles (1425 citations) found by 10 authors

namecountcategories
Kitchin J.R.10Chemical Engineering (all) (24), Physical and Theoretical Chemistry (21), Chemistry (all) (20)
Barteau M.A.5Physical and Theoretical Chemistry (166), Catalysis (109), Condensed Matter Physics (79)
Chen J.G.5Physical and Theoretical Chemistry (164), Catalysis (139), Condensed Matter Physics (78)
Norskov J.K.3Physical and Theoretical Chemistry (213), Catalysis (173), Condensed Matter Physics (154)
Madey T.E.1Condensed Matter Physics (248), Surfaces and Interfaces (214), Physical and Theoretical Chemistry (186)
Khan N.A.1Physical and Theoretical Chemistry (14), Catalysis (9), Surfaces and Interfaces (6)
Reuter K.1Condensed Matter Physics (58), Physics and Astronomy (all) (55), Physical and Theoretical Chemistry (41)
Yakshinskiy B.1Condensed Matter Physics (26), Electrical and Electronic Engineering (15), Physical and Theoretical Chemistry (14)
Gellman A.J.1Physical and Theoretical Chemistry (92), Surfaces and Interfaces (65), Condensed Matter Physics (61)
Scheffler M.1Condensed Matter Physics (256), Physics and Astronomy (all) (202), Physical and Theoretical Chemistry (94)
JournalcountIPP
Surface Science31.773
Physical Review B - Condensed Matter and Materials23.153
Physical Review Letters16.471
Catalysis Today13.764
ACS Catalysis18.458
Journal of Chemical Physics12.536
AIChE Journal12.6
JournalcountIPP
ACS Catalysis18.458
Physical Review Letters16.471
Catalysis Today13.764
Physical Review B - Condensed Matter and Materials23.153
AIChE Journal12.6
Journal of Chemical Physics12.536
Surface Science31.773
titlecite count
Modification of the surface electronic and chemical properti582
Role of strain and ligand effects in the modification of the495
Elucidation of the active surface and origin of the weak met117
Trends in the chemical properties of early transition metal 91
Alloy surface segregation in reactive environments: First-pr68
Correlations in coverage-dependent atomic adsorption energie39
A comparison of gold and molybdenum nanoparticles on TiO2(1 30
Examples of effective data sharing in scientific publishing3
Data sharing in Surface Science0
High-throughput methods using composition and structure spre0

./Kitchin - first author-nauthors-per-publication.png

Bibliography

  1. 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. 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
  3. 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
  4. 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
  5. 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
  6. 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
  7. 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
  8. 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
  9. 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
  10. 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.