Skip to main content

An API wrapper for Springer Nature

Project description

Simple API wrapper for the Springer Nature APIs

https://badge.fury.io/py/sprynger.svg https://img.shields.io/pypi/pyversions/sprynger.svg https://readthedocs.org/projects/sprynger/badge/?version=latest https://img.shields.io/pypi/dm/sprynger.svg https://img.shields.io/pypi/l/sprynger.svg https://github.com/nils-herrmann/sprynger/actions/workflows/test.yml/badge.svg https://codecov.io/gh/nils-herrmann/sprynger/graph/badge.svg?token=GF3FMVUWV3 https://api.codeclimate.com/v1/badges/1d053321a70d800bfc59/maintainability

🏔️ Overview Springer Nature

Springer Nature currently offers three APIs:

  • Springer Metadata API: Metadata of articles, journal articles and book chapters.

  • Springer Meta API: Advanced version offering versioned metadata.

  • Springer OpenAccess API: Metadata and, where available, full-text.

⬇️ Install

Download and install the package from PyPI:

pip install sprynger

🪧 Example Use

>>> from sprynger import Meta, OpenAccess, init
>>> init(api_key='your free api key from https://dev.springernature.com')
>>>
>>> # Get metadata of all chapters in the book with ISBN '978-3-031-63497-0'
>>> book_metadata = Metadata(isbn='978-3-031-63497-0', nr_results=3)
>>> for chapter in book_metadata:
>>>     print(chapter.identifier)
>>>     print(chapter.abstract)
'doi:10.1007/978-3-031-63498-7_20'
    'Modern solvers for quantified Boolean formulas (QBFs) process formulas in prenex form, ...'
'doi:10.1007/978-3-031-63498-7_9'
    'Given a finite consistent set of ground literals, we present an algorithm that generates ...'
'doi:10.1007/978-3-031-63498-7_3'
    'The TPTP World is a well established infrastructure that supports research, development, ...'
>>> # Print the facets of the retrieved chapter's metadata
>>> book_metadata.facets
[MetadataFacets(facet='subject', value='Artificial Intelligence', count='27'),...]
>>>
>>> # Retrieve full-text of three 'journal articles' with the keyword 'quantum computing' published before 2023
>>> results = OpenAccess('"quantum computing"', dateto='2022-12-30', type='Journal Article', nr_results=3)
>>> results.documents_found
3515
>>> for document in results:
>>>    print(document.title)
>>>    for section in document.parsed_text:
>>>        print(section.text)
'A neural network assisted'
    'Introduction Quantum sensing 1  and metrology 2  are important branches of modern quantum technologi...'
    ...
'Experimental demonstration of classical analogous time-dependent superposition of states'
    'Introduction The increased demand for quantum information science (QIS) and quantum computing 1 ,  2...'
    ...
'A quantum-like cognitive approach to modeling human biased selection behavior'
    'Introduction With the advent of the Internet of Things and social networks, the reformation of the d...'
    ...

📝 Citation

If sprynger helped you retrieve your data, please cite the corresponding paper.

@article{HERRMANN2025102186,
  title = {sprynger: Scriptable bibliometrics using a Python interface to Springer Nature},
  journal = {SoftwareX},
  volume = {31},
  pages = {102186},
  year = {2025},
  issn = {2352-7110},
  doi = {https://doi.org/10.1016/j.softx.2025.102186},
  url = {https://www.sciencedirect.com/science/article/pii/S2352711025001530},
  author = {Nils A. Herrmann and Michael E. Rose}
}

📖 Documentation

For a comprehensive guide, see the documentation in read the docs.

⚠️ Disclaimer

This project is an independent API wrapper for the Springer Nature API. It is not affiliated with, endorsed, or maintained by Springer Nature. For official support, please refer to the Springers’s documentation and support channels.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sprynger-0.4.1.tar.gz (33.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sprynger-0.4.1-py3-none-any.whl (40.2 kB view details)

Uploaded Python 3

File details

Details for the file sprynger-0.4.1.tar.gz.

File metadata

  • Download URL: sprynger-0.4.1.tar.gz
  • Upload date:
  • Size: 33.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for sprynger-0.4.1.tar.gz
Algorithm Hash digest
SHA256 2cd891b0d92461ec7be13a5d8bcbae8d52e4dc30c16b6edb1ffe4fdea32beaa3
MD5 755a70f1fc14a21aea581881ba9e1224
BLAKE2b-256 9518723e71748b610a75988e88a9a4e4c92e3e2e7ef0e990162a430a3ce735c2

See more details on using hashes here.

Provenance

The following attestation bundles were made for sprynger-0.4.1.tar.gz:

Publisher: python-publish.yml on nils-herrmann/sprynger

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file sprynger-0.4.1-py3-none-any.whl.

File metadata

  • Download URL: sprynger-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 40.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for sprynger-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f17f895c999e1ddfcb883a67f179c4579935cc0c548113006a67eabcf84ad6f5
MD5 72df8b50d39f333d0d15356098114ea4
BLAKE2b-256 8bab53cef452d72b9232a5ea6b9de139b7ef65a12be029eea7dc0d85122a91b2

See more details on using hashes here.

Provenance

The following attestation bundles were made for sprynger-0.4.1-py3-none-any.whl:

Publisher: python-publish.yml on nils-herrmann/sprynger

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page