Skip to main content

sprynger: API wrapper for Springer Nature

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 free APIs:

  • Springer Metadata API: Metadata of articles, journal articles and book chapters. (Note: Being discontinued by Springer Nature)

  • 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
>>> # Initialize with a single API key (for backward compatibility)
>>> init(api_key='your free api key from https://dev.springernature.com')
>>>
>>> # Or initialize with separate keys for Meta and OpenAccess APIs
>>> init(api_key_meta='your_meta_key', api_key_oa='your_openaccess_key')
>>>
>>> # Get metadata of all chapters in the book with ISBN '978-3-031-63497-0'
>>> book_metadata = Meta(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.

Metadata

Release files for sprynger 0.4.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sprynger 0.4.3
File Size Uploaded
sprynger-0.4.3.tar.gz 36.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sprynger 0.4.3
File Interpreter ABI Platform
sprynger-0.4.3-py3-none-any.whl Python 3 none any Details

Total release size: 79.1 kB

Release files / sprynger-0.4.3.tar.gz

Download URL sprynger-0.4.3.tar.gz
Size 36.2 kB
Tags Source
SHA-256 checksum
How to use checksums
df308f4859e0952aab6c5d7d46827a939ba1c8050bead7190836b8378c672d2e
BLAKE2b-256 checksum
How to use checksums
805a684e256c1457abd8eba998774e1bc15e2704289913bec9770c8495f46ebe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 22, 2026.

Transparency log

Release files / sprynger-0.4.3-py3-none-any.whl

Download URL sprynger-0.4.3-py3-none-any.whl
Size 42.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9342a9f7b5112b69314db7c8e138de2bfb64e5377a677183ae9a1b850d98f670
BLAKE2b-256 checksum
How to use checksums
9fe99f35d8d9f06e33e76643808d69d95af7b684aa0af864a211a391497077e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 22, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page